Установка

В этом разделе описаны конкретные шаги по установке кластера 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 ГБ свободного места на диске. Пожалуйста, обеспечьте достаточные ресурсы хранения.
  • Если вы загрузили Extensions Package, распакуйте его и ознакомьтесь с документацией, включённой в пакет, перед переходом к следующим шагам.

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

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

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

bash setup.sh
WARNING

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

Режим сети и IP-семейство

bash setup.sh --network-mode calico

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

bash setup.sh --ip-family ipv6

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

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

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

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

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

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

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

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

# Проверка наличия неудачных Charts
kubectl get apprelease --all-namespaces
# Проверка наличия неудачных Pod
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 Version

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

Cluster Network Protocol

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

Cluster Address

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

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

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

Platform Access Address

    Если нет необходимости различать Cluster Address и Platform Access Address, введите тот же адрес, что и в Cluster Address.
    Если различие необходимо, например, если кластер global предназначен только для внутреннего доступа, а платформа должна обеспечивать внешний доступ, введите заранее подготовленное доменное имя или External IP.
    По умолчанию платформа использует HTTPS и не включает HTTP. Если требуется включить HTTP, сделайте это в Advanced Settings (не рекомендуется).
    Примечание: Доменное имя обязательно в следующих случаях,

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

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

Certificate

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

Image Repository

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

Container Network

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

Node Name

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

global Cluster Platform Node Isolation

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

  • Узлы можно настроить как Platform Exclusive, то есть запускать только компоненты платформы, обеспечивая изоляцию платформенных и прикладных рабочих нагрузок;
  • Исключаются рабочие нагрузки типа DaemonSet.
Add NodeУзел управляющей плоскости:
    • Поддерживается добавление 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