Alauda Container Platform
  • 简体中文

    • 下载软件包

    平台提供了一个命令行工具 violet，用于从平台下载软件包。

    目录

    下载工具Linux 或 macOSWindows前提条件使用方法violet ac login可选参数violet ac scenarios可选参数violet ac packages可选参数violet ac download-pkg可选参数violet ac download-app可选参数violet ac import-yaml可选参数示例工作流程

    下载工具

    登录 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          AC 系统 URL（默认：`https://cloud.alauda.io`）
--access-token    直接提供访问令牌，跳过用户名/密码登录
    注意

    您可以从 Customer Portal - Settings 导出访问令牌。访问令牌的有效期为登录成功后 24 小时内。

    violet ac scenarios

    列出可用场景
    输出：格式化表格，列出 ID、Name 和 Description。

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

    可选参数

    --arch               目标架构（`amd64`，`arm64`，`hybrid`，默认：`amd64`）
--platformVersion    目标平台版本
--upgrade            布尔标志，用于筛选升级相关场景（默认：`false`）

    注意：仅在从 ACP 3.x 升级到 ACP 4.x 时需要 --upgrade 参数。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           场景筛选（可选）
    注意

    关于 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 及以后版本，工具默认下载核心包，无需设置此选项。
    对于 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           场景名称（可选，下载该场景的最新版本）
    注意

    关于 scenario，如果未配置，则下载所有软件包。

    violet ac import-yaml

    读取本地 YAML 文件（默认 ./apps.yaml，由 violet list 导出），该文件包含 applications 映射，发送到 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

    • 下载目标版本核心软件包：

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

    • 列出可用软件包并下载某场景的最新版本：

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

    • 列出软件包状态（“已下载”或“下载失败”）：

      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