Для улучшения работы сайта мы используем файлы cookies. Оставаясь на сайте, вы соглашаетесь с политикой обработки персональных данных.

Подготовка окружения

1. Настройка DNS организации

В DNS организации необходимо выделить зону, в рамках которой будут размещаться сервисы портала, например cloudlink.sample.box.

Для Single instance все записи должны указывать на IP-адрес целевого сервера (Target).

Для High Availability все записи должны указывать на IP-адрес VIP. VIP указывается в файле inventories/box/hosts.

Список DNS записей
account-manager.sample.box
airflow.sample.box
api.sample.box
auth.sample.box
awx.sample.box
capacity-manager-ui.sample.box
checklist-service.sample.box
cloud-docker.nexus.sample.box
control.sample.box
docs.sample.box
git.sample.box
grafana.sample.box
iam.sample.box
infra-manager.sample.box
k3s-ui.sample.box
keycloak.sample.box
kong-admin.sample.box
kong-manager.sample.box
kong.sample.box
konga.sample.box
longhorn-basic.sample.box
longhorn.sample.box
minio-api.sample.box
minio.sample.box
netbox.sample.box
nexus.sample.box
notification-service.sample.box
oauth2-proxy.sample.box
order-manager.sample.box
portal-manager.sample.box
portal.sample.box
powerdns-admin.sample.box
powerdns-auth.sample.box
product-catalog.sample.box
product-mover.sample.box
products-docker-private.nexus.sample.box
products-docker.nexus.sample.box
partners-admin.sample.box
partners-auth.sample.box
rabbitmq.sample.box
sdn-manager.sample.box
spark.sample.box
spectre.sample.box
starvault.sample.box
superset.sample.box
swagger-ui.sample.box
swagger.sample.box
tag-manager.sample.box
tariff-manager.sample.box
velero.sample.box
unit-manager.sample.box
web-console.sample.box

Проверьте разрешения следующих доменных имен с помощью nslookup перед запуском развёртывания. Доменные имена следует указать в явном виде:

  • starvault.{{ internal-domain }}

  • nexus.{{ internal-domain }}

  • docker-repository.nexus.{{ internal-domain }}

Где internal-domain -- внутренний домен организации, при необходимости с поддоменом. Например, cloudlink.sample.box.

Не используйте символ нижнего подчеркивания _ в доменных именах. Даже если DNS-сервер допускает такие записи, это может привести к ошибкам при установке.

2. Требования к управляющему хосту

  • Python версии 3.9 и выше.

  • Установленный и настроенный Docker. Подробнее — в разделе Дополнительные компоненты.

  • Отключенная система принудительного контроля доступа SELinux

  • Доступ к репозиториям операционной системы

3. Требования к целевому хосту

  • Python версии 3.9 и выше.

  • Обеспечен доступ к репозиториям операционной системы. Доступ может быть организован через прямое подключение к интернету, прокси-сервер или предварительную установку зависимостей вручную.

  • На целевом хосте (Target) должен быть включен IPv6, поскольку его отсутствие может привести к ошибкам при сборке портала.

  • Для Debian ОС необходимо выполнить дополнительную настройку:

    Дополнительная настройка для Debian 12 и Debian 13

    Для корректной работы на целевом хосте с Debian 12 или Debian 13 необходимо увеличить значения параметров inotify.

    1. Откройте файл /etc/sysctl.d/99-sysctl.conf:

      sudo nano /etc/sysctl.d/99-sysctl.conf
    2. Добавьте или измените следующие параметры:

      fs.inotify.max_user_instances = 8192
      fs.inotify.max_user_watches = 524288
    3. Примените изменения:

      sudo sysctl --system
Загружаемые пакеты для RHEL-based и Debian-based дистрибутивов
  1. Пакеты, загружаемые на целевой хост для Debian-based дистрибутивов:

    • chrony

    • jq

    • docker.io

    • rsync

    • tar

    • open-iscsi

    • nfs-common

    • keepalived

    • haproxy

  2. Пакеты, загружаемые на целевой хост для RHEL-based дистрибутивов:

    • chrony

    • jq

    • docker-ce

    • rsync

    • tar

    • iscsi-initiator-utils

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

      dnf --setopt=tsflags=noscripts install -y iscsi-initiator-utils && echo "InitiatorName=$(/sbin/iscsi-iname)" > /etc/iscsi/initiatorname.iscsi nfs-utils

    • keepalived

    • haproxy

      Для управляющего хоста вне зависимости от дистрибутива:

    • gzip

    • docker

Для работы в режимах High Availability и Single Instance на целевых хостах (Target) рекомендуется отключить SELinux и межсетевой экран (Firewall).

4. Требования к сетевому взаимодействию

Для режима High Availability необходимо обеспечить следующую сетевую доступность:

4.1. Внутрикластерное взаимодействие

Протокол Порт Source Destination Описание

TCP

6443, 10250, 10256, 10257, 10259

Все ноды

Все ноды

Взаимодействие нод кластера k3s

IP (4)

-

Все ноды

Все ноды

Calico IPIP (encapsulation)

TCP

179

Все ноды

Все ноды

Calico BGP (networking)

TCP

9099

Все ноды

Все ноды

Calico health check

TCP

2379, 2380

Server ноды

Server ноды

Взаимодействие нод кластера etcd

4.2. Взаимодействие с внешними сервисами

Протокол Порт Source Destination Описание

TCP

80, 443

Все ноды и АРМ

LB VIP*

Балансировщик нагрузки (haproxy)

TCP

443

LB VIP*

Менеджер управления виртуализации
Облачные провайдеры

API вызовы, для развертывания заказов

TCP

22, 443, 9100

LB VIP*

ВМ в рамках заказа на базе ОС Linux

Автоматизированная настройка сервисов заказа
Постановка заказа на мониторинг

TCP

5985, 5986, 443, 9100

LB VIP*

ВМ в рамках заказа на базе ОС Windows

Автоматизированная настройка сервисов заказа
Постановка заказа на мониторинг

TCP

389, 636

LB VIP*

LDAP сервер

Интеграция со службой каталога

TCP, UDP

53

LB VIP*

DNS сервер

Интеграция со службой разрешения имен

UDP

123

LB VIP*

NTP сервер

Интеграция со службой синхронизации времени

LB VIP — это VIP адрес сервера балансировки нагрузки CloudLink.