# Развертывание в коммунальном кластере

Коммунальный кластер Kubernetes используется несколькими приложениями или командами. Для каждого окружения Global ERP
выделяют свой namespace, например `gs-dev`, и хранят конфигурацию приложения в `NamespacedGlobalConfiguration` этого
namespace.

Ниже два сценария: переход работающей установки и первая установка. Используется обычный Helm-чарт со стандартными
ролями; менять код nsctl или вручную заменять Role на ClusterRole не требуется.

## Переход работающей установки на namespaced-конфигурацию

Переустанавливать приложение не нужно. Сохраните существующие `values.yaml`, роли и сервисные учетные записи. В
частности, **не переключайте `deploymentType: both` на `namespace` ради перехода**: это отключит создание ролей и
ServiceAccount, и Helm может удалить ранее созданные им объекты. Если установка уже использует `namespace` с
подготовленными администратором правами, оставьте эту схему.

Проверьте наличие определения namespaced-типа:

```sh
kubectl api-resources --api-group=global-system.ru
```

В списке должны быть `globalconfigurations` и `namespacedglobalconfigurations`. Если второй тип отсутствует,
администратор один раз устанавливает его из вашей поставки gs-ctk:

```sh
kubectl apply -f ~/nscli/helm_chart/crds/namespaced_crd.yaml
```

Если оба типа уже есть и используются стандартные роли текущего чарта, дополнительных действий администратора для смены
типа конфигурации не требуется. Helm при обновлении существующего релиза автоматически не добавляет отсутствующие CRD из
каталога `crds/`.

В примерах имя существующей конфигурации — `gs-config`, namespace — `gs-dev`. Новый заголовок `config.yaml`:

```yaml
apiVersion: global-system.ru/v1
kind: NamespacedGlobalConfiguration
metadata:
  name: gs-config
  namespace: gs-dev
# Далее — существующий spec без изменения настроек приложения.
```

1. Сохраните старую конфигурацию вместе с ее состоянием:

   ```sh
   kubectl get globalconfigurations.global-system.ru gs-config -o yaml > gs-config-backup.yaml
   ```

2. В исходном `config.yaml` замените `kind` на `NamespacedGlobalConfiguration`, добавьте `metadata.namespace: gs-dev`,
   сохраните имя и настройки `spec`. Примените файл:

   ```sh
   kubectl apply -n gs-dev -f config.yaml
   ```

3. Проверьте, что nsctl принял новую конфигурацию и приложение работает. Перед удалением старой конфигурации убедитесь,
   что рабочие ресурсы уже привязаны к новой: в `metadata.ownerReferences` должны быть ее тип и UID. Это важно, чтобы
   удаление старого объекта не удалило рабочие ресурсы. Если старая конфигурация использовалась несколькими окружениями,
   сначала перенесите каждое из них.

   Состояние `status`, в том числе сведения об обновлении БД, обычный `apply` автоматически не переносит. Для работающей
   БД заранее проверьте необходимость его переноса из резервной копии, чтобы переход не вызвал нежелательное обновление.

4. После проверки **удалите старую общую конфигурацию**:

   ```sh
   kubectl delete globalconfigurations.global-system.ru gs-config
   ```

   Иначе nsctl других пространств имен продолжат читать ее и могут применять ее группы. Удаляется только объект
   `gs-config`; сам CRD не удаляйте. Если конфигурация управляется Helm или GitOps, обновите также источник, чтобы
   старый объект не появился снова.

5. Убедитесь, что старая конфигурация отсутствует, а новая существует:

   ```sh
   kubectl get globalconfigurations.global-system.ru gs-config
   kubectl get namespacedglobalconfigurations.global-system.ru gs-config -n gs-dev
   ```

   Для первой команды ожидается `NotFound`. Для второй — новая конфигурация в `gs-dev`.

## Первая установка сразу с namespaced-конфигурацией

При наличии необходимых прав выполните полную автоматизированную установку по основной инструкции — коммунальный кластер
этому не препятствует. В `values.yaml` оставьте `deploymentType: both`: Helm создаст namespace и необходимые ресурсы,
включая CRD, ServiceAccount, Role и ClusterRole. Затем отдельно примените `config.yaml` с типом
`NamespacedGlobalConfiguration` и `metadata.namespace`, чтобы конфигурация приложения находилась в своем namespace.
Ручная подготовка из следующей главы для этого сценария не нужна.

### Шаг 1. Подготовьте values.yaml

Заполните реестр образов, системное хранилище и остальные параметры по основной инструкции. Явно укажите или оставьте
стандартное значение `deploymentType: both`:

```yaml
deploymentType: both
```

Если параметра нет в вашем файле, `both` берется из значений чарта по умолчанию. Параметры `overrideNsctlServiceAccount`
и `overrideWorkerServiceAccount` добавлять не нужно: используются стандартные учетные записи.

### Шаг 2. Установите Helm-чарт

Администратор или пользователь с необходимыми правами выполняет одну команду:

```sh
helm upgrade --install gs-ctk-gs-dev ~/nscli/helm_chart \
  --namespace gs-dev --create-namespace -f values.yaml
```

Здесь `gs-ctk-gs-dev` — имя нового релиза, `gs-dev` — namespace. Для каждого окружения задавайте отдельное имя релиза:
имена кластерных ролей чарта зависят от него и должны отличаться между установками. Если namespace уже существует, Helm
использует его.

Helm установит отсутствующие CRD обоих типов, создаст ServiceAccount `nsctl`, стандартные роли и привязки, Deployment
контроллера, ConfigMap и остальные включенные настройками ресурсы чарта. Нужны права на создание namespace, CRD и RBAC,
а также разрешение платформы на стандартные права чарта. Это тот же принцип, что в автоматизированной установке основной
инструкции.

Продолжите обычные шаги основной инструкции, включая подготовку секретов, хранилищ и комплекта приложения.

### Шаг 3. Создайте и примените config.yaml

После установки Helm-чарта сформируйте полную конфигурацию приложения по основной инструкции, но используйте тип
`NamespacedGlobalConfiguration` и задайте namespace в заголовке. Это единственное отличие в конфигурационном ресурсе от
обычной установки:

```yaml
apiVersion: global-system.ru/v1
kind: NamespacedGlobalConfiguration
metadata:
  name: gs-config
  namespace: gs-dev
# Далее — заполненный spec с группами ресурсов и настройками приложения.
```

Если namespace задан внутри групп ресурсов, проверьте соответствие `gs-dev`. Примените полный файл:

```sh
kubectl apply -n gs-dev -f config.yaml
```

Продолжите инициализацию БД и проверку приложения по основной инструкции. Создавать старый объект `GlobalConfiguration`
не нужно — при первой установке нет и шага его удаления.

Если используете `helmResgroup.enabled: true`, текущий чарт уже создает `NamespacedGlobalConfiguration`. В этом случае
управляйте этой конфигурацией через значения Helm, не применяя поверх нее отдельный `config.yaml`.

### Если платформа запрещает автоматизированную установку

Только если политики кластера не позволяют выполнить Helm-установку с `deploymentType: both`, используйте вариант
**«Установка с ручной подготовкой окружения»** основной инструкции:
администратор заранее создает namespace, оба CRD, сервисные учетные записи и права, а приложение устанавливается с
`deploymentType: namespace` и `--skip-crds`. Это ограничение прав конкретного кластера, а не требование
`NamespacedGlobalConfiguration`.
