Initial commit: add project structure and .gitignore

2026-07-23 08:35:28 +04:00
commit b0ebd16893
78 changed files with 17820 additions and 0 deletions
@@ -0,0 +1,485 @@
+name: nextcloud
+service_id: 50
+service_display_name: Nextcloud
+service_short_name: nextcloud
+service_man: 'Ресурсная платформа: k8s. Автоматизация: helm chart'
+lifecycle:
+    suspend_on_destroy_default: true
+    adopt_existing_on_create_default: false
+outputs:
+    params:
+        - code: state_params
+          type: map
+        - code: state_out
+          type: map
+        - code: state_params_flat
+          type: map
+        - code: state_out_flat
+          type: map
+        - code: vault_secrets
+          type: map
+          sensitive: true
+        - code: vault_url
+          type: string
+        - code: vault_user_path
+          type: string
+        - code: vault_fields
+          type: list
+operations:
+    - name: create
+      id: 16
+      kind: instance
+      action: create
+      man: Для установки необходимо:<br/>- ресурсная платформа, где разворачивается Nextcloud, обязана совпадать с ресурсными платформами, где развёрнут Redis и PostgreSQL
+      params:
+        - id: 1055
+          code: startupConfiguration
+          data_type: map-fixed
+          required: true
+          sort: 10
+          sub_params:
+            - id: 494
+              code: redisEnabled
+              data_type: boolean
+              required: true
+              default: "true"
+              value_list:
+                - "true"
+              man: Инстанс обязан быть развёрнут на той же ресурсной платформе, где и будет располагаться Nextcloud
+              is_modifiable: false
+            - id: 495
+              code: psqlUid
+              data_type: uuid
+              required: true
+              default: ""
+              man: Необходимо выбирать, когда выбран параметр `Подключить PostgreSQL из Личного кабинета`
+              is_modifiable: false
+            - id: 496
+              code: redisUid
+              data_type: uuid
+              required: true
+              default: ""
+              man: Необходимо выбирать, когда выбран параметр `Подключить Redis из Личного кабинета`
+              is_modifiable: false
+            - id: 492
+              code: resourceRealm
+              data_type: string
+              required: true
+              default: ""
+              value_list:
+                - k8s-3-sandbox-nubes-ru
+                - k8s-4-sandbox-nubes-ru
+              man: Кластер Kubernetes, на котором будет развернут экземпляр
+              is_modifiable: false
+            - id: 493
+              code: psqlEnabled
+              data_type: boolean
+              required: true
+              default: "true"
+              value_list:
+                - "true"
+              man: Инстанс обязан быть развёрнут на той же ресурсной платформе, где и будет располагаться Nextcloud
+              is_modifiable: false
+        - id: 1056
+          code: clusterConfiguration
+          data_type: map-fixed
+          required: true
+          sort: 20
+          is_modifiable: true
+          sub_params:
+            - id: 497
+              code: cpu
+              data_type: integer &gt; 0
+              required: true
+              default: "1000"
+              value_list:
+                - "1000"
+                - "2000"
+                - "3000"
+                - "4000"
+              man: Указывается в Milicores<br/>`1000` Mili == `1` Ядро
+              is_modifiable: false
+            - id: 498
+              code: memory
+              data_type: integer &gt; 0
+              required: true
+              default: "1024"
+              value_list:
+                - "1024"
+                - "2048"
+                - "3072"
+                - "4096"
+                - "5120"
+                - "6144"
+                - "7168"
+                - "8192"
+              man: Указывается в Megabytes
+              is_modifiable: false
+            - id: 499
+              code: replicas
+              data_type: integer &gt; 0
+              required: true
+              default: "1"
+              value_list:
+                - "1"
+                - "2"
+              is_modifiable: false
+            - id: 500
+              code: disk
+              data_type: integer &gt; 0
+              required: true
+              default: "10"
+              man: Указывается в GIGAbytes<br/>На данном диске хранятся данные Nextcloud
+              is_modifiable: false
+        - id: 1057
+          code: accessConfiguration
+          data_type: map-fixed
+          required: true
+          sort: 30
+          sub_params:
+            - id: 501
+              code: domain
+              data_type: string
+              required: true
+              default: nextcloud-vbxjicr2
+              man: 'Если указан FQDN в формате: `myapp.example.com`, предварительно будет проверяться DNS-запись (А-запись **должна смотреть на IP Ingress кластера ресурсной платформы**)<br/><br/>Если указан в формате `myapp`, DNS-запись будет автоматически создана в служебной DNS-зоне'
+              is_modifiable: false
+        - id: 1058
+          code: appConfiguration
+          data_type: map-fixed
+          required: true
+          sort: 40
+          is_modifiable: true
+          sub_params:
+            - id: 502
+              code: version
+              data_type: string
+              required: true
+              default: 33.0.4
+              value_list:
+                - 33.0.4
+              is_modifiable: false
+            - id: 503
+              code: documentServer
+              data_type: string
+              required: true
+              default: collabora
+              value_list:
+                - collabora
+              man: Выбор сервера документов (onlyoffice)/(collabora). onlyoffice пока не доступен<br/>Размер пода collabora:<br/>1.8 ядра. 2Gi ОЗУ
+              is_modifiable: false
+            - id: 549
+              code: logLevel
+              data_type: string
+              required: true
+              default: INFO
+              value_list:
+                - DEBUG
+                - INFO
+                - WARN
+                - ERROR
+                - FATAL
+                - NONE
+              man: Включает отображение логов самого nextcloud<br/>Логи уходят в /dev/stdout контейнера<br/>`NONE` отключает логирование
+              is_modifiable: false
+    - name: create_backup
+      id: 404
+      kind: subresource
+      action: create
+      subresource: backup
+      man: Перед запуском обязательно надо перевести экземпляр Nextcloud в статус 'suspended'
+      params:
+        - id: 1077
+          code: startupConfiguration
+          data_type: map-fixed
+          required: true
+          sort: 10
+          sub_params:
+            - id: 578
+              code: veleroUid
+              data_type: string
+              required: true
+              default: ""
+              man: Предварительно необходимо создать инстанс услуги `Velero`<br/>Из этого инстанса будут взяты точки восстановления<br/>Если восстановление производится на другую ресурсную платформу, важно чтобы предварительно все компоненты связующие были либо перенесены, либо были доступны снаружи
+              is_modifiable: false
+    - name: delete
+      id: 17
+      kind: instance
+      action: delete
+      man: DEV-Ветка удаления Nextcloud
+      params: []
+    - name: modify
+      id: 67
+      kind: instance
+      action: modify
+      params:
+        - id: 1059
+          code: clusterConfiguration
+          data_type: map-fixed
+          required: true
+          sort: 10
+          sub_params:
+            - id: 506
+              code: replicas
+              data_type: integer &gt; 0
+              required: true
+              default: ""
+              value_list:
+                - "1"
+                - "2"
+              is_modifiable: false
+            - id: 507
+              code: disk
+              data_type: integer &gt; 0
+              required: true
+              default: ""
+              man: Указывается в GIGAbytes<br/>На данном диске хранятся данные Nextcloud
+              is_modifiable: false
+            - id: 504
+              code: cpu
+              data_type: integer &gt; 0
+              required: true
+              default: ""
+              value_list:
+                - "1000"
+                - "2000"
+                - "3000"
+                - "4000"
+              man: Указывается в Milicores<br/>`1000` Mili == `1` Ядро
+              is_modifiable: false
+            - id: 505
+              code: memory
+              data_type: integer &gt; 0
+              required: true
+              default: ""
+              value_list:
+                - "1024"
+                - "2048"
+                - "3072"
+                - "4096"
+                - "5120"
+                - "6144"
+                - "7168"
+                - "8192"
+              man: Указывается в Megabytes
+              is_modifiable: false
+        - id: 1060
+          code: appConfiguration
+          data_type: map-fixed
+          required: true
+          sort: 20
+          sub_params:
+            - id: 508
+              code: version
+              data_type: string
+              required: true
+              default: ""
+              value_list:
+                - 33.0.4
+              is_modifiable: false
+            - id: 509
+              code: documentServer
+              data_type: string
+              required: true
+              default: ""
+              value_list:
+                - collabora
+              man: Выбор сервера документов (onlyoffice)/(collabora). onlyoffice пока не доступен<br/>Размер пода collabora:<br/>1.8 ядра. 2Gi ОЗУ
+              is_modifiable: false
+            - id: 550
+              code: logLevel
+              data_type: string
+              required: true
+              default: ""
+              value_list:
+                - DEBUG
+                - INFO
+                - WARN
+                - ERROR
+                - FATAL
+                - NONE
+              man: Включает отображение логов самого nextcloud<br/>Логи уходят в /dev/stdout контейнера<br/>`NONE` отключает логирование
+              is_modifiable: false
+    - name: reconcile
+      id: 390
+      kind: action
+      action: reconcile
+      params: []
+    - name: recovery
+      id: 406
+      kind: action
+      action: recovery
+      params:
+        - id: 1078
+          code: startupConfiguration
+          data_type: map-fixed
+          required: true
+          sort: 10
+          sub_params:
+            - id: 556
+              code: resourceRealm
+              data_type: string
+              required: true
+              default: ""
+              value_list:
+                - k8s-3-sandbox-nubes-ru
+                - k8s-4-sandbox-nubes-ru
+              man: Кластер Kubernetes, на котором будет развернут экземпляр
+              is_modifiable: false
+            - id: 570
+              code: veleroUid
+              data_type: string
+              required: true
+              default: ""
+              man: Из этого инстанса будут взяты точки восстановления<br/>Если восстановление производится на другую ресурсную платформу, важно чтобы предварительно все компоненты связующие были либо перенесены, либо были доступны снаружи
+              is_modifiable: false
+            - id: 559
+              code: recoveryPoint
+              data_type: string
+              required: true
+              default: ""
+              is_modifiable: false
+            - id: 557
+              code: psqlEnabled
+              data_type: boolean
+              required: true
+              default: "true"
+              value_list:
+                - "true"
+              man: Инстанс обязан быть развёрнут на той же ресурсной платформе, где и будет располагаться Nextcloud
+              is_modifiable: false
+            - id: 558
+              code: redisEnabled
+              data_type: boolean
+              required: true
+              default: "true"
+              value_list:
+                - "true"
+              man: Инстанс обязан быть развёрнут на той же ресурсной платформе, где и будет располагаться Nextcloud
+              is_modifiable: false
+            - id: 560
+              code: psqlUid
+              data_type: uuid
+              required: true
+              default: ""
+              man: Необходимо выбирать, когда выбран параметр `Подключить PostgreSQL из Личного кабинета`<br/>Если откат производится на ту же версию Nextcloud, в теории возможно развернуться в существующую базу<br/><br/>Предпочтительно создать отдельный инстанс PostgreSQL, который был восстановлен также через Recovery
+              is_modifiable: false
+            - id: 561
+              code: redisUid
+              data_type: uuid
+              required: true
+              default: ""
+              man: Необходимо выбирать, когда выбран параметр `Подключить Redis из Личного кабинета`
+              is_modifiable: false
+        - id: 1079
+          code: clusterConfiguration
+          data_type: map-fixed
+          required: true
+          sort: 20
+          sub_params:
+            - id: 564
+              code: replicas
+              data_type: integer &gt; 0
+              required: true
+              default: 1,2
+              is_modifiable: false
+            - id: 565
+              code: disk
+              data_type: integer &gt; 0
+              required: true
+              default: "10"
+              man: Указывается в GIGAbytes<br/>На данном диске хранятся данные Nextcloud
+              is_modifiable: false
+            - id: 562
+              code: cpu
+              data_type: integer &gt; 0
+              required: true
+              default: ""
+              value_list:
+                - "1000"
+                - "2000"
+                - "3000"
+                - "4000"
+              man: Указывается в Milicores<br/>`1000` Mili == `1` Ядро
+              is_modifiable: false
+            - id: 563
+              code: memory
+              data_type: integer &gt; 0
+              required: true
+              default: ""
+              value_list:
+                - "1024"
+                - "2048"
+                - "3072"
+                - "4096"
+                - "5120"
+                - "6144"
+                - "7168"
+                - "8192"
+              man: Указывается в Megabytes
+              is_modifiable: false
+        - id: 1080
+          code: accessConfiguration
+          data_type: map-fixed
+          required: true
+          sort: 30
+          sub_params:
+            - id: 566
+              code: domain
+              data_type: string
+              required: true
+              default: nextcloud-bcdguda1
+              man: 'Если указан FQDN в формате: `myapp.example.com`, предварительно будет проверяться DNS-запись (А-запись **должна смотреть на IP Ingress кластера ресурсной платформы**)<br/><br/>Если указан в формате `myapp`, DNS-запись будет автоматически создана в служебной DNS-зоне'
+              is_modifiable: false
+        - id: 1081
+          code: appConfiguration
+          data_type: map-fixed
+          required: true
+          man: Версия Nextcloud будет взята из бэкапа
+          sort: 40
+          sub_params:
+            - id: 568
+              code: logLevel
+              data_type: string
+              required: true
+              default: NONE
+              value_list:
+                - DEBUG
+                - INFO
+                - WARN
+                - ERROR
+                - FATAL
+                - NONE
+              man: Включает отображение логов самого nextcloud<br/>Логи уходят в /dev/stdout контейнера<br/>`NONE` отключает логирование
+              is_modifiable: false
+            - id: 569
+              code: version
+              data_type: string
+              required: false
+              default: ""
+              man: Версия Nextcloud будет исправлена на ту версию, которая указана в бэкапе
+              is_modifiable: false
+            - id: 567
+              code: documentServer
+              data_type: string
+              required: true
+              default: collabora
+              value_list:
+                - collabora
+              man: Выбор сервера документов (onlyoffice)/(collabora). onlyoffice пока не доступен<br/>Размер пода collabora:<br/>1.8 ядра. 2Gi ОЗУ
+              is_modifiable: false
+    - name: restart
+      id: 66
+      kind: action
+      action: restart
+      params: []
+    - name: resume
+      id: 129
+      kind: instance
+      action: resume
+      params: []
+    - name: suspend
+      id: 128
+      kind: instance
+      action: suspend
+      params: []