[Документация Yandex Cloud](../../../index.md) > [Yandex Container Registry](../../index.md) > [Пошаговые инструкции](../index.md) > Управление Docker-образом > Скачать Docker-образ из реестра

# Скачать Docker-образ из реестра

Для скачивания [Docker-образа](../../concepts/docker-image.md) необходима [роль](../../security/index.md#container-registry-images-puller) `container-registry.images.puller` или выше. Кроме того, вам нужно знать, в каком [репозитории](../../concepts/repository.md) хранится Docker-образ, а также его [тег или хеш](../../concepts/docker-image.md#version).

Чтобы работать с Docker-образами, [установите и настройте](../configure-docker.md) Docker.

{% list tabs group=instructions %}

- CLI {#cli}

  1. Выберите необходимый вам Docker-образ. Для этого [получите список Docker-образов в реестре](docker-image-list.md#docker-image-list).
  1. Скачайте Docker-образ из [реестра](../../concepts/registry.md):
     * Используя **тег**:

       ```bash
       docker pull cr.yandexcloud.kz/<идентификатор_реестра>/ubuntu:hello
       ```

       Результат:

       ```text
       hello: Pulling from crpd50616s9a********/ubuntu
       84ed7d2f608f: Already exists
       be2bf1c4a48d: Already exists
       a5bdc6303093: Already exists
       e9055237d68d: Already exists
       Digest: sha256:035ac8e1bd9c49871a2fd76ccb3c4b0f84e7eee775919ccd345337ec********
       Status: Downloaded newer image for cr.yandexcloud.kz/crpd50616s9a********/ubuntu:hello
       ```

     * Используя **хеш**:

       ```bash
       docker pull cr.yandexcloud.kz/<идентификатор_реестра>/ubuntu@sha256:035ac8e1bd9c49871a2fd76
       ```

       Результат:

       ```text
       ccb3c4b0f84e7eee775919ccd345337ec7b49f80d
       sha256:035ac8e1bd9c49871a2fd76ccb3c4b0f84e7eee775919ccd345337ec********: Pulling from crpd50616s9a********/ubuntu
       84ed7d2f608f: Already exists
       ...
       e9055237d68d: Already exists
       Digest: sha256:035ac8e1bd9c49871a2fd76ccb3c4b0f84e7eee775919ccd345337ec********
       Status: Downloaded newer image for cr.yandexcloud.kz/crpd50616s9a********/ubuntu@sha256:035ac8e1bd9c49871a2fd76ccb3c4b0f84e7eee775919ccd345337ec********
       ```

       Обратите внимание, что в данном случае Docker-образ будет скачан без тега. В поле `TAG` будет указано `<none>`.
  1. Проверьте, что Docker-образ действительно скачан:

     ```bash
     docker image list
     ```

     Результат:

     ```text
     REPOSITORY                                  TAG     IMAGE ID      CREATED       SIZE
     cr.yandexcloud.kz/crpd50616s9a********/ubuntu       <none>  50ff********  24 hours ago  86.7MB
     ubuntu                                      latest  1d9c********  2 weeks ago   86.7MB
     ```

{% endlist %}

#### Смотрите также {#see-also}

* [Решение проблем в Container Registry](../../error/index.md).