fix: stabilize Polygon config loading and sync

site/services/dev/50_nextcloud.yaml

@@ -2,7 +2,49 @@ name: nextcloud
 service_id: 50
 service_display_name: Nextcloud
 service_short_name: nextcloud
-service_man: 'Ресурсная платформа: k8s. Автоматизация: helm chart'
+service_man: '# Инструкция по развертыванию Nextcloud через платформу<br/><br/>## 1. Общая информация<br/><br/>Nextcloud — платформа для хранения и совместной работы с файлами. Разворачивается в K8s через
+  Helm-чарт `nextcloud/nextcloud`.<br/><br/>Сервис **не самодостаточен** — для создания необходимы заранее развёрнутые в той же ресурсной платформе:<br/><br/>* **PostgreSQL (k8s)** — база данных Nextcloud.
+  У СУБД должен быть выставлен параметр `sslRequired: false`.<br/>* **Redis (k8s)** — используется как memcache/locking backend.<br/><br/>Резервное копирование выполняется через **Velero** (бэкапятся под
+  и PVC с данными), а не штатным S3-бэкапом СУБД.<br/><br/>### Доступные операции с сервисом<br/><br/>* **create**        — создание сервиса<br/>* **delete**         — удаление сервиса<br/>* **suspend**        —
+  остановка сервиса (масштабирование реплик в 0)<br/>* **resume**         — запуск сервиса<br/>* **restart**        — перезапуск (`kubectl rollout restart`)<br/>* **modify**         — изменение настроек
+  сервиса<br/>* **reconcile**      — служебная операция синхронизации версии (запускается платформой автоматически)<br/>* **create_backup**  — создание резервной копии вручную (через Velero)<br/>* **recovery**       —
+  восстановление из резервной копии в **новый** инстанс<br/><br/>> **Примечание:** операций работы с пользователями Nextcloud (`create_user`/`modify_user`/`delete_user`) на уровне платформы нет — пользователи
+  приложения администрируются внутри самого Nextcloud.<br/><br/>---<br/><br/>## 2. Параметры создания сервиса<br/><br/>### Платформа для развертывания<br/><br/>Ресурсная платформа (`resourceRealm`), в которой
+  будет развёрнут сервис. PostgreSQL и Redis, указанные ниже, обязаны находиться в той же ресурсной платформе.<br/><br/>### СУБД PostgreSQL (psqlUid)<br/><br/>UID инстанса PostgreSQL (k8s), в котором будет
+  создана база и пользователь `nextcloud`.<br/><br/>* У выбранной СУБД должна отсутствовать база `nextcloud` и пользователь `nextcloud`.<br/>* У СУБД обязан быть выключен `sslMode` (`false`).<br/><br/>###
+  СУБД Redis (redisUid)<br/><br/>UID инстанса Redis (k8s), который будет использоваться как memcache/locking backend.<br/><br/>### Количество реплик<br/><br/>Количество реплик Nextcloud (`clusterConfiguration.replicas`).<br/><br/>###
+  Квота памяти пода (MB)<br/><br/>Объём памяти для пода Nextcloud в мегабайтах.<br/>Пример: `2048`<br/><br/>### Квота CPU пода (mCPU)<br/><br/>CPU-квота для пода Nextcloud в миликорах (1000 mCPU = 1 vCPU).<br/>Пример:
+  `1000`<br/><br/>### Размер диска для данных (GB)<br/><br/>Объём диска под данные Nextcloud (`/var/www/html/data`) в гигабайтах.<br/>Пример: `20`<br/><br/>### Домен<br/><br/>Домен, на котором будет доступен
+  Nextcloud (`accessConfiguration.domain`).<br/><br/>* Если указано **полное доменное имя** (содержит точку, например `cloud.company.ru`) — домен считается клиентским. Перед созданием клиент обязан сам
+  настроить DNS-запись, указывающую на адрес Ingress платформы, иначе создание завершится ошибкой.<br/>* Если указано **короткое имя** (без точки, например `mycloud`) — платформа сама создаёт DNS-запись
+  вида `<domain>.nextcloudk8s` и настраивает сертификат.<br/><br/>### Версия<br/><br/>Версия приложения Nextcloud (`appConfiguration.version`, поле `appVersion` Helm-чарта). По ней автоматически подбирается
+  последняя подходящая версия Helm-чарта.<br/><br/>### Document Server<br/><br/>Параметр `appConfiguration.documentServer`. Если указать `collabora` — в кластер дополнительно разворачивается Collabora Online
+  (совместное редактирование офисных документов), доступный по пути `/collabora` на том же домене.<br/>Оставьте пустым, если Document Server не нужен.<br/><br/>### Уровень логирования<br/><br/>Параметр
+  `appConfiguration.logLevel`. Одно из значений: `DEBUG`, `INFO`, `WARN`, `ERROR`, `FATAL`, либо `NONE` — чтобы не переопределять логирование Nextcloud.<br/><br/>---<br/><br/>## 3. Параметры модификации
+  сервиса<br/><br/>Изменению подлежат ресурсы, версия и часть `appConfiguration`. Параметры `psqlUid`/`redisUid` менять после создания не рекомендуется.<br/><br/>### Количество реплик<br/><br/>См. раздел
+  2.<br/><br/>### Квота памяти пода (MB) / Квота CPU пода (mCPU) / Размер диска (GB)<br/><br/>См. раздел 2.<br/><br/>> **Примечание:** уменьшить уже выделенный размер диска нельзя.<br/><br/>### Версия<br/><br/>Обновление
+  версии разрешено только **на один патч** либо **на одну минорную версию вперёд** (с `patch=0`). Прыжок сразу через несколько минорных версий или через несколько мажорных версий запрещён — обновляться
+  нужно последовательно.<br/><br/>> **Примечание:** перед обновлением на новую minor/major-версию необходимо сначала выполнить `modify` на текущей версии, обновившись до последнего релиза этой версии (иначе
+  операция завершится ошибкой с описанием, до какой версии нужно обновиться сначала).<br/><br/>### Document Server / Уровень логирования<br/><br/>См. раздел 2.<br/><br/>---<br/><br/>## 4. Параметры удаления
+  сервиса<br/><br/>Специальных параметров нет — удаление сносит namespace целиком.<br/><br/>> **Примечание:** резервные копии, созданные через `create_backup`, хранятся в Velero отдельно от инстанса и **не
+  удаляются** вместе с сервисом — операции `delete_backup` для Nextcloud нет, копии нужно вычищать на стороне Velero отдельно.<br/><br/>---<br/><br/>## 5. Параметры создания бэкапа<br/><br/>Специальных
+  пользовательских параметров нет — имя бэкапа генерируется автоматически в формате `<дата>-<версия>-<namespace>`.<br/><br/>> **Примечание:** создать бэкап можно только если сервис предварительно приостановлен
+  (`suspend`). Velero, в который создаётся бэкап, должен быть развёрнут в той же ресурсной платформе, что и Nextcloud, и не может быть сменён на другой Velero-инстанс в рамках одного сервиса.<br/><br/>Бэкапится
+  под с данными вместе с PVC/PV (файлы), метаданные и БД PostgreSQL бэкапом не затрагиваются — версия схемы БД фиксируется отдельно (см. раздел 6).<br/><br/>---<br/><br/>## 6. Параметры восстановления из
+  бэкапа (recovery)<br/><br/>В отличие от СУБД-сервисов, `recovery` у Nextcloud **не восстанавливает данные в текущий инстанс**, а создаёт **новый** инстанс сервиса (аналог `create`), в который переносятся
+  файлы из указанной резервной копии.<br/><br/>### Точка восстановления (recoveryPoint)<br/><br/>Имя резервной копии Velero, из которой будет выполнено восстановление.<br/><br/>### Домен нового инстанса<br/><br/>Обязан
+  отличаться от домена исходного (текущего) инстанса — восстановление на тот же домен не поддерживается.<br/><br/>### СУБД PostgreSQL нового инстанса<br/><br/>Если версия Nextcloud в бэкапе отличается от
+  текущей версии инстанса, для нового инстанса обязательно нужно указать **другую** СУБД PostgreSQL (нельзя восстанавливать бэкап со старой схемой БД поверх БД с более новой схемой).<br/><br/>---<br/><br/>##
+  7. Выходные параметры<br/><br/>После успешного создания сервиса платформа возвращает:<br/><br/>### connectionUrl<br/><br/>Адрес для входа в Nextcloud: `https://<домен>`.<br/><br/>### namespace<br/><br/>Namespace
+  в K8s-кластере, в котором развёрнут сервис.<br/><br/>### Учётные данные (Vault)<br/><br/>В Vault сохраняется пароль администратора (`adminPass`) под логином `admin`.<br/><br/>---<br/><br/>## 8. Пример
+  подключения<br/><br/>Откройте `connectionUrl` в браузере и авторизуйтесь:<br/><br/>* **Логин:** `admin`<br/>* **Пароль:** значение `adminPass` из блока «Учётные данные» в Vault<br/><br/>---<br/><br/>##
+  9. Дополнительная информация<br/><br/>### Зависимости<br/><br/>Nextcloud нельзя создать без уже существующих в том же `resourceRealm` сервисов PostgreSQL (k8s, `sslRequired: false`) и Redis (k8s). При
+  `delete` зависимые СУБД и Redis не трогаются — удаляется только сам Nextcloud.<br/><br/>### suspend/resume<br/><br/>При `suspend` количество реплик Nextcloud, Collabora и exporter''а метрик принудительно
+  выставляется в `0` через `helm upgrade` (реальное масштабирование, а не просто пауза cron). При `resume` реплики возвращаются к значению из `clusterConfiguration.replicas`.<br/><br/>### Collabora<br/><br/>Собирается
+  из отдельного `image.repository: nexus-sa.tst.nubes.ru/collabora/code` и включается только при `appConfiguration.documentServer == ''collabora''`. Доступен на том же домене и том же TLS-сертификате, что
+  и сам Nextcloud, по пути `/collabora`.<br/><br/>### Бэкап/восстановление через Velero<br/><br/>Бэкап/восстановление файлов идёт через Velero с селектором `backup=<serviceName>-velero-backup` и включает
+  под, PVC и PV — то есть непосредственно файлы `/var/www/html/data`. Восстановление БД в новый инстанс выполняется штатным механизмом `create` с параметром `instanceUidFrom`, который проставляет `recovery`-джоба
+  автоматически.<br/>'
 lifecycle:
   suspendOnDestroyDefault: true
   adoptExistingOnCreateDefault: false
@@ -53,6 +95,22 @@ cfsParams:
   defaultValue: ''
   isModifiable: false
   dataDescriptor:
+    resourceRealm:
+      dataType: string
+      defaultValue: ''
+      isRequired: true
+      isModifiable: false
+      valueList:
+      - devclustername
+      - k8s-3-sandbox-nubes-ru
+      - k8s-4-sandbox-nubes-ru
+    psqlEnabled:
+      dataType: boolean
+      defaultValue: 'true'
+      isRequired: true
+      isModifiable: false
+      valueList:
+      - 'true'
     redisEnabled:
       dataType: boolean
       defaultValue: 'true'
@@ -70,21 +128,6 @@ cfsParams:
       defaultValue: ''
       isRequired: true
       isModifiable: false
-    resourceRealm:
-      dataType: string
-      defaultValue: ''
-      isRequired: true
-      isModifiable: false
-      valueList:
-      - k8s-3-sandbox-nubes-ru
-      - k8s-4-sandbox-nubes-ru
-    psqlEnabled:
-      dataType: boolean
-      defaultValue: 'true'
-      isRequired: true
-      isModifiable: false
-      valueList:
-      - 'true'
 - svcOperationCfsParamId: 1056
   svcOperationCfsParam: clusterConfiguration
   dataType: map-fixed
@@ -138,7 +181,7 @@ cfsParams:
   dataDescriptor:
     domain:
       dataType: string
-      defaultValue: nextcloud-vbxjicr2
+      defaultValue: nextcloud-gsjkslra
       isRequired: true
       isModifiable: false
 - svcOperationCfsParamId: 1058
@@ -193,19 +236,6 @@ cfsParams:
   defaultValue: ''
   isModifiable: true
   dataDescriptor:
-    replicas:
-      dataType: integer > 0
-      defaultValue: ''
-      isRequired: true
-      isModifiable: false
-      valueList:
-      - '1'
-      - '2'
-    disk:
-      dataType: integer > 0
-      defaultValue: ''
-      isRequired: true
-      isModifiable: false
     cpu:
       dataType: integer > 0
       defaultValue: ''
@@ -230,6 +260,19 @@ cfsParams:
       - '6144'
       - '7168'
       - '8192'
+    replicas:
+      dataType: integer > 0
+      defaultValue: ''
+      isRequired: true
+      isModifiable: false
+      valueList:
+      - '1'
+      - '2'
+    disk:
+      dataType: integer > 0
+      defaultValue: ''
+      isRequired: true
+      isModifiable: false
 - svcOperationCfsParamId: 1060
   svcOperationCfsParam: appConfiguration
   dataType: map-fixed
@@ -276,18 +319,9 @@ cfsParams:
       isRequired: true
       isModifiable: false
       valueList:
+      - devclustername
       - k8s-3-sandbox-nubes-ru
       - k8s-4-sandbox-nubes-ru
-    veleroUid:
-      dataType: string
-      defaultValue: ''
-      isRequired: true
-      isModifiable: false
-    recoveryPoint:
-      dataType: string
-      defaultValue: ''
-      isRequired: true
-      isModifiable: false
     psqlEnabled:
       dataType: boolean
       defaultValue: 'true'
@@ -302,6 +336,11 @@ cfsParams:
       isModifiable: false
       valueList:
       - 'true'
+    recoveryPoint:
+      dataType: string
+      defaultValue: ''
+      isRequired: true
+      isModifiable: false
     psqlUid:
       dataType: uuid
       defaultValue: ''
@@ -312,6 +351,11 @@ cfsParams:
       defaultValue: ''
       isRequired: true
       isModifiable: false
+    veleroUid:
+      dataType: string
+      defaultValue: ''
+      isRequired: true
+      isModifiable: false
 - svcOperationCfsParamId: 1079
   svcOperationCfsParam: clusterConfiguration
   dataType: map-fixed
@@ -319,16 +363,6 @@ cfsParams:
   defaultValue: ''
   isModifiable: true
   dataDescriptor:
-    replicas:
-      dataType: integer > 0
-      defaultValue: 1,2
-      isRequired: true
-      isModifiable: false
-    disk:
-      dataType: integer > 0
-      defaultValue: '10'
-      isRequired: true
-      isModifiable: false
     cpu:
       dataType: integer > 0
       defaultValue: ''
@@ -353,6 +387,16 @@ cfsParams:
       - '6144'
       - '7168'
       - '8192'
+    replicas:
+      dataType: integer > 0
+      defaultValue: 1,2
+      isRequired: true
+      isModifiable: false
+    disk:
+      dataType: integer > 0
+      defaultValue: '10'
+      isRequired: true
+      isModifiable: false
 - svcOperationCfsParamId: 1080
   svcOperationCfsParam: accessConfiguration
   dataType: map-fixed
@@ -362,7 +406,7 @@ cfsParams:
   dataDescriptor:
     domain:
       dataType: string
-      defaultValue: nextcloud-bcdguda1
+      defaultValue: nextcloud-cpp3zfhe
       isRequired: true
       isModifiable: false
 - svcOperationCfsParamId: 1081
@@ -372,6 +416,13 @@ cfsParams:
   defaultValue: ''
   isModifiable: true
   dataDescriptor:
+    documentServer:
+      dataType: string
+      defaultValue: collabora
+      isRequired: true
+      isModifiable: false
+      valueList:
+      - collabora
     logLevel:
       dataType: string
       defaultValue: NONE
@@ -389,13 +440,6 @@ cfsParams:
       defaultValue: ''
       isRequired: false
       isModifiable: false
-    documentServer:
-      dataType: string
-      defaultValue: collabora
-      isRequired: true
-      isModifiable: false
-      valueList:
-      - collabora
 cfsParamsByOp:
   16:
   - 1055
@@ -418,7 +462,7 @@ cfsParamsByOp:
   129: []
   128: []
 stateParams:
-  startupConfiguration: '{"redisEnabled": true, "psqlUid": "", "redisUid": "", "resourceRealm": "", "psqlEnabled": true}'
+  startupConfiguration: '{"resourceRealm": "", "psqlEnabled": true, "redisEnabled": true, "psqlUid": "", "redisUid": ""}'
   clusterConfiguration: '{"cpu": 1000, "memory": 1024, "replicas": 1, "disk": 10}'
-  accessConfiguration: '{"domain": "nextcloud-vbxjicr2"}'
+  accessConfiguration: '{"domain": "nextcloud-gsjkslra"}'
   appConfiguration: '{"version": "33.0.4", "documentServer": "collabora", "logLevel": "INFO"}'