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

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

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

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

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

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

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

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

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

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

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

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

    kubectl get globalconfigurations.global-system.ru gs-config -o yaml > gs-config-backup.yaml
    
  2. В исходном config.yaml замените kind на NamespacedGlobalConfiguration, добавьте metadata.namespace: gs-dev, сохраните имя и настройки spec. Примените файл:

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

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

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

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

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

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

    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:

deploymentType: both

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

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

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

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 в заголовке. Это единственное отличие в конфигурационном ресурсе от обычной установки:

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

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

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.