Docs

Container Registry

Downloading packages

Downloading packages (command line)

Downloading packages is one of the fundamental functions of an artifact repository, enabling you to download packages from the artifact repository to your local environment. This section explains how to download packages from the artifact repository to your local environment using the command line.

tip

Since Python 2.7 is no longer maintained, the configuration methods described in this document use Python 3.x as an example.

Prerequisites

Have registered a Volcano Engine root user and activated the artifact repository Service.

A repository instance has been created. For details, refer to Creating basic edition instances.

A PyPI-format artifact repository has been created. For details, please refer to Creating PyPI repositories.

The credentials for the artifact repository have been configured. For details, please refer to Configuring permanent access credentials or Configuring temporary access credentials.

Python and pip have been installed in your local environment.

The target package already exists in the artifact repository.

Procedure

Step 1: Configure the local pip source

tip

In Linux systems, the pip.conf configuration file is typically located in the user's root directory, i.e., ~/.pip/pip.conf.

If this directory does not exist in your environment, you can create it using the mkdir.pip command in the root directory.

Add the repository information of the artifact repository to the pip.conf file.

Parameter	Description
{username}:{password}	The username and password for the artifact repository, e.g., user_demo@2100012345:cf83200******.
{repo path}	The URL address of the artifact repository. For details, please refer to Managing Repository.
trusted-host ={domain}	The trusted domain name, which should be configured as the domain name of the artifact repository, e.g., artifact-beijing.volces.com.

Step 2: Download packages

Parameter	Description
{package name}	The name of the package to be downloaded.

tip

You can also temporarily download packages from the artifact repository without configuring the local pip source. The download command is pip install --trusted-host {domain} -i https://{username}:{password}@{repository-url}<package name>

Last updated: 2025.10.24 11:20:37