Развёртывание и настройка Octavia

Octavia — опциональный сервис балансировки нагрузки (LBaaS) в KeyStack. Он распределяет входящий трафик между серверами приложения и обеспечивает отказоустойчивость. По умолчанию сервис отключён и развёртывается средствами LCM. Объекты балансировки, особенности работы сервиса и операции управления описаны в разделе Администрирование Octavia.

Развёртывание и настройку сервиса выполняет администратор платформы.

Для включения Octavia необходим доступ к репозиторию региона project_k / deployments / <имя региона> в GitLab и права на запуск пайплайнов.

Включение Octavia

Для включения Octavia в регионе выполните следующие действия:

  1. Убедитесь, что в регионе настроена система мониторинга Prometheus или VictoriaMetrics. По умолчанию используется VictoriaMetrics. Если мониторинг ещё не настроен, выполните инструкцию Настройка мониторинга и аудита региона.

  2. Подготовьте образ служебной виртуальной машины Amphora и загрузите его в Glance согласно разделу Создание образа из файла. Собрать образ можно по официальной инструкции OpenStack Octavia (скрипт diskimage-create.sh). Проверьте требования к образу:

    • образ имеет тег amphora (параметр octavia_amp_image_tag, по умолчанию: amphora);

    • владелец образа (owner) совпадает с проектом, заданным в amp_image_owner_id конфигурации Octavia (как правило, служебный проект service). Публичной видимости образа (--public) недостаточно.

    Служебную сеть управления Amphora, группы безопасности и тип виртуальной машины создаёт LCM при развёртывании Octavia. Создавать их вручную не требуется. Подробнее об Amphora см. в разделе Особенности работы Octavia в KeyStack.

  3. Войдите в GitLab и перейдите в репозиторий региона project_k / deployments / <имя региона>.

  4. Проверьте, что в файле globals.d/octavia.yml задан параметр octavia_amp_network_cidr — IP-префикс служебной подсети управления Amphora. Как правило, параметр уже настроен на этапе создания региона (см. Создание региона). Если параметра нет, задайте его.

    Эта подсеть используется компонентами Octavia для связи с Amphora. Подсети для VIP и серверов приложения подготавливаются отдельно при создании балансировщика.

  5. Откройте файл globals.d/REGION.yml и укажите в нём:

    enable_octavia: "yes"
    

    Если планируется настройка TLS-терминации, включите Barbican для хранения сертификата и закрытого ключа:

    enable_barbican: "yes"
    
  6. Создайте новый пайплайн: Build > Pipelines > New Pipeline.

  7. В открывшемся окне добавьте переменную KOLLA_ARGS со значением, соответствующим системе мониторинга региона:

    • для VictoriaMetrics — -t octavia,prometheus,victoriametrics;

    • для Prometheus — -t octavia,prometheus.

    Тег prometheus необходим в обоих случаях для настройки сбора метрик Octavia. Если вместе с Octavia вы включаете Barbican, добавьте в переменную KOLLA_ARGS тег barbican: -t octavia,barbican,prometheus,victoriametrics.

  8. Запустите пайплайн New pipeline.

  9. Дождитесь успешного завершения задачи setup.

  10. Запустите задачу deploy и дождитесь завершения её выполнения.

Проверка развёртывания

После успешного завершения пайплайна проверьте работу Octavia:

  1. Подключитесь к Control- и Network-узлам региона и проверьте, что контейнеры Octavia запущены и находятся в статусе healthy:

    $ {docker|podman} ps --format "{{.Names}}\t{{.Status}}" | grep octavia
    

    При ошибках просмотрите журналы Octavia.

  2. Подключитесь к KOC, используя инструкцию, приведённую в разделе Настройка и использование KOC CLI. Убедитесь, что клиент содержит команды Octavia:

    $ ./koc help loadbalancer
    
  3. Создайте тестовый HTTP-балансировщик согласно разделу Создание балансировщика. Проверьте, что его provisioning_status стал ACTIVE (см. Диагностика и мониторинг состояния балансировщика), а затем проверьте прохождение HTTP-запросов согласно разделу Проверка прохождения трафика.

  4. Проверьте метрики Octavia в Grafana либо выполните на Control-узле команду:

    $ curl -sk https://<kolla_internal_fqdn>:9198/metrics | grep openstack_loadbalancer
    

    Ответ OpenStack Exporter подтверждает, что метрики доступны для сбора. Наличие актуальных метрик в Grafana дополнительно подтверждает их сбор системой мониторинга.

    В выводе должны присутствовать метрики openstack_loadbalancer_total_loadbalancers и openstack_loadbalancer_loadbalancer_status. Убедитесь, что они отражают наличие и состояние созданного тестового балансировщика. Полный перечень метрик приведён в разделе Просмотр метрик.

  5. После проверки удалите тестовый балансировщик, если он больше не нужен (см. Удаление балансировщика).

В результате в регионе будут запущены компоненты Octavia и настроен сбор метрик. Служебные виртуальные машины Amphora создаются при создании балансировщиков. Дальнейшее управление балансировщиками описано в разделе Администрирование Octavia.