Боцман

Тема

Шаг 0. Подготовка к инсталляции платформы Боцман ​

Перед началом инсталляции платформы "Боцман" убедитесь, что выполнены все шаги по подготовке АРМ

Заметка

Для работы кластера Bootsman c внешним ETCD потребуется дополнительная подготовка. Подробнее

Шаг 1. Подготовка конфигурационного файла (config) ​

На АРМ создайте конфиг файл bootsman.config.yaml в той же директории, где расположен инсталлятор-bootsmanctl

Заметка

Обратите внимание на закомментированные блоки. Следует выбрать один из предложенных и раскомментировать.

yaml
kubernetesVersion: {++K8S_VERSION++} (1)
# Раскоментируйте блок в случае airgap установки
# registry:
#   username: {++HARBOR_CREDS_USER++} (2)
#   password: {++HARBOR_CREDS_PASSWD++} (3)
#   path: {++HARBOR_CREDS_URL++} (4)
#   insecure: {++HARBOR_CREDS_INSECURE++} (5)
sshAuthorizedKeys: (6)
  - ssh-ed25519 AAAAC3NzaC1lZKKtLOCNv2g bootsman@stsoft.ru
wait:
  clusterCtlTimeout: 30m0s
  operationTimeout: 40m0s
  operationRetryInterval: 15s
  objCreateTimeout: 4m0s
  objCreateInterval: 5s
  addonHelmTimeout: 5m
infrastructure:
  clusterNetwork:
    podCidrBlocks: ["172.20.0.0/16"] (7)
    servicesCidrBlocks: ["172.21.0.0/16"] (8)
  brest:
    network:
      name: {++BREST_NETWORK_NAME++} (10)
      # Раскоментируйте блок в случае использования существующей сети
      # useExisting: true (9)
      # Раскоментируйте блок в случае создания новой сети
      # options:
      #   driver: "802.1Q" (29)
      #   vlanId: "{++BREST_NETWORK_VLAN_ID++}" (30)
      #   address: "{++BREST_NETWORK_ADDRESS++}" (31)
      #   size: {++BREST_NETWORK_SIZE++} (32)
      #   device: "{++BREST_NETWORK_PHYDEV++}" (33)
      #   gateway: "{++BREST_NETWORK_GATEWAY++}" (34)
    auth:
      username: {++BREST_AUTH_USERNAME++} (11)
      password: {++BREST_AUTH_PASSWORD++} (12)
      identityEndpoint: {++BREST_AUTH_URL++} (13)
controlPlane:
  endpoint:
    host: {++K8SCPIP++} (14)
    port: {++KUBE_API_PORT++} (15)
  replicas: {++CONTROLPLANE_COUNT++} (16)
  label: ""
  kubeletExtraArgs:
    kubeReserved: ""
    systemReserved: ""
    evictionHard: ""
    evictionMinimumReclaim: ""
    evictionMaxPodGracePeriod: ""
    maxPods: ""
    seccompDefault: ""
  brestMachine:
    template:
      name: {++BREST_TEMPLATE_IMAGE_NAME++} (17)
    cpu: {++BREST_VM_CONTROLPLANE_CPU++} (18)
    memory: {++BREST_VM_CONTROLPLANE_MEMORY_GB++} (19)
    disk: {++BREST_VM_CONTROLPLANE_DISK_GB++} (20)
workerPool:
  replicas: {++WORKER_REPLICAS++} (21)
  label: ""
  kubeletExtraArgs:
    kubeReserved: ""
    systemReserved: ""
    evictionHard: ""
    evictionMinimumReclaim: ""
    evictionMaxPodGracePeriod: ""
    maxPods: ""
    seccompDefault: ""
  brestMachine:
    template:
      name: {++BREST_TEMPLATE_IMAGE_NAME++} (22)
    cpu: {++BREST_VM_WORKERPOOL_CPU++} (23)
    memory: {++BREST_VM_WORKERPOOL_MEMORY_GB++} (24)
    disk: {++BREST_VM_WORKERPOOL_DISK_GB++} (25)
web:
  bootstrapPassword: {++ADDONS_RANCHER_WEBHOSTNAME++} (26)
  hostname: {++ADDONS_RANCHER_WEBHOSTNAME++} (27)
currentMachineIp: {++CURRENT_MACHINE_IP_2++} (28)
  1. Версия Kubernetes. Поддерживаемые версии
  2. Имя пользователя в репозитории образов. Если установка будет производится online блок registry можно удалить
  3. Пароль для пользователя в репозитории образов. Если установка будет производится online блок registry можно удалить
  4. URL вашего репозитория образов. Если установка будет производится online блок registry можно удалить
  5. Это служебный параметр, всегда будет false
  6. Список ssh-ключей, которые будут добавлены на узлы
  7. Блок адресов для Pods.
    Должен не пересекаться с другими блоками внутри одного Kubernetes кластера.
    Минимальный размер блока /16
    Пример:
      podsCidrBlocks:
    - "172.20.0.0/16"
  8. Блок адресов для Service.
    Должен не пересекаться с другими блоками внутри одного Kubernetes кластера.
    Минимальный размер блока /16
    Пример:
      servicesCidrBlocks:
    - "172.21.0.0/16"
  10. Имя сети, в которую будут подключены новые виртуальные машины
  11. Пользователь для подключения к гипервизору
  12. Пароль для подключения
  13. URL для подключения.
    Пример:
    http://10.0.0.10:2633/RPC2
  14. IP ControlPlane Подробнее
  15. Порт kube-api. По-умолчанию 6443
  16. Количество узлов с ролью master.
    Может принимать значения 3 или 5
  17. Имя шаблона виртуальной машины, из которого будут созданы новые виртуальные машины
  18. Число vCPU.
    Требования к инфраструктуре
  19. Объём оперативной памяти.
    Требования к инфраструктуре
  20. Объём дискового хранилища.
    Требования к инфраструктуре
  21. Количество узлов в workerpool. Сумма узлов во всех workerpool должна быть >=3
  22. Имя шаблона виртуальной машины, из которого будут созданы новые виртуальные машины
  23. Число vCPU.
    Требования к инфраструктуре
  24. Объём оперативной памяти.
    Требования к инфраструктуре
  25. Объём дискового хранилища.
    Требования к инфраструктуре
  26. Первоначальный пароль от web портала
  27. URL, по которому будет доступен web портал платформы
  28. Дополнительный адрес АРМ администратора. Опционально. Для доступа в Kind кластеру с сторонней машины
  29. Технический параметр. Значение всегда "802.1Q"
  30. vlan ID внутри гипервизора Брест
  31. Начало DHCP-пула Бреста
  32. Число IP-адресов в DHCP-пуле
  33. Физическое устройство на узле
  34. Адрес шлюза

Пример заполненного файла конфигурации:

Шаг 2. Запуск установки ​

Заметка

Установка платформы "Боцман" запускается с заранее подготовленным АРМ. Все последующие команды выполняются на АРМ.

Выполните команду запуска процесса установки:

(1)./bootsmanctl management create {++cluster-name++} -i brest -c bootsman.config.yaml
  1. cluster-name - Имя управляющего кластера

Вывод инсталляции должен окончиться так:

bash
2023-09-10T17:49:46Z | INFO  | finished

Доступ в интерфейс ​

После окончания установки определите IP адрес любого узла с ролью worker и внесите его в конфиг DNS-сервера.
Используйте адрес web-панели (1) и пароль (2) из конфигурационном файла (bootsman.config.yaml) для успешной авторизации.

  1. ADDONS_RANCHER_WEBHOSTNAME
  2. ADDONS_RANCHER_BOOTSTRAPPASSWORD

Вы авторизовались под пользователем admin. Далее рекомендуем сменить этот пароль с помощью стандартного меню управления пользователями.

Команда Боцман

© Боцман