Pulling an Image

Scenario

You can use Docker or containerd to pull images from SWR.

Prerequisites

• Before pulling an image, ensure that your network connection is normal.
• Before pulling an image, contact the administrator to grant the SWR pull permission on the IAM console. For details, see SWR Permissions.
• On the My Images page, Private Images list your own images in your organization and Shared Images list private images shared by other users in the organization.
• After an IAM user is created, the administrator needs to grant permissions to the user in the organization so that the user can read and edit images in the organization. For details, see User Permissions.

Docker

1. Log in to the VM running Docker as the root user.
2. Obtain a login command by referring to Step 1 and access SWR.
3. Log in to the SWR console.
4. In the navigation pane, choose My Images and click the target image.
5. On the Image Tags tab page, in the same row as the target image tag, click in the Image Pull Command column to copy the command.
6. Run the image pull command obtained in Step 5 on the VM.

   Run the docker images command to check whether the images are successfully pulled.

   # docker images
   REPOSITORY                                  TAG       IMAGE ID       CREATED         SIZE
   xxx/group/nginx                             v2.0.0    22f2bf2e2b4f   5 hours ago     22.8MB

7. (Optional) Run the following command to save the image as an archive file:

   docker save [Image name:tag name] > [Archive file name]

containerd

1. Log in to the SWR console.
2. In the navigation pane, choose My Images and click the name of your image.
3. On the Tags tab page, click containerd command in the Operation column to copy the image pull command. Alternatively, go to the Pull/Push tab page to copy the image pull command.
   NOTE:

   The command is only valid for six hours after it is generated. To obtain a long-term valid command, see Obtaining a Long-Term Valid containerd Pull/Push Command.

4. Log in to the VM running containerd as the root user.
5. Run the command copied in Step 3.
   • If the command was copied from the Operation column, run it as follows.

     

   • If the command was copied from the Pull/Push tab page, run it as follows (replace {Tag} with the new image tag).

     

6. Check whether the image is pulled successfully.
   • If the command was copied from the Operation column, run crictl images to check whether the pull is successful.

     

   • If the command was copied from the Pull/Push tab page, run ctr images list to check whether the pull is successful.