Updated on 2024-12-02 GMT+08:00

Pulling an Image

Scenario

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

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.

    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.