Help Center/ SoftWare Repository for Container/ User Guide (Basic Edition)/ Image Management/ Pushing an Image
Updated on 2025-11-14 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 method is a good choice for 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 method is suitable for 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 50 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.
  • Images that comply with the Open Container Initiative (OCI) specifications (v1.0 and v1.1) cannot be uploaded. You can use SWR Enterprise Edition to upload images.
  • A single tenant can push up to 500 images and 300 tags for each image. If the quotas are exceeded, the push will fail.

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.

      • 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 Standard Long-Term 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.

    • If the number of pushed images reaches the quota, new images cannot be pushed. However, if there are existing images but the number of image tags does not reach the quota, more images can be pushed.
    • If the number of tags of an image reaches the quota, the image cannot be pushed, but other images can still be pushed.
    • When images or image tags are pushed concurrently, the number of pushed images or image tags may exceed the quota. To release the quota, you need to delete all images or image tags that exceed the quota and then delete unused images or image tags.

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 1 Uploading an image on the SWR console

  4. Click Upload.

    If Completed is displayed, the image is uploaded successfully.

  • If the number of pushed images reaches the quota, new images cannot be pushed. However, if there are existing images but the number of image tags does not reach the quota, more images can be pushed.
  • If the number of tags of an image reaches the quota, the image cannot be pushed, but other images can still be pushed.
  • When images or image tags are pushed concurrently, the number of pushed images or image tags may exceed the quota. To release the quota, you need to delete all images or image tags that exceed the quota and then delete unused images or image tags.

FAQ

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

Other

Parent Topic: Image Management