Alauda Container Platform
  • 简体中文

    • 下载软件包

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

    目录

    下载工具适用于 Linux 或 macOS适用于 Windows前提条件用法violet ac login可选标志violet ac scenarios可选标志ACP 4.4 安装和升级场景violet ac packages可选标志violet ac download-pkg可选标志violet ac download-app可选标志violet ac download-os标志violet ac import-yaml可选标志示例工作流

    下载工具

    登录到 customer portal，进入 Downloads 页面，然后单击 CLI Tools。下载与您的操作系统和架构匹配的二进制文件。

    下载完成后，将该工具安装到服务器或 PC 上。

    适用于 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 v4.2.13 或更高版本。安装二进制文件后，请验证其版本：

    violet version

    前提条件

    权限要求

    • 您必须提供有效的平台用户账户（account、username 和 password）。

    用法

    violet ac login

    在下载软件包之前，请先使用 violet ac login 命令登录平台。

    violet ac login --account=<account> --username=<username> --password=<password> --ac-url=<url>
# or provide an existing token:
violet ac login --access-token=<token> --ac-url=<url>

    可选标志

    --account         account / tenant name
--username        username
--password        password
--ac-url          AC system URL (default: `https://cloud.alauda.io`)
--access-token    directly provide an access token to skip username/password login
    Note

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

    violet ac scenarios

    列出可用的 scenarios
    输出：一个格式化表格，列出 ID、Name 和 Description。

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

    可选标志

    --arch               target architecture (`amd64` , `arm64` , `hybrid`, default: `amd64`)
--platformVersion    target platform version

    ACP 4.4 安装和升级场景

    在准备 4.4 软件包时，请使用以下 scenarios：

    场景用途
    Common ACP Extensions下载包含新 4.4 安装所需的八个 Aligned applications 以及其他 Extensions 的软件包集合。
    ACP Upgrade to v4.4在将现有环境升级到 4.4 时，下载所需的 Aligned Extension 软件包。

    将 <target-platform-version> 设置为 Core Package 的确切 ACP Distribution Version，例如 v4.4.0。将 <arch> 设置为 amd64、arm64 或 hybrid，以匹配 Core Package。

    请先列出可用 scenarios，以确认目标版本和架构已发布预期的 scenario。然后下载所需的 scenario：

    violet ac scenarios --arch=<arch> --platformVersion=<target-platform-version>

# New installation
violet ac download-app --arch=<arch> --platformVersion=<target-platform-version> --scenario="Common ACP Extensions"

# Upgrade to ACP 4.4
violet ac download-app --arch=<arch> --platformVersion=<target-platform-version> --scenario="ACP Upgrade to v4.4"

    下载 scenario 不会将其软件包添加到 Core Package 中。请解压 Core Package，并将安装或升级操作步骤所需的软件包手动复制到其 plugins/ 目录中。有关确切的应用名称和复制步骤，请参见 Download 和 Pre-Upgrade Preparation。

    violet ac packages

    列出可用软件包。
    输出：一个格式化表格，列出 APP ID、APP Name、Channel And Version 和 Package。

    # download all packages for the specified architecture, platform version, and scenario
violet ac packages --arch=<arch> --platformVersion=<version> --scenario=<scenario>
# download all packages for the specified architecture and platform version
violet ac packages --arch=<arch> --platformVersion=<version>
# download single package for a specific application ID
violet ac packages --appID=my-app

    可选标志

    --arch               target architecture (`amd64` , `arm64` , `hybrid`, default: `amd64`)
--platformVersion    target platform version
--appID              download single app for a specific application ID
--scenario           scenario filter (optional)
    Note

    关于 scenario，如果未配置，则会显示所有软件包。

    violet ac download-pkg

    下载特定架构和平台版本的软件包及其签名文件。

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

    可选标志

    --arch               target architecture (`x86` , `arm` , `hybrid`, default: `x86`)
--platformVersion    target platform version
--type               package type (`core`, `extensions`, `standard`, default: `core`)

    注意：关于 type，对于 v4.0.5 及更高版本，工具默认下载 core package — 您无需设置此选项。
    对于 v4.0.0 到 v4.0.4，默认值为 core，用于下载 core package；您可以将该选项设置为 extensions 以下载 extension packages。

    violet ac download-app

    按 scenario（批量）或通过指定 appID 和 appVersion 下载 application packages。该命令会获取下载 URL，然后下载 package 和 checksum 文件。

    violet ac download-app --arch=amd64 --platformVersion=<version> --scenario=<scenario>
# List available packages status
violet ac download-app --arch=amd64 --platformVersion=<version> --scenario=<scenario> --check=true
# or download a specific app version
violet ac download-app --arch=amd64 --appID=<app-id> --appVersion=<app-version1>,<app-version2>

    可选标志

    --arch               target architecture (`amd64` , `arm64` , `hybrid`, default: `amd64`)
--platformVersion    target platform version
--appID              specific application ID
--appVersion         application version (supports multiple versions separated by commas)
--check              If true, do not download; only check available packages status (default: `false`)
--scenario           scenario name (optional, download latest versions for the scenario)
    Note

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

    violet ac download-os

    从 AC Marketplace OS 页面下载 OS packages。请先使用 --list 查看可用的平台版本、架构和操作系统，然后下载匹配的 OS package 和 checksum 文件。

    # List all available OS package filters
violet ac download-os --list
# List OS packages for a specific platform version
violet ac download-os --platformVersion=v4.1.0 --list
# Download matching OS packages
violet ac download-os --platformVersion=v4.1.0 --arch=x86_64 --operatingSystem=ubuntu

    标志

    --platformVersion    target platform version (required when downloading)
--arch               target architecture (required when downloading)
--operatingSystem    target operating system (required when downloading)
--list               list matching OS packages without downloading (default: `false`)
    Note

    在下载之前，请使用带更少筛选条件的 --list 来发现有效的 platformVersion、arch 和 operatingSystem 值。

    violet ac import-yaml

    读取一个本地 YAML 文件（默认 ./apps.yaml，violet list 导出），其中包含一个 applications map，将其发送到 AC scenario-check endpoint，并显示验证结果。也可选择下载已验证的软件包。

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

    可选标志

    --arch               target architecture (`amd64` , `arm64` , `hybrid`, default: `amd64`)
--platformVersion    target platform version
--download           boolean; if true, attempt to download validated packages after the check
--path               path to the YAML file (default `./apps.yaml`)

    示例工作流

    • 登录并保存 token：

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

    • 列出可用 scenarios：

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

    • 下载目标版本的 core packages：

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

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

      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

    • 列出并下载 OS packages：

      violet ac download-os --platformVersion=v4.1.0 --list
violet ac download-os --platformVersion=v4.1.0 --arch=x86_64 --operatingSystem=ubuntu

    • 验证 applications YAML 并下载已验证的软件包：

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