Установка

В этом разделе описаны конкретные шаги по установке кластера global.

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

Содержание

Процесс

Загрузка и распаковка установочного пакета

Загрузите установочный пакет Core Package на любую машину из узлов управляющей плоскости кластера global и распакуйте его с помощью следующей команды:

# Предполагается, что папка /root/cpaas-install уже существует на машине
tar -xvf {Path to Core Package File}/{Core Package File Name} -C /root/cpaas-install
cd /root/cpaas-install/installer || exit 1
INFO
  • Эта машина станет первым узлом управляющей плоскости после завершения установки кластера global.
  • После распаковки Core Package требуется не менее 100 ГБ свободного места на диске. Пожалуйста, обеспечьте достаточные ресурсы хранения.
  • Если вы уже загрузили расширения, сначала завершите установку ACP Core, а затем следуйте разделу Extend для их загрузки и установки.

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

Выполните следующий скрипт установки для запуска установщика. После успешного запуска установщика в терминале будет выведен адрес доступа к веб-консоли.

Через примерно 5 минут вы сможете использовать браузер на вашем ПК для доступа к веб-консоли, предоставляемой установщиком.

bash setup.sh
WARNING

Убедитесь, что IP-адрес и порт 8080 узла, на котором находится установщик, доступны, чтобы обеспечить корректный доступ к веб-консоли после успешного запуска установщика.

Сетевой режим и IP-семейство

bash setup.sh --network-mode calico

Параметр --network-mode влияет на CNI создаваемого установщиком кластера global. Если параметр не указан, CNI кластера по умолчанию будет Kube-OVN. Если требуется Calico в качестве CNI, необходимо явно указать --network-mode calico.

bash setup.sh --ip-family ipv6

Если вы планируете создать кластер global с Single-stack Network IPv6, необходимо явно указать --ip-family ipv6 при запуске установщика. Без этого параметра создаваемый кластер будет поддерживать Single-stack Network IPv4 и Dual-stack Network по умолчанию.

Конфигурация параметров

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

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

Проверка успешной установки

После завершения установки на странице будет отображён адрес доступа к платформе. Нажмите кнопку Access, чтобы перейти в веб-интерфейс платформы.

В представлении Administrator последовательно выберите Cluster Management > Clusters и найдите кластер с именем global.

В выпадающем меню справа выберите CLI Tools и выполните следующие команды для проверки статуса установки:

# Проверка наличия неудачных Charts
kubectl get apprelease --all-namespaces
# Проверка наличия неудачных Pods
kubectl get pod --all-namespaces | awk '{if ($4 != "Running" && $4 != "Completed")print}' | awk -F'[/ ]+' '{if ($3 != $4)print}'

Установка плагина Product Docs

INFO

Плагин Alauda Container Platform Product Docs обеспечивает доступ к документации продукта внутри платформы. Все ссылки на помощь в платформе будут вести к этой документации. Если плагин не установлен, при нажатии на ссылки помощи в платформе будет возникать ошибка 404.

  1. Перейдите в раздел Administrator.

  2. В левой боковой панели выберите Marketplace > Cluster Plugins и выберите кластер global.

  3. Найдите плагин Alauda Container Platform Product Docs и нажмите Install.

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

ПараметрОписание
Версия Kubernetes

Все опциональные версии тщательно протестированы на стабильность и совместимость.
Рекомендация: Выбирайте последнюю версию для оптимальных возможностей и поддержки.

Протокол сети кластера

Поддерживаются три режима: IPv4 single stack, IPv6 single stack, IPv4/IPv6 dual stack.
Примечание: Если выбран режим dual stack, убедитесь, что на всех узлах корректно настроены IPv6-адреса; протокол сети нельзя изменить после настройки.

Адрес кластера

    Введите заранее подготовленное доменное имя. Если доменное имя отсутствует, введите заранее подготовленный global VIP.
    Self-Built VIP по умолчанию отключён, включайте его только если вы не предоставили LoadBalancer. После включения установщик автоматически развернёт keepalived для обеспечения программной балансировки нагрузки.
    Примечание: При использовании Self-Built VIP должны быть выполнены следующие условия,

    • Доступен используемый VRID;
    • Сетевая инфраструктура хоста поддерживает протокол VRRP;
    • Все узлы управляющей плоскости и VIP находятся в одной подсети.

    Совет: Для одноузловых развертываний в сценариях ознакомления можно напрямую ввести IP узла. Нет необходимости включать Self-Built VIP или готовить сетевые ресурсы, такие как global VIP.

Адрес доступа к платформе

    Если нет необходимости различать Адрес кластера и Адрес доступа к платформе, введите тот же адрес, что и в Адресе кластера.
    Если необходимо различать, например, если кластер global предназначен только для внутреннего доступа, а платформа должна обеспечивать внешний доступ, введите заранее подготовленное доменное имя или Внешний IP.
    По умолчанию платформа использует HTTPS и не включает HTTP. Если требуется включить HTTP, активируйте его в Расширенных настройках (не рекомендуется).
    Примечание: В следующих случаях необходимо ввести доменное имя,

    • Планируется план аварийного восстановления кластера global;
    • Платформа должна поддерживать доступ по IPv6.

    Совет: Если нужно настроить дополнительные адреса доступа к платформе, их можно добавить в разделе Другие настройки > Другие адреса доступа к платформе на следующем шаге. Или после установки добавить их в управлении платформой согласно руководству пользователя.

Сертификат

Платформа по умолчанию предоставляет самоподписанные сертификаты для поддержки HTTPS-доступа.
Если требуется использовать собственный сертификат, можно загрузить существующий.

Репозиторий образов

По умолчанию используется репозиторий образов Platform Deployment, содержащий образы всех компонентов.
Если необходимо использовать Внешний репозиторий образов, обратитесь в техническую поддержку для получения плана синхронизации образов перед настройкой.

Сеть контейнеров

Подсеть по умолчанию и сегмент сети Service кластера не должны пересекаться.
При использовании оверлейной сети Kube-OVN убедитесь, что сеть контейнеров и сеть хоста находятся в разных сетевых сегментах, иначе возможны сетевые сбои.

Имя узла

Если выбран параметр Host Name as Node Name, убедитесь, что имена хостов всех узлов уникальны.

Изоляция узлов платформы кластера global

Включайте только если планируете запускать рабочие нагрузки приложений в кластере global.
После включения:

  • Узлы можно настроить как Platform Exclusive, то есть запускать только компоненты платформы, обеспечивая изоляцию платформенных и прикладных рабочих нагрузок;
  • Исключаются рабочие нагрузки типа DaemonSet.
Добавление узлаУзел управляющей плоскости:
    • Поддерживается добавление 1 или 3 узлов управляющей плоскости (3 для конфигурации высокой доступности);
    • Если включён Platform Exclusive, параметр Deployable Applications принудительно отключается, и узлы управляющей плоскости запускают только компоненты платформы;
    • Если Platform Exclusive отключён, можно выбрать, включать ли Deployable Applications, позволяя узлам управляющей плоскости запускать рабочие нагрузки приложений.
Рабочий узел:
    • Если включён Platform Exclusive, параметр Deployable Applications принудительно отключается;
    • Если Platform Exclusive отключён, параметр Deployable Applications принудительно включается.

При использовании Kube-OVN можно указать сетевой интерфейс узла, введя имя шлюза.

Если проверка доступности узла не прошла, пожалуйста, скорректируйте настройки согласно подсказкам на странице и попробуйте добавить узел снова.

Очистка установщика

Обычно установщик удаляется автоматически после установки. Если установщик не удалился автоматически в течение 30 минут после установки, выполните следующую команду на узле, где находится установщик, чтобы принудительно удалить контейнер установщика:

docker rm -f minialauda-control-plane