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

Платформа предоставляет инструмент командной строки violet, который используется для загрузки пакетов с платформы.

#Загрузка инструмента

Войдите в Customer Portal, перейдите на страницу Downloads и нажмите CLI Tools. Скачайте бинарный файл, соответствующий вашей операционной системе и архитектуре.

После загрузки установите инструмент на ваш сервер или ПК.

#Для Linux или macOS

Для пользователей без прав root:

# Linux x86
sudo mv -f violet_linux_amd64 /usr/local/bin/violet && sudo chmod +x /usr/local/bin/violet
# Linux ARM
sudo mv -f violet_linux_arm64 /usr/local/bin/violet && sudo chmod +x /usr/local/bin/violet
# macOS x86
sudo mv -f violet_darwin_amd64 /usr/local/bin/violet && sudo chmod +x /usr/local/bin/violet
# macOS ARM
sudo mv -f violet_darwin_arm64 /usr/local/bin/violet && sudo chmod +x /usr/local/bin/violet

Для пользователей с правами root:

# Linux x86
mv -f violet_linux_amd64 /usr/bin/violet && chmod +x /usr/bin/violet
# Linux ARM
mv -f violet_linux_arm64 /usr/bin/violet && chmod +x /usr/bin/violet
# macOS x86
mv -f violet_darwin_amd64 /usr/bin/violet && chmod +x /usr/bin/violet
# macOS ARM
mv -f violet_darwin_arm64 /usr/bin/violet && chmod +x /usr/bin/violet

#Для Windows

1. Скачайте файл и переименуйте его в violet.exe, либо используйте PowerShell для переименования:

   # Windows x86
   mv -Force violet_windows_amd64.exe violet.exe

2. Запустите инструмент в PowerShell.

Примечание: Если путь к инструменту не добавлен в переменные окружения, при выполнении команд необходимо указывать полный путь.

#Требования

Требования к разрешениям

• Необходимо предоставить действующую учетную запись пользователя платформы (аккаунт, имя пользователя и пароль).

#Использование

#violet ac login

Перед загрузкой пакетов выполните команду violet ac login для входа на платформу.

violet ac login --account=<account> --username=<username> --password=<password> --ac-url=<url>
# или используйте существующий токен:
violet ac login --access-token=<token> --ac-url=<url>

#Дополнительные параметры

--account         аккаунт / имя арендатора
--username        имя пользователя
--password        пароль
--ac-url          URL системы AC (по умолчанию: `https://cloud.alauda.io`)
--access-token    напрямую указать токен доступа, чтобы пропустить вход по имени пользователя и паролю

#violet ac scenarios

Список доступных сценариев
Вывод: Отформатированная таблица с колонками ID, Name и Description.

violet ac scenarios --arch=amd64 --platformVersion=v4.1 --upgrade=true

#Дополнительные параметры

--arch               целевая архитектура (`amd64` , `arm64` , `hybrid`, по умолчанию: `amd64`)
--platformVersion    целевая версия платформы
--upgrade            булевый флаг для фильтрации сценариев, связанных с обновлением (по умолчанию: `false`)

Примечание: Флаг --upgrade требуется только при обновлении с ACP 3.x до ACP 4.x. Для ACP 4.x и выше этот флаг не обязателен.

#violet ac packages

Список доступных пакетов.
Вывод: Отформатированная таблица с колонками APP ID, APP Name, Channel And Version и Package.

# загрузить все пакеты для указанной архитектуры, версии платформы и сценария
violet ac packages --arch=<arch> --platformVersion=<version> --scenario=<scenario>
# загрузить все пакеты для указанной архитектуры и версии платформы
violet ac packages --arch=<arch> --platformVersion=<version>
# загрузить один пакет для конкретного ID приложения
violet ac packages --appID=my-app

#Дополнительные параметры

--arch               целевая архитектура (`amd64` , `arm64` , `hybrid`, по умолчанию: `amd64`)
--platformVersion    целевая версия платформы
--appID              загрузить один пакет для конкретного ID приложения
--scenario           фильтр по сценарию (необязательно)

#violet ac download-pkg

Загрузка пакетов и их файлов подписи для конкретной архитектуры и версии платформы.

violet ac download-pkg --arch=x86 --platformVersion=v4.1.0 --type=core

#Дополнительные параметры

--arch               целевая архитектура (`x86` , `arm` , `hybrid`, по умолчанию: `x86`)
--platformVersion    целевая версия платформы
--type               тип пакета (`core`, `extensions`, `standard`, по умолчанию: `core`)

Примечание: По поводу type, для версий v4.0.5 и выше инструмент по умолчанию загружает core-пакет — указывать эту опцию не нужно.
Для версий с v4.0.0 по v4.0.4 по умолчанию загружается core-пакет; можно указать extensions для загрузки расширений.

#violet ac download-app

Загрузка пакетов приложений по сценарию (пакетно) или по указанию appID и appVersion. Команда получает URL для загрузки, затем скачивает пакет и файлы контрольных сумм.

violet ac download-app --arch=amd64 --platformVersion=<version> --scenario=<scenario>
# Просмотр статуса доступных пакетов
violet ac download-app --arch=amd64 --platformVersion=<version> --scenario=<scenario> --check=true
# или загрузка конкретной версии приложения
violet ac download-app --arch=amd64 --appID=<app-id> --appVersion=<app-version1>,<app-version2>

#Дополнительные параметры

--arch               целевая архитектура (`amd64` , `arm64` , `hybrid`, по умолчанию: `amd64`)
--platformVersion    целевая версия платформы
--appID              конкретный ID приложения
--appVersion         версия приложения (поддерживается несколько версий через запятую)
--check              если true, не загружать, а только проверить статус доступных пакетов (по умолчанию: `false`)
--scenario           имя сценария (необязательно, загрузка последних версий для сценария)

#violet ac import-yaml

Чтение локального YAML-файла (по умолчанию ./apps.yaml, экспорт из violet list), содержащего карту applications, отправка его в endpoint проверки сценария AC и отображение результатов валидации. Опционально загрузка проверенных пакетов.

violet ac import-yaml --arch=amd64 --platformVersion=v4.1.3 --download=true

#Дополнительные параметры

--arch               целевая архитектура (`amd64` , `arm64` , `hybrid`, по умолчанию: `amd64`)
--platformVersion    целевая версия платформы
--download           булево значение; если true, попытаться загрузить проверенные пакеты после проверки
--path               путь к YAML-файлу (по умолчанию `./apps.yaml`)

#Примеры рабочих процессов

• Вход и сохранение токена:

  violet ac login --account=tenantA --username=admin --password=password --ac-url=https://ac.example.com

• Список доступных сценариев:

  violet ac scenarios --arch=amd64 --platformVersion=v4.1

• Загрузка core-пакетов целевой версии:

  violet ac download-pkg --arch=x86 --platformVersion=v4.1.0

• Список доступных пакетов и загрузка последней версии для сценария:

  violet ac download-app --arch=amd64 --platformVersion=v4.1.0 --scenario=my-scenario

• Просмотр статуса пакетов ('Downloaded' или 'Download Failed'):

  violet ac download-app --arch=amd64 --platformVersion=v4.1.0 --scenario=my-scenario --check=true

• Валидация YAML приложений и загрузка проверенных пакетов:

  violet ac import-yaml --arch=amd64 --platformVersion=v4.1.0 --download=true --path=./apps.yaml