Yandex Cloud

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

Заметка

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

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

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

Установка

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

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

Установка с помощью установщика Bootsman

Заметка

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

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

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

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

1. Cluster Name
2. Description

Kubernetes Options

Имя параметра	Описание	Комментарий
$	Версия Kubernetes
$	Namespace управляющего кластера, который будет содержать объекты подчинённого кластера
$	Подсеть для подов подчинённого кластера	Не пересекается с управляющим или другим подчинённым кластером
$	Подсеть для сервисов подчинённого кластера	Не пересекается с управляющим или другим подчинённым кластером

Provider Configuration

Имя параметра	Описание	Комментарий
$	Зона доступности облака Yandex	О Зонах Yandex
$	Выбор режима взаимодействия с кластером	Поддерживаемые значения Public, PrivateMachines, Private. Подробнее
$	Директория в облаке Yandex	Должна быть создана до запуска. Как узнать мой FodlerID?
$	Публичный ключ, который будет добавлен на узлы подчиненного кластера

Private Registry

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

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

Заметка

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

Заметка

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

Имя параметра	Описание	Комментарий
$	URL вашего репозитория образов
$	Namespace секрета
$	Имя секрета
$	Имя пользователя в репозитории образов
$	Пароль для пользователя в репозитории образов

Control Plane

Заметка

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

Имя параметра	Описание	Комментарий
$	Число реплик мастер-нод
$	Порт для kube-api	По умолчанию 6443

Авторизация

Заметка

Используйте существующий секрет, с указанием namespace, имени и ключа для поиска

Имя параметра	Описание	Комментарий
$	Namespace, в котором создан секрет
$	Имя секрета с ключом авторизации
$	Имя ключа в секрете авторизации
$	Ключ авторизации

Настройка Сети

Bootsman позволяет использовать как существующие сети и подсети Yandex Cloud, так и вновь созданные

Имя параметра	Описание	Комментарий
$	Имя сети. Исключает установку $
$	ID сети. Исключает установку $
$	Имя подсети. Исключает установку $
$	ID подсети. Исключает установку $
$	адресное пространство для новой подсети

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

Имя параметра	Описание	Комментарий
$	ID образа операционной системы	Подготовьте ОС в соответсвии с инструкцией или используйте уже подготовленные образа
$	Тип процессора	Типы Процессоров
$	Число CPU
$	Объём оперативной памяти	Измеряется в GiB
$	Тип дисков	Типы дисков
$	Объём дискового пространства	Измеряется в GiB

WorkerPool

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

Заметка

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

Заметка

для установки GPU operator включите параметр GPU Подробнее

Имя параметра	Описание	Комментарий
$	Имя пул виртуальных машин
$	Число виртуальных машин
$	Тип процессора	Типы Процессоров
$	ID образа операционной системы	Подготовьте ОС в соответсвии с инструкцией или используйте уже подготовленные образа
$	Число CPU
$	Объём оперативной памяти	Измеряется в GiB
$	Тип дисков	Типы дисков
$	Объём дискового пространства	Измеряется в GiB
$	Фиксированные конфигурации для GPU машин

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

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

Для применения yaml-манифестов можно использовать kubectl

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

apiVersion: provisioning.bootsman.tech/v1alpha1
kind: Cluster
metadata:
  name: {++${SUBCLUSTER_NAME}++}
  namespace: {++${SUBCLUSTER_NAMESPACE}++}
spec:
  bootsmanVersion: latest
  clusterType: capi
  capiConfig:
    kubernetesVersion: {++${SUBCLUSTER_KUBERNETES_VERSION}++}
    # Раскомментируйте здесь для установки из вашего регистри
    # registry:
    #   url: {++${PRIVATE_REGISTRY_URL}++}
    #   credentials:
    #     username: {++${PRIVATE_REGISTRY_USERNAME}++}
    #     password: {++${PRIVATE_REGISTRY_PASSWORD}++}
    controlPlane:
      replicas: {++${KCP_REPLICAS}++}
      endpoint: 
        port: {++${KUBE_API_PORT}++} 
    infrastructure:
      sshAuthorizedKeys:
        - >-
          ssh-ed25519 CCULn/YglEAzQcMqC7xIViZEl0gBU49o73wKaf1M0x0K0bgyZpG6DJDXw24cjbI4U4yaZI example
      provider: yandex 
      yandexProviderConfig:
        folderId: {++${YANDEX_FOLDERID}++}
        zone: {++${YANDEX_ZONE}++}
        network:
          name: {++${YANDEX_NETWORK_NAME}++}
          useExisting: false
      # Раскомментируйте здесь для использования существующей подсети
      # subNetwork:
      #   name: ${YANDEX_SUBNETWORK_NAME}
      #   useExisting: true
      # Раскомментируйте здесь для создания новой подсети
      # subNetwork:
      #   name: ${YANDEX_SUBNETWORK_NAME}
      #   cidr:
      #     - ${YANDEX_SUBNETWORK_CIDR}
      #   useExisting: false
        authConfig:
          secretName: {++${YANDEX_AUTH_SECRET}++}
          field: {++${YANDEX_AUTH_SECRET_KEY}++}
        apiKeySecretRef:
          name: {++${YANDEX_AUTH_SECRET}++}
          namespace: {++${YANDEX_AUTH_SECRET_NAMESPACE}++}
        templateOptions:
          platformId: {++${YANDEX_KCP_PLATFORM_ID}++}
          cores: {++${YANDEX_KCP_CORES}++}
          memory: {++${YANDEX_KCP_MEMORY}++}
          diskType: {++${YANDEX_KCP_DISK_TYPE}++}
          diskSize: {++${YANDEX_KCP_DISK_SIZE}++}
          imageId: {++${YANDEX_KCP_IMAGE_ID}++}
        privacy: {++${YANDEX_PRIVACY}++}
    network:
      podsCidrBlocks:
        - {++${SUBCLUSTER_POD_CIDR}++}
      servicesCidrBlocks:
        - {++${SUBCLUSTER_SERVICE_CIDR}++}
    kubeletExtraArgs:
      kubeReserved: ''
      systemReserved: ''
      evictionHard: ''
      evictionMinimumReclaim: ''
      evictionMaxPodGracePeriod: ''
      maxPods: ''

apiVersion: provisioning.bootsman.tech/v1alpha1
kind: WorkerPool
metadata:
  name: {++${SUBCLUSTER_WORKERPOOL_NAME}++}
  namespace: {++${SUBCLUSTER_NAMESPACE}++}
spec:
  clusterName: {++${SUBCLUSTER_NAME}++}
  kubernetesVersion: {++${SUBCLUSTER_KUBERNETES_VERSION}++}
  replicas: {++${WORKER_REPLICAS}++}
  infrastructure:
    provider: yandex
    yandexConfig:
      platformId: {++${YANDEX_WORKER_PLATFORM_ID}++}
      cores: {++${YANDEX_WORKER_CORES}++}
      memory: {++${YANDEX_WORKER_MEMORY}++}
      diskType: {++${YANDEX_WORKER_DISK_TYPE}++}
      diskSize: {++${YANDEX_WORKER_DISK_SIZE}++}
      imageId: {++${YANDEX_WORKER_IMAGE_ID}++}
      # Расскоментируйте для использования GPU. Внимание значения cores и memory нужно задать в соотвествии с документацией Yandex Cloud
      # gpus: ''
  kubeletExtraArgs:
    kubeReserved: ''
    systemReserved: ''
    evictionHard: ''
    evictionMinimumReclaim: ''
    evictionMaxPodGracePeriod: ''
    maxPods: ''