Установка подчиненного кластера

Требования к запуску нового подчинённого кластера

Заметка

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

Перед началом установки подчинённого кластера следует удовлетворить следующие требования:

• Успешная установка управляющего кластера Bootsman
• DNS-имя управляющего кластера должно быть в DNS-сервере и разрешается для будущего подчинённого кластера
• Доступ подчинённого кластера к управляющему
• Сумма символов будущего имени кластера и имени Namespace не должно превышать 30 символов

Наименования кластеров

ПравильноНе правильно 1Не правильно 2

Имя подчиненного кластера: test-cluster

Namespace: test-cluster

Сумма символов: 24

Имя подчиненного кластера: very-very-long-name-cluster

Namespace: test-cluster

Сумма символов: 39

Имя подчиненного кластера: test-cluster

Namespace: very-very-long-namespace

Сумма символов: 36

Установка

Установку можно провести двумя способами:

• Использовать установщик Bootsman
• Применить yaml-манифесты

Разворачивание с помощью установщика

Заметка

Во время заполнения формы вы можете в любой момент переключится в режим yaml

Для создания подчинённого кластера авторизуйтесь в управляющий кластер и нажмите кнопку

Вас перенаправит на страничку установщика для заполнения данных о будущем кластере.

Сначала укажите имя нового подчинённого кластера (1)

1. SUBCLUSTER_NAME

Kubernetes Options

Имя параметра	Описание
SUBCLUSTER_KUBERNETES_VERSION	Версия Kubernetes. Поддерживаемые версии
SUBCLUSTER_NAMESPACE	Namespace управляющего кластера, который будет содержать объекты подчинённого кластера
SUBCLUSTER_POD_CIDR	Блок адресов для Pods. Должен не пересекаться с другими блоками внутри одного Kubernetes кластера и реальными сетями вашей инфраструктуры. Допустимый размер блока /[1-20] Пример: podsCidrBlocks: ["172.20.0.0/16"]
SUBCLUSTER_SERVICE_CIDR	Блок адресов для Service. Должен не пересекаться с другими блоками внутри одного Kubernetes кластера и реальными сетями вашей инфраструктуры. Допустимый размер блока /[1-20] Пример: servicesCidrBlocks: ["172.21.0.0/16"]

Provider Configuration

Заметка

Для запуска нового подчиненного кластера, вам потребуется либо создать Secret с авторизационными данными, либо использовать существующий Для создания нового secret или namespace используйте кнопку создания в соответствующем окне выбора

Имя параметра	Описание
VMMANAGER_AUTH_URL	IP-адрес или DNS-имя VmManager. Пример: http://10.0.0.10:8080
VMMANAGER_AUTH_SECRET_NAMESPACE	Имя namespace, в котором размещен secret для авторизации VmManager
VMMANAGER_AUTH_SECRET_NAME	Имя secret с авторизацией в VmManager
VMMANAGER_AUTH_SECRET_USERNAME_KEY	Ключ в secret для хранения имени пользователя VmManager
VMMANAGER_AUTH_SECRET_PASSWORD_KEY	Ключ в secret для хранения пароля пользователя VmManager
SSH_KEY_#	Список ssh-ключей, которые будут добавлены на узлы

Private Registry

В случае, если вы хотите использовать наш репозиторий образов, то переключите параметр "Use private registry" в выключенное состояние и продолжайте заполнять в соотвествии с следующим разделом.

Если хотите произвести установку из локального репозитория, то заполните поля из формы ниже

Заметка

В случае использования уже существующего секрета на управляющем кластере, следует использовать настройку "Credential settings" "Use existing" Формы помогут найти секрет и указать имена полей, которые соответствуют пользователю и паролю

Заметка

Advanced mode поможет вам задать специфические имена ключей в секрете. По умолчанию, username - пользователь, password - пароль

Имя параметра	Описание
PRIVATE_REGISTRY_URL	URL вашего репозитория образов. Если установка будет производится online блок registry можно удалить
PRIVATE_REGISTRY_SECRET_NAMESPACE	Namespace, в котором размещен secret для авторизации в приватный репозиторий образов
PRIVATE_REGISTRY_SECRET_NAME	Имя secret для авторизации в приватный репозиторий образов
PRIVATE_REGISTRY_USERNAME	Имя пользователя в репозитории образов. Если установка будет производится online блок registry можно удалить
PRIVATE_REGISTRY_PASSWORD	Пароль для пользователя в репозитории образов. Если установка будет производится online блок registry можно удалить
PRIVATE_REGISTRY_SECRET_HOST_KEY	При использовании существующего secret. Имя ключа, содержащее параметр HOST
PRIVATE_REGISTRY_SECRET_USERNAME_KEY	При использовании существующего secret. Имя ключа, содержащее параметр USERNAME
PRIVATE_REGISTRY_SECRET_PASSWORD_KEY	При использовании существующего secret. Имя ключа, содержащее параметр PASSWORD

Control Plane

Заметка

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

Имя параметра	Описание
KCP_REPLICAS	Количество узлов с ролью master. Может принимать значения 3 или 5
K8SCPIP	IP-адрес балансировщика kube-apiserver для обеспечения отказоустойчивости. Адрес должен быть свободен и не состоять в dhcp-пулах Подробнее
KUBE_API_PORT	Порт kube-api. По-умолчанию 6443
MHC_MAX_UNHEALTY	Пороговое значение для MachineHealthCheck, при превышении которого не будет выполняться исправления. Для узлов с ролью master, значение по-умолчанию 100%. Для узлов с ролью worker, значение по-умолчанию 40% Подробнее
MHC_TIMEOUT	Время, которое дается узлу на самостоятельное восстановление, прежде чем вмешается MachineHealthCheck. По-умолчанию 10m Подробнее
CONTROLPLANE_VCPU	Число vCPU. Требования к инфраструктуре
CONTROLPLANE_DISK_GB	Объём дискового пространства. Измеряется в GB. Требования к инфраструктуре
CONTROLPLANE_MEMORY_GB	Объём оперативной памяти. Измеряется в GB. Требования к инфраструктуре
CONTROLPLANE_OS_TEMPLATE_NAME	Имя шаблона ОС виртуальной машины, из которого будут созданы новые узлы с ролью master
VMMANAGER_CLUSTER_NAME	Имя кластера (группы хостов) VmManager
IPPOOL_NAME	Имя пула IP-адресов для сети

WorkerPool

Шаблон виртуальных машин

Заметка

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

Имя параметра	Описание
SUBCLUSTER_WORKERPOOL_NAME	Имя пула виртуальных машин
WORKER_REPLICAS	Число узлов в workerpool. Сумма узлов во всех workerpool должна быть >=3
Roles	Для большинства инсталляций используйте роль bootsman-worker. Подробнее о ролях
MHC_MAX_UNHEALTY	Пороговое значение для MachineHealthCheck, при превышении которого не будет выполняться исправления. Для узлов с ролью master, значение по-умолчанию 100%. Для узлов с ролью worker, значение по-умолчанию 40% Подробнее
MHC_TIMEOUT	Время, которое дается узлу на самостоятельное восстановление, прежде чем вмешается MachineHealthCheck. По-умолчанию 10m Подробнее
WORKER_OS_TEMPLATE_NAME	Имя шаблона ОС виртуальной машины, из которого будут созданы новые узлы с ролью worker
WORKER_VCPU	Число vCPU. Требования к инфраструктуре
WORKER_MEMORY_GB	Объём оперативной памяти. Измеряется в GB. Требования к инфраструктуре
WORKER_DISK_GB	Объём дискового пространства. Измеряется в GB. Требования к инфраструктуре

Установка с помощью yaml-манифестов

Если вам удобнее способ применения yaml-манифестов, то ниже есть примеры. Заполните их в соответствии с описанием из главы, представленной ранее.

Заметка

Манифест secret_private_registry.yaml требуется только для установки из вашего приватного репозитория, в случае установки из репозитория Bootsman - пропустите.

kubectl apply -f secret_private_registry.yaml
kubectl apply -f secret_vmmanager_auth.yaml
kubectl apply -f Cluster.yaml
kubectl apply -f Workerpool.yaml

secret_private_registry.yamlsecret_vmmanager_auth.yamlCluster.yamlWorkerpool.yaml

apiVersion: v1
kind: Secret
metadata:
  name: PRIVATE_REGISTRY_SECRET_NAME (1)
  namespace: PRIVATE_REGISTRY_SECRET_NAMESPACE (2)
stringData:
  host: PRIVATE_REGISTRY_HOST (3)
  username: PRIVATE_REGISTRY_USERNAME (4)
  password: PRIVATE_REGISTRY_PASSWORD (5)

1. Имя secret для авторизации в приватный репозиторий образов
2. Namespace, в котором размещен secret для авторизации в приватный репозиторий образов
3. Доменное имя вашего репозитория образов
4. Имя пользователя в репозитории образов.

   Если установка будет производится online блок registry можно удалить

5. Пароль для пользователя в репозитории образов.

   Если установка будет производится online блок registry можно удалить

apiVersion: v1
kind: Secret
metadata:
  name: VMMANAGER_AUTH_SECRET_NAME (1)
  namespace: VMMANAGER_AUTH_SECRET_NAMESPACE (2)
data:
  password: VMMANAGER_AUTH_PASSWORD (3)
  username: VMMANAGER_AUTH_USERNAME (4)

1. Имя secret с авторизацией в VmManager
2. Имя namespace, в котором размещен secret для авторизации VmManager
3. Пароль пользователя VM Manager
4. Пользовать VM Manager

apiVersion: provisioning.bootsman.tech/v1alpha1
kind: Cluster
metadata:
  name: SUBCLUSTER_NAME (1)
  namespace: SUBCLUSTER_NAMESPACE (2)
spec:
  bootsmanVersion: latest
  clusterType: capi
  capiConfig:
    controlPlane:
      replicas: KCP_REPLICAS (3)
      endpoint:
        host: K8SCPIP (4)
        port: KUBE_API_PORT (5)
    infrastructure:
      provider: vmmanager
      sshAuthorizedKeys: (6)
            - >-
              ssh-ed25519 CCULn/YglEAzQcMqC7xIViZEl0gBU49o73wKaf1M0x0K0bgyZpG6DJDXw24cjbI4U4yaZI example
      vmmanagerProviderConfig:
        cluster:
          name: VMMANAGER_CLUSTER_NAME
        ipPool:
          name: VMMANAGER_IPPOOL_NAME (16)
          useExisting: true
        authConfig:
          identityEndpoint: VMMANAGER_AUTH_URL (7)
          insecure: true
          passwordKey: password (8)
          secret:
            name: VMMANAGER_AUTH_SECRET_NAME (9)
            namespace: VMMANAGER_AUTH_SECRET_NAMESPACE (10)
          usernameKey: username (11)
        machineOptions:
          vcpu: VMMANAGER_CONTROLPLANE_VCPU (12)
          disk: VMMANAGER_CONTROLPLANE_MEMORY_GB (13)
          memory: VMMANAGER_CONTROLPLANE_DISK_GB (14)
          os:
            name: VMMANAGER_CONTROLPLANE_OS_TEMPLATE_NAME (15)
        privacy: Private (18)
    kubernetesVersion: SUBCLUSTER_KUBERNETES_VERSION (19)
    network:
      podsCidrBlocks:
        - SUBCLUSTER_POD_CIDR (20)
      servicesCidrBlocks:
        - SUBCLUSTER_SERVICE_CIDR (21)
    # Раскомментируйте блок для установки из вашего регистри
    # registry:
    #   credentialsSecret:
    #     hostKey: host
    #     name: PRIVATE_REGISTRY_SECRET_NAME (23)
    #     namespace: PRIVATE_REGISTRY_SECRET_NAMESPACE (24)
    #     passwordKey: password
    #     usernameKey: username
    #   url: "PRIVATE_REGISTRY_URL (22)
    kubeletExtraArgsFlags:
      eviction-hard: ''
      eviction-max-pod-grace-period: ''
      eviction-minimum-reclaim: ''
      kube-reserved: ''
      max-pods: ''
      seccomp-default: ''
      system-reserved: ''

1. Имя подчиненного кластера.

   Должен быть уникальным в пределах namespace.

2. Namespace управляющего кластера, который будет содержать объекты подчинённого кластера
3. Количество узлов с ролью master.

   Может принимать значения 3 или 5

4. IP-адрес балансировщика kube-apiserver для обеспечения отказоустойчивости.

   Адрес должен быть свободен и не состоять в dhcp-пулах Подробнее

5. Порт kube-api. По-умолчанию 6443
6. Список ssh-ключей, которые будут добавлены на узлы
7. IP-адрес или DNS-имя VmManager.

   Пример: http://10.0.0.10:8080

8. Ключ в secret для хранения пароля пользователя VmManager
9. Имя secret с авторизацией в VmManager
10. Имя namespace, в котором размещен secret для авторизации VmManager
11. Ключ в secret для хранения имени пользователя VmManager
12. Число vCPU.

    Требования к инфраструктуре

13. Объём оперативной памяти. Измеряется в GB.

    Требования к инфраструктуре

14. Объём дискового пространства. Измеряется в GB.

    Требования к инфраструктуре

15. Имя шаблона ОС виртуальной машины, из которого будут созданы новые узлы с ролью master
16. Имя пула IP-адресов для сети
17. true в случае использования существующего ресурса, false для создания нового
18. Для VmManager это поле всегда Private
19. Версия Kubernetes. Поддерживаемые версии
20. Блок адресов для Pods.

    Должен не пересекаться с другими блоками внутри одного Kubernetes кластера и реальными сетями вашей инфраструктуры.

    Допустимый размер блока /[1-20]

    Пример:

    podsCidrBlocks: ["172.20.0.0/16"]

21. Блок адресов для Service.

    Должен не пересекаться с другими блоками внутри одного Kubernetes кластера и реальными сетями вашей инфраструктуры.

    Допустимый размер блока /[1-20]

    Пример:

    servicesCidrBlocks: ["172.21.0.0/16"]

22. URL вашего репозитория образов.

    Если установка будет производится online блок registry можно удалить

23. Имя secret для авторизации в приватный репозиторий образов
24. Namespace, в котором размещен secret для авторизации в приватный репозиторий образов

apiVersion: provisioning.bootsman.tech/v1alpha1
kind: WorkerPool
metadata:
  name: SUBCLUSTER_WORKERPOOL_NAME (1)
  namespace: SUBCLUSTER_NAMESPACE (2)
spec:
  clusterName: SUBCLUSTER_NAME (3)
  kubernetesVersion: SUBCLUSTER_KUBERNETES_VERSION (4)
  replicas: WORKER_REPLICAS (5)
  infrastructure:
    provider: vmmanager
    vmmanagerProviderConfig:
      cpu: VMMANAGER_WORKER_VCPU (6)
      disk: VMMANAGER_WORKER_DISK_GB (7)
      memory: VMMANAGER_WORKER_MEMORY_GB (8)
      os:
        name: VMMANAGER_WORKER_OS_TEMPLATE_NAME (9)
  kubeletExtraArgsFlags:
    eviction-hard: ''
    eviction-max-pod-grace-period: ''
    eviction-minimum-reclaim: ''
    kube-reserved: ''
    max-pods: ''
    seccomp-default: ''
    system-reserved: ''
  roles:
    - name: bootsman-worker

1. Имя пула виртуальных машин
2. Namespace управляющего кластера, который будет содержать объекты подчинённого кластера
3. Имя подчиненного кластера.

   Должен быть уникальным в пределах namespace.

4. Версия Kubernetes. Поддерживаемые версии
5. Число узлов в workerpool. Сумма узлов во всех workerpool должна быть >=3
6. Число vCPU.

   Требования к инфраструктуре

7. Объём дискового пространства. Измеряется в GB.

   Требования к инфраструктуре

8. Объём оперативной памяти. Измеряется в GB.

   Требования к инфраструктуре

9. Имя шаблона ОС виртуальной машины, из которого будут созданы новые узлы с ролью worker

Следующий шаг

• Модули платформы "Боцман"