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

    Содержание

    Глоссарий

    ТерминОпределение
    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