Docs

Container Registry

Getting started

Upload and download packages in AI format

The artifact repository supports hosted artifacts, allowing users to create artifact repositories and upload and download artifacts. This article explains how to quickly use the artifact repository to upload and download AI format package.

Prerequisites

A Volcano Engine root user has been registered. For details, refer to how to register an account.

To allow IAM users to operate artifact repositories, ensure that relevant artifact repository policies and role authorizations have been completed. For detailed operating instructions, refer to Permission Management.

Procedure

Step 1: Create instance

In the left navigation bar, click Instances. Then, in the Instances area on the right page, click Create a Basic Edition Instance.

Configure the instance parameters.

Parameter	Description
Instance Name	The name of the instance, which cannot be modified.
Repository Domain Name	The domain name for accessing the repository, which is automatically generated by the system and cannot be modified.
Billing method	The billing method of the instance. Currently, only Pay-as-you-go is supported and cannot be modified.

Click Confirm to navigate to the Confirm Order interface.

After confirming the configuration details, billing type, purchase quantity, and price in the order, if there are no issues, check the box for I have read and agreed to the "Service Terms for the Basic Edition of Artifact Repository".

Click confirm and wait for the system to complete instance creation.

Step 2: Create a repository

In the left navigation bar, select Instances. In the Instances area on the right page, click to enter the artifact repository instance.

At the top of the left navigation bar, select the AI package format, and then in the menu bar, choose Repository Management and click on New Repository to enter the repository configuration page.

Configuration parameters of the artifact repository.

tip

For the meanings of different parameters when creating a repository, refer to Create AI repository.

Click Confirm.

Step 3: Configure repository credentials

In the dropdown menu at the top of the left navigation bar, select the AI package format, and in the left navigation bar, select Identity and Access Management > settings.

Choose the Permanent Access Credential tab. Click Set Permanent Credential. You can now configure this artifact repository's permanent access credentials.

Step 4: Upload a package

Log in to your local environment (MAC/Linux), and execute the following command to upload AI packages to the artifact repository.

Parameter	Description
{username}:{password}	The login information for the artifact repository, including username and password.log in e.g., user_demo@2100012345:cf83200******.
{local_filename}	The name of the package saved locally.
https://{repo_url}/models/{namespace}/{model}/{version}/	The URL address of the artifact repository and the package path. {repo_url}: The URL address of the artifact repository. For details, please refer to Managing repositories. {namespace}: The namespace of the artifact repository, e.g., doc-demo. {model}: The name of the package in the artifact repository, e.g., ai-demo. {version}: the package version in the artifact repository, e.g., v1.0. Renaming files when uploading package files to the artifact repository, for example, demo.js.

Click the Enter key to complete the push packages to the repository.

tip

For more methods for uploading AI packages, please refer to Upload packages (command line).

Step 5: Download package

Log in to the local environment (MAC/Linux), and use the following command to download AI packages from the artifact repository.

Parameter	Description
{username}:{password}	The login information for the artifact repository, including username and password.log in e.g., user_demo@2100012345:cf83200******.
https://{repo_url}/models/{namespace}/{model}/{version}/{filename}\|	The URL address of the artifact repository and the package path. {repo_url}: The URL address of the artifact repository. For details, please refer to Managing repositories. {namespace}: The namespace of the artifact repository, e.g., doc-demo. {model}: The name of the package in the artifact repository, e.g., ai-demo. {version}: the package version in the artifact repository, e.g., v1.0. {filename}: The filename of the package in the artifact repository, e.g., demo.js.
{local_filename}	The name of the package saved locally.

Click the Enter key to pull packages.

tip

For more ways to download AI packages, refer to Download packages (command line).

View results

Use a command to upload the package.

Once you enter the artifact repository, you can view the uploaded packages.

Last updated: 2025.10.24 11:20:36