• Русский
  • Установка

    В этом разделе описаны конкретные шаги по установке кластера 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 по умолчанию.

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

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

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

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

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

    Далее выполните следующие команды на узле установки для проверки статуса установки:

    # Проверка наличия неудачных Charts
    kubectl get apprelease --all-namespaces
    # Проверка наличия Pod, не находящихся в статусе Running или Completed
    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-адреса; протокол сети нельзя изменить после настройки.

    Endpoint кластера

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

      При использовании Self-built VIP должны быть выполнены следующие условия:

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

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

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

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

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

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

    Сертификат

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

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

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

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

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

    Имя узла

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

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

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

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

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

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

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

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

    docker rm -f minialauda-control-plane

    Дополнительные ресурсы