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

Содержание

Глоссарий

ТерминОпределение
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>: Имя пользователя платформы, требуются права Platform Administrator.
  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