Установка оператора

Содержание

Глоссарий

ТерминОпределение
operator packageСжатый пакет в формате tgz, содержащий образы и конфигурационные файлы
upload toolИсполняемый файл, используемый для разбора operator package и импорта/загрузки на платформу
operation machineМашина, используемая для выполнения операций установки
working directoryКаталог, в котором хранятся operator package и upload tool

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

  1. Подготовьте машину для операций с Windows, Linux или macOS, которая имеет доступ к платформе. Рекомендуется Linux, и в дальнейшем инструкции приведены на примере Linux.
  2. Убедитесь, что машина для операций имеет доступ к platform.
  3. Скачайте operator package и сохраните его в рабочем каталоге на машине для операций.
  4. Для установки оператора требуются права администратора.

Получение Upload Tool

В разделе Platform Management -> Marketplace -> Upload Packages скачайте upload tool (violet). После загрузки установите соответствующие права на выполнение.

Загрузка оператора

Независимо от того, импортируете ли вы нового оператора или добавляете новую версию к существующему оператору, вы можете использовать инструмент violet для выполнения задачи, команды при этом одинаковы.

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

./violet push \
    <operator-package> \
    --platform-address <platform-address> \
    --platform-username <platform-username> \
    --platform-password <platform-password> \
    --clusters <clusters>
  1. Запустите инструмент violet для загрузки operator package на платформу.
  2. <operator-package>: Имя operator package (пример: operator.4.0.1.ALL.tgz).
  3. <platform-address>: URL-адрес платформы (пример: https://platform.example.com).
  4. <platform-username>: Имя пользователя платформы, требуются права администратора платформы.
  5. <platform-password>: Пароль пользователя платформы.
  6. <clusters>: Список кластеров, в которые необходимо загрузить оператора, разделённых запятой (пример: global,business).

После успешного выполнения будет выведена следующая информация:

INFO[0024] artifactversion <operator-name>.<operator-version> not found, create it  cluster=business type=bundle
INFO[0024] artifactversion <operator-name>.<operator-version> has been created successfully  cluster=business type=bundle

Затем перейдите на страницу Platform Management -> Marketplace -> Upload Packages платформы, введите ключевое слово оператора в поиск и нажмите на имя оператора для перехода на страницу с деталями оператора.

На странице деталей будет отображена новая версия оператора. Если статус Uploaded, это означает, что загрузка прошла успешно.

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

После загрузки оператора вы можете перейти на страницу Platform Management -> Marketplace -> Operator Hub, выбрать целевой кластер и развернуть соответствующий оператор.

Устранение неполадок

Загрузка пакета в внешний реестр образов

Если вы хотите загрузить operator package во внешний реестр образов, используйте следующие параметры:

ПараметрОпределениеПример
--dst-repoАдрес целевого реестра--dst-repo registry.example.com
--usernameИмя пользователя целевого реестра--username admin
--passwordПароль целевого реестра--password *******

Например:

./violet push \
    <operator-package> \
    --platform-address <platform-address> \
    --platform-username <platform-username> \
    --platform-password <platform-password> \
    --clusters <clusters> \
    --dst-repo <dst-repo> \
    --username <username> \
    --password <password>

Если целевой реестр образов использует протокол plaintext (http), необходимо указать дополнительный параметр --plain следующим образом:

./violet push \
    ... \
    --dst-repo <dst-repo> \
    --username <username> \
    --password <password> \
    --plain