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

    Содержание

    Глоссарий

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