Развертывание в коммунальном кластере#
Коммунальный кластер 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 без изменения настроек приложения.
Сохраните старую конфигурацию вместе с ее состоянием:
kubectl get globalconfigurations.global-system.ru gs-config -o yaml > gs-config-backup.yaml
В исходном
config.yamlзаменитеkindнаNamespacedGlobalConfiguration, добавьтеmetadata.namespace: gs-dev, сохраните имя и настройкиspec. Примените файл:kubectl apply -n gs-dev -f config.yaml
Проверьте, что nsctl принял новую конфигурацию и приложение работает. Перед удалением старой конфигурации убедитесь, что рабочие ресурсы уже привязаны к новой: в
metadata.ownerReferencesдолжны быть ее тип и UID. Это важно, чтобы удаление старого объекта не удалило рабочие ресурсы. Если старая конфигурация использовалась несколькими окружениями, сначала перенесите каждое из них.Состояние
status, в том числе сведения об обновлении БД, обычныйapplyавтоматически не переносит. Для работающей БД заранее проверьте необходимость его переноса из резервной копии, чтобы переход не вызвал нежелательное обновление.После проверки удалите старую общую конфигурацию:
kubectl delete globalconfigurations.global-system.ru gs-config
Иначе nsctl других пространств имен продолжат читать ее и могут применять ее группы. Удаляется только объект
gs-config; сам CRD не удаляйте. Если конфигурация управляется Helm или GitOps, обновите также источник, чтобы старый объект не появился снова.Убедитесь, что старая конфигурация отсутствует, а новая существует:
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.