Процесс установки сателлита

В данном разделе описаны действия по выполнению новой установки сателлита.

Установка состоит из следующих этапов:

Запуск установщика
Настройка Ansible
Выбор пространства имен Kubernetes
Настройка NATS
Завершение установки
Настройка mTLS-шифрования между основным экземпляром и сателлитом
Подключение к пространству сателлита

Запуск установщика

Чтобы запустить установщик сателлита:

После скачивания run-файла перейдите в директорию его хранения и запустите его с помощью bash:
```
bash ./evo.platform_<version>_satellite.run
```
Требуемая версия bash: 4.0 или выше.

Или сделайте его исполняемым и запустите непосредственно:
```
chmod +x ./evo.platform_<version>_satellite.run
./evo.platform_<version>_satellite.run
```
Установщик выведет следующие сведения:
- версия системы и дата ее выпуска;
- путь к файлу хранения логов установки;
- результаты проверок:
  - удовлетворения системным требованиям;
  - наличия необходимых утилит;
  - целостности дистрибутива.
На этапе Select action выберите действие New installation in an existing K8s cluster:

Настройка Ansible

Задайте параметры Ansible на этапе Ansible creds:

Задайте имя пользователя.
Выберите метод аутентификации: по паролю или через ключ.
Если выбрана аутентификация по паролю, задайте и подтвердите пароль пользователя.

Выбор пространства имен Kubernetes

Выберите пространство имен (namespace) Kubernetes, в которое будет установлен сателлит, на этапе Kubernetes cluster namespace to install.

satellite install create new k8s space

Если требуется создать новое пространство имен, выберите опцию create new и введите название пространства.

Настройка NATS

На этапе NATS satellite setup:

Укажите максимальный размер хранилища NATS, не менее 20 ГБ.

Укажите уникальный идентификатор пространства сателлита.

С помощью одного дистрибутива можно установить несколько сателлитов, однако у каждого из них идентификатор пространства должен быть уникальным.

Требования к идентификатору пространства сателлита:

Допустимые символы: прописные и строчные латинские буквы, цифры, знак дефиса.
Идентификатор должен содержать не более 100 символов.

satellite install nats space name

Сохраните идентификатор пространства, он понадобится для подключения к пространству сателлита из интерфейса системы.

Укажите номер TCP-порта, по которому основной экземпляр системы будет подключаться к сателлиту. Данный порт будет открыт на всех узлах кластера сателлита.

Допустимые значения номера порта подключения: 30000—32767. Значение по умолчанию: 30072. Сателлиты могут использовать одинаковые порты при условии установки в разные кластеры Kubernetes.

satellite install nats port

Сохраните номер порта, он понадобится для подключения к пространству сателлита из интерфейса системы.

Завершение установки

По завершении установки в терминале отобразится сообщение, содержащее идентификатор пространства и номер порта установленного сателлита, например:

To add this Satellite as a new space of main instance use values:
  space id: space-satellite
  space port: 30072

Настройка mTLS-шифрования между основным экземпляром и сателлитом

По умолчанию после установки основного экземпляра системы и сателлита шифрование соединения между ними отключено.

При необходимости вы можете настроить шифрование соединения по протоколу mTLS. Для этого:

Включите TLS-шифрование для пространств. Для этого:
1. Подключитесь к терминалу master-узла кластера, в котором установлен основной экземпляр системы.
2. Откройте ConfigMap space-manager-extravars:
  kubectl -n <namespace> edit configmap space-manager-extravars
  Здесь:
  - <namespace> — название пространства имен, в котором установлена система.
3. Установите для переменной NATS_CONFIGURATOR_USE_LEAF_TLS_FOR_SPACES значение "true".
4. Сохраните изменения в ConfigMap.
5. Перезапустите Deployment evo.space.space-manager:
  kubectl -n <namespace> rollout restart deployment evo.space.space-manager

Задайте параметры TLS в ConfigMap nats-space-config. Для этого:

Откройте ConfigMap nats-space-config:
```
kubectl edit -n <namespace> configmaps nats-space-config -o yaml
```
Здесь:
- <namespace> — название пространства имен, в котором установлена система.

В блоке leafnodes добавьте блок tls со следующим содержимым:

"tls": {
  "ca_file": "/etc/nats/ca/ca.crt",
  "cert_file": "/etc/nats/tls/tls.crt",
  "key_file": "/etc/nats/tls/tls.key",
  "verify": true,
  "handshake_first": true
}

Пример измененного блока leafnodes

"leafnodes": {
  "no_advertise": true,
  "port": 7422,
  "tls": {
    "ca_file": "/etc/nats/ca/ca.crt",
    "cert_file": "/etc/nats/tls/tls.crt",
    "key_file": "/etc/nats/tls/tls.key",
    "verify": true,
    "handshake_first": true
  }
},

Перезапустите StatefulSet nats-space:

kubectl -n <namespace> rollout restart statefulset nats-space

Повторите действия на шаге 2 в терминале master-узла кластера сателлита.

Подключение к пространству сателлита

Управление сателлитом осуществляется за счет запускаемых в нем сервисов через веб-интерфейс основного экземпляра системы. Чтобы подключиться к сателлиту, необходимо создать подключение к его пространству. Для этого:

Войдите в веб-интерфейс основного экземпляра системы.
Перейдите в раздел Настройки → Пространства и сервисы → Пространства.
Нажмите на кнопку Создать (). Отобразится окно создания подключения.
Введите идентификатор пространства сателлита в поле ID.
Введите название подключения. Название может быть любым.
В поле IP или домен введите IP-адрес или доменное имя (FQDN) одного из узлов кластера, в котором развернут сателлит.
В поле Порт введите номер TCP-порта, указанного на этапе NATS satellite setup установки сателлита.
При необходимости введите описание подключения к пространству.
Нажмите на кнопку Создать. Система создаст подключение к пространству и отобразит соответствующее уведомление. Подключение отобразится в списке раздела Настройки → Пространства и сервисы → Пространства.

У созданного подключения отобразится статус Подключается. По завершении подключения статус изменится на Активен.

Время на инициализацию подключения зависит загруженности кластеров и каналов связи и может достигать 5—10 минут.

Была ли полезна эта страница?