Docs

Container Registry

Getting started

Upload and download generic format packages

The artifact repository supports hosting packages, allows users to create an artifact repository, and upload and download packages. This article explains how to quickly use the artifact repository to upload and download packages in the Generic format.

Prerequisites

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

If IAM users need to perform actions on the artifact repository, ensure that the relevant policies and role authorizations for the artifact repository have been completed. For specific operating instructions, refer to Permission Management.

The curl tool has already been installed in the local environment (Linux/Mac).

Procedure

Step 1: Create an 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 Generic package format, and then in the menu bar, choose Repository Management and click on New Repository to enter the repository configuration page.

Configure the parameters of the artifact repository.

Click Confirm.

Step 3: Configure repository credentials

Select the Generic package format from the dropdown menu at the top of the left navigation bar, and select registry management from the menu bar.

In the repository management list, click Set Permanent Credential. You can now configure the credentials of the artifact repository.

Step 4: Upload package

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

Parameter	Description
{output file name}	The local name of the Generic package. In this example, it is test-1.0.2.sh.
{username}:{password}	The login information for the artifact repository, including username and password.log in e.g., user_demo@2100012345:cf83200******.
{target path}	The save path of the packages in the repository. This path consists of 2 parts: the repository URL and the file path. Repository URL: You can obtain the repository URL from the repository details. For details, please refer to Managing Repositories. Package path: The save path of the packages in the repository, e.g., /org/demo/demo-1.2.sh

Click the Enter key and enter either the permanent or temporary credentials of the repository to complete the push of packages to the repository.

Step 5: Download package

Log in to your local environment (MAC/Linux) and execute the following command to download the Generic 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******.
{repository target path}	The path of the package in the repository. This path comprises two parts. You can obtain the package's URL path by viewing its details in the repository.
{output file name}	The name of the package downloaded and saved locally.

Press the Enter key, and the system will automatically download the packages.

View results

Log in to the artifact repository. In the corresponding repository, you can view the list of packages that have been uploaded correctly.

Last updated: 2025.10.24 11:20:36