#Инфраструктурные ресурсы для Huawei DCS

#Обзор

Перед созданием кластеров в Huawei DCS необходимо настроить инфраструктурные ресурсы, включая облачные учетные данные, IP-пулы и шаблоны машин.

Управлять инфраструктурными ресурсами можно через веб-интерфейс или с помощью YAML-манифестов. Веб-интерфейс предоставляет пошаговый интерфейс с проверкой данных, а YAML обеспечивает возможности автоматизации.

#Облачные учетные данные

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

#Использование веб-интерфейса

#Предварительные требования

Перед созданием облачных учетных данных проверьте следующие требования платформы DCS:

Конфигурация пользователя:

• Тип пользователя: должен быть Interface interconnection user
• Роль: должна быть administrator

Политика паролей: Перейдите в System Management → Rights Management → Rights Management Policy и проверьте:

• Политика: Whether to modify the password of an interface interconnection user upon password resetting and first login
• Значение: должно быть установлено в No

Если установлено значение Yes, пароль пользователя будет принудительно изменен при первом входе в систему, что нарушит аутентификацию и приведет к сбоям при создании кластера.

#Создание облачных учетных данных

Путь: Clusters → Cloud Credentials → Create Cloud Credential → Select Huawei DCS

Поля формы:

Правила проверки:

• Name должен содержать от 1 до 63 символов, только строчные буквы, цифры и дефисы, а также начинаться и заканчиваться буквой или цифрой
• DCS Endpoint должен иметь корректный формат URL и начинаться с http:// или https://

#Управление облачными учетными данными

Просмотр учетных данных: Перейдите в Clusters → Cloud Credentials, чтобы просмотреть все настроенные учетные данные с их типом, временем создания и автором.

Обновление учетных данных: Нажмите Update для учетных данных, чтобы изменить Display Name. Обновление пароля в текущей версии не поддерживается (планируется в будущем выпуске).

Удаление учетных данных: Нажмите Delete, чтобы удалить учетные данные. Подтвердите удаление в диалоговом окне.

#Использование YAML

Создайте ресурс Secret для хранения информации аутентификации DCS:

apiVersion: v1
data:
  authUser: <base64-encoded-auth-user>
  authKey: <base64-encoded-auth-key>
  endpoint: <base64-encoded-endpoint>
kind: Secret
metadata:
  name: <auth-secret-name>
  namespace: cpaas-system
type: Opaque

Описание параметров:

Пример:

# Encode credentials
echo -n "admin" | base64
echo -n "your-password" | base64
echo -n "https://dcs.example.com:7443" | base64

# Apply the Secret
kubectl apply -f dcs-secret.yaml -n cpaas-system

#IP-пулы

IP-пулы определяют сетевую конфигурацию (IP-адреса, маски подсети, шлюзы, DNS) для узлов кластера. Каждый пул может содержать несколько записей узлов, а каждый узел может иметь несколько конфигураций сетевых интерфейсов.

#Использование веб-интерфейса

#Предварительные требования

• Облачные учетные данные созданы

#Создание IP-пула

Путь: Clusters → Virtual Machine → IP Pools → Create IP Pool → Select Credential

Структура формы:

Форма IP Pool состоит из списка Pools. Каждый Pool представляет один узел и содержит:

1. Node IP (обязательно, ровно один на Pool)
2. Additional NIC IPs (необязательно, несколько на Pool)

Поля Node IP:

Поля Additional NIC IPs:

Правила проверки:

• IP-адреса должны быть уникальны в пределах одного IP Pool
• IP-адреса должны иметь корректный формат IPv4
• Маска подсети должна иметь корректный формат
• IP-адрес должен находиться в пределах настроенного диапазона подсети
• Шлюз должен быть корректным адресом IPv4 в пределах диапазона подсети

Советы:

• Необходимо указать как минимум одну запись узла
• Для каждого узла требуется ровно одна конфигурация Node IP
• Additional NIC IPs необязательны для сценариев с несколькими NIC (например, для разделения сети хранения)

#Управление IP-пулами

Просмотр пулов: Перейдите в Clusters → Virtual Machine → IP Pools, чтобы просмотреть все настроенные пулы с их IP-адресами узлов и временем создания.

Обновление пулов: Нажмите Update, чтобы добавить или удалить записи узлов и изменить сетевые конфигурации.

Удаление пулов: Нажмите Delete, чтобы удалить пул. Подтвердите удаление в диалоговом окне.

#Использование YAML

Создайте ресурс DCSIpHostnamePool:

apiVersion: infrastructure.cluster.x-k8s.io/v1beta1
kind: DCSIpHostnamePool
metadata:
  name: <iphostname-pool-name>
  namespace: cpaas-system
spec:
  pool:
  - ip: "<ip-1>"
    mask: "<mask>"
    gateway: "<gateway>"
    dns: "<dns>"
    hostname: "<hostname-1>"
    machineName: "<machine-name-1>"
  - ip: "<ip-2>"
    mask: "<mask>"
    gateway: "<gateway>"
    dns: "<dns>"
    hostname: "<hostname-2>"
    machineName: "<machine-name-2>"
  - ip: "<ip-3>"
    mask: "<mask>"
    gateway: "<gateway>"
    dns: "<dns>"
    hostname: "<hostname-3>"
    machineName: "<machine-name-3>"

Описание параметров:

#Шаблоны машин

Шаблоны машин определяют характеристики виртуальной машины (шаблон ВМ, CPU, память, диск, сеть) для узлов кластера. Каждый шаблон машины имеет Type, который определяет его назначение:

• Control Plane: для узлов control plane
• Worker Node: для worker-узлов

#Использование веб-интерфейса

#Предварительные требования

• IP Pool создан
• VM Template создан на платформе DCS с использованием образа MicroOS
• YAML файла ConfigMap применен к глобальному кластеру

VM Template и ConfigMap:

Каждый выпуск MicroOS включает YAML-файл ConfigMap, который сопоставляет VM templates с версиями Kubernetes. Примените этот YAML перед созданием шаблонов машин:

apiVersion: v1
data:
  corednsTag: 1.12.4-v4.2.3
  etcdTag: v3.5.21-251117
  kubernetesVersion: v1.33.6
  vmImageVersion: MicroOS-5.5-v4.2.0
kind: ConfigMap
metadata:
  labels:
    cpaas.io/dcs-vm-template: microos5.5-4.2.0
    cpaas.io/distribution-version: v4.2.0
    cpaas.io/kubernetes-version: v1.33
  name: 420-dcs-vm-template
  namespace: cpaas-system

Важно: Значение метки cpaas.io/dcs-vm-template должно совпадать с именем VM template на платформе DCS.

#Создание шаблона машины

Путь: Clusters → Virtual Machine → Machine Templates → Create Machine Template → Select Credential

Поля формы:

Конфигурация дисков:

Конфигурация дисков зависит от типа шаблона.

Обязательные диски для Control Plane:

Обязательные диски для Worker Node:

Вы можете добавить дополнительные диски, но все обязательные диски, перечисленные выше, должны быть сохранены.

Описание полей диска:

Совет по выбору VM Template:

#Управление шаблонами машин

Просмотр шаблонов: Перейдите в Clusters → Virtual Machine → Machine Templates, чтобы просмотреть все шаблоны с их VM Template Name, Resource, Location, Specs и IP Pool.

Обновление шаблонов: Нажмите Update, чтобы изменить параметры. Обратите внимание, что поле Name нельзя изменить после создания.

Удаление шаблонов: Нажмите Delete, чтобы удалить шаблон. Подтвердите удаление в диалоговом окне.

#Использование YAML

Создайте ресурс DCSMachineTemplate:

apiVersion: infrastructure.cluster.x-k8s.io/v1beta1
kind: DCSMachineTemplate
metadata:
  name: <machine-template-name>
  namespace: cpaas-system
spec:
  template:
    spec:
      vmTemplateName: <vm-template-name>
      location:
        type: folder
        name: <folder-name>
      resource: # Optional, if not specified, uses template defaults
        type: cluster # cluster | host
        name: <cluster-name>
      vmConfig:
        dvSwitchName: <dv-switch-name> # Optional
        portGroupName: <port-group-name> # Optional
        dcsMachineCpuSpec:
          quantity: <cpu-cores>
        dcsMachineMemorySpec: # MB
          quantity: <memory-mb>
        dcsMachineDiskSpec: # GB
        - quantity: 0
          datastoreClusterName: <datastore-cluster-name>
          systemVolume: true
        - quantity: 10
          datastoreClusterName: <datastore-cluster-name>
          path: /var/lib/etcd
          format: xfs
        - quantity: 100
          datastoreClusterName: <datastore-cluster-name>
          path: /var/lib/kubelet
          format: xfs
        - quantity: 100
          datastoreClusterName: <datastore-cluster-name>
          path: /var/lib/containerd
          format: xfs
        - quantity: 40
          datastoreClusterName: <datastore-cluster-name>
          path: /var/cpaas
          format: xfs
      ipHostPoolRef:
        name: <iphostname-pool-name>

Описание параметров:

*Обязательно, если указано родительское поле

#Связи между ресурсами

Инфраструктурные ресурсы имеют следующие зависимости:

Cloud Credential
    ↓
IP Pool
    ↓
Machine Template → references IP Pool
    ↓
Cluster Creation

Повторное использование ресурсов:

• Одни Cloud Credential можно использовать для нескольких кластеров
• Можно создать несколько IP Pool для разных сетевых сегментов
• Можно создать несколько Machine Template для разных типов узлов и спецификаций

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

После настройки инфраструктурных ресурсов:

• Создать кластер
• Управлять пулами узлов
• Обновить кластеры