Help Center/ SoftWare Repository for Container/ User Guide (Basic Edition)/ Image Management/ Pushing an Image
Updated on 2025-09-19 GMT+08:00
View PDF
Share

Pushing an Image

Scenarios

You can use either a container engine client or the SWR console to push your images to SWR for easier management.

  • Method 1: Run docker push (Docker) or ctr push (containerd) on the server where the container engine client is installed to push an image to SWR. This is applicable to the push of large images.

    The push can be implemented over an intranet or the Internet. For details, see Configuring Access Network.

  • Method 2: Upload an image on the SWR console. This is applicable to the push of small images.

Prerequisites

Constraints

  • If a Docker container engine client is used to push images, the Docker version is 18.06 or later.
  • The size of each image layer cannot exceed 10 GB.
  • A single tenant can push up to 20 image layers concurrently.
  • If you use the console, up to 10 files can be uploaded at a time. The size of a single file (including each decompressed file) cannot exceed 2 GB. If the image package to be uploaded is created using a Docker container engine client, the Docker version must be 18.06 or later.

Methods

  • For small images, upload them on the console. Resumable upload is not supported. For large images, push them using a container engine client.

Docker

  1. Build a container image or import an image file.
  2. Connect to SWR.
    1. Log in to the SWR console.
    2. In the navigation pane, choose Dashboard. Click Generate Login Command in the upper right corner. In the displayed dialog box, click to copy the login command.
      Figure 1 Generating a login command
      • A temporary login command is valid for 6 hours. For details about how to obtain a login command that will remain valid for a long term, see Obtaining a Long-Term Login or Image Push/Pull Command. After you obtain a long-term login command, your temporary login commands will still be valid as long as they are in their validity periods.
      • After a temporary login command expires, clear the browser cache before you generate a new one.
      • The domain name at the end of the login command is the image registry address. Record the address for later use.
    3. Run the login command on the server where Docker is installed.

      The message Login Succeeded will be displayed upon a successful login.

  3. Run the following command on the server running Docker to tag the nginx image:

    docker tag [image-name 1:tag 1][image-registry-address]/[organization-name]/[image-name 2:tag 2]

    In the command:

    • [image-name 1:tag 1]: Replace it with the actual name and tag of the image to push.
    • [image-registry-address]: You can obtain the address on the SWR console, that is, the domain name at the end of the login command in 2.b.
    • [organization-name]: Replace it with the name of the organization created.
    • [image-name 2:tag 2]: Replace it with the desired image name and tag.

    Example:

    docker tag nginx:v1 swr.ap-southeast-1.myhuaweicloud.com/cloud-develop/nginx:v1

  4. Run the following command to push the image to SWR:

    docker push [image-registry-address]/[organization-name]/[image-name 2:tag 2]

    Example:

    docker push swr.ap-southeast-1.myhuaweicloud.com/cloud-develop/nginx:v1

    The following information will be returned upon a successful push:

    The push refers to repository [swr.ap-southeast-1.myhuaweicloud.com/cloud-develop/nginx:v1]
fbce26647e70: Pushed 
fb04ab8effa8: Pushed 
8f736d52032f: Pushed 
009f1d338b57: Pushed 
678bbd796838: Pushed 
d1279c519351: Pushed 
f68ef921efae: Pushed 
v1: digest: sha256:0cdfc7910db531bfa7726de4c19ec556bc9190aad9bd3de93787e8bce3385f8d size: 1780

    To view the pushed image, refresh the My Images page.

containerd

  1. Log in to the SWR console.
  2. In the navigation pane, choose My Images. Then click the name of the target image.
  3. On the Pull/Push tab, click Generate Push Command and copy the command.

    The command is only valid for six hours after it is generated. To obtain a push command that will remain valid for a long term, see Obtaining a Push/Pull Command for containerd.

  4. Log in to the VM running containerd as root.
  5. On the server, run the command copied in 3.

  6. Check whether the image is pushed successfully.

FAQ

Why Does an Image Fail to Be Pushed Using a Container Engine Client?

Other

Procedure

  1. Log in to the SWR console.
  2. In the navigation pane, choose My Images. Then click Upload Through SWR.
  3. In the displayed dialog box, select an organization. Then, click Select File to upload an image file.

    If you select multiple images, they will be uploaded one by one. Concurrent upload is not supported.

    Figure 2 Uploading an image on the SWR console

  4. Click Upload.

    If Completed is displayed, the image is uploaded successfully.

FAQ

Why Does an Image Fail to Be Uploaded Through the SWR Console?

Other

Parent Topic: Image Management