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 ToolFor Linux or macOSFor WindowsPrerequisitesUsageviolet ac loginOptional Flagsviolet ac scenariosOptional FlagsACP 4.4 Installation and Upgrade Scenariosviolet ac packagesOptional Flagsviolet ac download-pkgOptional Flagsviolet ac download-appOptional Flagsviolet ac download-osFlagsviolet ac import-yamlOptional FlagsExample workflows

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.

Use Violet v4.2.13 or later for the workflows documented on this page. After installing the binary, verify its version:

violet version

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 to the 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 Customer Portal - Settings. The validity period of an access token is within 24 hours from successful login.

violet ac scenarios

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

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

Optional Flags

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

ACP 4.4 Installation and Upgrade Scenarios

Use the following scenarios when preparing 4.4 packages:

ScenarioUse
Common ACP ExtensionsDownload the package set that contains the eight Aligned applications required for a new 4.4 installation, together with other Extensions.
ACP Upgrade to v4.4Download the Aligned Extension packages required when upgrading an existing environment to 4.4.

Set <target-platform-version> to the exact ACP Distribution Version of the Core Package, such as v4.4.0. Set <arch> to amd64, arm64, or hybrid to match the Core Package.

First list the available scenarios to confirm that the expected scenario is published for the target version and architecture. Then download the required 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"

Downloading a scenario does not add its packages to the Core Package. Extract the Core Package and manually copy the packages required by the installation or upgrade procedure into its plugins/ directory. For the exact application names and copy steps, see Download and Pre-Upgrade Preparation.

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
--appID              download single app for a specific application ID
--scenario           scenario filter (optional)
Note

About scenario, if not configured, all packages are displayed.

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>
# 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>

Optional Flags

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

About scenario, if not configured, all packages are downloaded.

violet ac download-os

Download OS packages from the AC Marketplace OS page. Use --list first to inspect available platform versions, architectures, and operating systems, then download the matching OS package and checksum file.

# 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

Flags

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

Use --list with fewer filters to discover valid platformVersion, arch, and operatingSystem values before downloading.

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

  • List available packages status('Downloaded' or 'Download Failed'):

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

  • List and download OS packages:

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

  • Validate an applications YAML and download validated packages:

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