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

    Глоссарий

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