Alauda Container Platform

Download Packages

The platform provides a command-line tool violet, which is used to download packages from the platform.

TOC

Download the Tool

Log in to the Customer Portal, navigate to the Downloads page, and click CLI Tools. Download the binary that matches your operating system and architecture.

After downloading, install the tool on your server or PC.

For Linux or macOS

For non-root users:

# 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

For root users:

# 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

For Windows

  1. Download the file and rename it to violet.exe, or use PowerShell to rename it:

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

  2. Run the tool in PowerShell.

Note: If the tool path is not added to your environment variables, you must specify the full path when running commands.

Prerequisites

Permission requirements

  • You must provide a valid platform user account (account, username and password).

Usage

violet ac login

Before downloading packages, use the violet ac login command to log in platform.

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>

Optional Flags

--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: You can export an access token from the AC settings.

violet ac scenarios

List available scenarios
Output: A formatted table listing ID, Name and Description.

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

Optional Flags

--arch               target architecture (`amd64` , `arm64` , `hybrid`, default: `amd64`)
--platformVersion    target platform version
--upgrade            boolean flag to filter for upgrade-related scenarios (default: `false`)

Note: The --upgrade flag is required only when upgrading from ACP 3.x to ACP 4.x. For ACP 4.x and later, this flag is not required.

violet ac packages

List available packages.
Output: A formatted table listing APP ID, APP Name, Channel And Version and 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

Optional Flags

--arch               target architecture (`amd64` , `arm64` , `hybrid`, default: `amd64`)
--platformVersion    target platform version
--scenario           scenario filter (optional, If not configured, all packages are downloaded.)
--appID              download single app for a specific application ID

violet ac download-pkg

Download packages and their signature files for a specific architecture and platform version.

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

Optional Flags

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

Note: About type, For versions v4.0.5 and later, the tool downloads the core package by default — you do not need to set this option.
For v4.0.0 through v4.0.4, the default is core to download the core package; you can set the option to extensions to download extension packages.

violet ac download-app

Download application packages either by scenario (batch) or by specifying appID and appVersion. The command obtains download URLs and then fetches the package and checksum files.

violet ac download-app --arch=amd64 --platformVersion=<version> --scenario=<scenario>
# or download a specific app version
violet ac download-app --arch=amd64 --appID=<app-id> --appVersion=<app-version1>,<app-version2>

Optional Flags

--arch               target architecture (`amd64` , `arm64` , `hybrid`, default: `amd64`)
--platformVersion    target platform version
--scenario           scenario name (download latest versions for the scenario)
--appID              specific application ID
--appVersion         application version (supports multiple versions separated by commas)

violet ac import-yaml

Read a local YAML file (default ./apps.yaml, violet list export) containing an applications map, send it to the AC scenario-check endpoint, and display validation results. Optionally download validated packages.

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

Optional Flags

--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`)

Example workflows

  • Login and save token:

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

  • List available scenarios:

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

  • Download the target version core packages:

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

  • List available packages and download the latest version for a scenario:

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

  • Validate an applications YAML and download validated packages:

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