tocdepth: 2

Артефакты в Artifact Registry

Артефакты в Artifact Registry хранятся в репозиториях. Каждый репозиторий содержит артефакты только одного типа.

Типы артефактов

Artifact Registry поддерживает спецификацию OCI Image Format Specification и позволяет хранить в репозитории следующие OCI-совместимые артефакты:

Docker-образы, в том числе мультиархитектурные.
Образы для Windows-контейнеров.
Helm-чарты.

Docker-образы

Docker-образ — шаблон для создания Docker-контейнеров. Образ содержит все необходимое для запуска приложения: код, среду выполнения, библиотеки, переменные окружения и файлы конфигурации. Сервис поддерживает спецификацию Docker Registry HTTP API V2.

Управление Docker-образами в Artifact Registry осуществляется с помощью тегов и дайджестов.

Тег присваивается пользователем при загрузке образа в репозиторий.

Тег должен быть уникальным в пределах одного репозитория. Тег будет удален со старого образа и присвоен новому при загрузке образа с уже существующим в репозитории тегом. При этом старый образ останется в репозитории, но не будет иметь тега. Работать с такими образами можно с помощью дайджеста.

Дайджест генерируется автоматически при создании образа. Дайджест уникален для каждого Docker-образа в репозитории.

Теги и дайджесты образов доступны в личном кабинете, в разделе Репозитории → Артефакты.

Ниже примеры использования тега и дайджеста при скачивании образа.

Скачать образ по тегу:

docker pull <registry_name>.cr.cloud.ru/<repository_name>:<tag>

Скачать образ по дайджесту:

docker pull <registry_name>.cr.cloud.ru/<repository_name>@sha256:432f982638b3aefab73cc58ab28f5c16e96fdb504e8c134fc58dff4bae8bf338

Образы для Windows-контейнеров

В репозитории Artifact Registry образы для Windows-контейнеров хранятся аналогично Docker-образам.

Для работы с образами для Windows-контейнеров в Artifact Registry нужно предварительно настроить конфигурационный файл Docker Daemon.

Helm-чарты

Helm-чарт — менеджер пакетов с открытым исходным кодом, который используется для упрощения развертывания приложений Kubernetes.

В репозитории Artifact Registry Helm-чарты хранятся аналогично Docker-образам. Поддерживаются версии Helm-чартов от 3.8.0 и выше.

Подробнее о Helm-чартах — в официальной документации Helm.

Операции с артефактами

Пользователям доступны операции загрузки (push) и скачивания (pull) артефактов. Загрузка и скачивание артефактов доступны пользователям с соответствующими правами.

Для операций с артефактами необходимо пройти аутентификацию. Если артефакт размещен в публичном реестре, то скачать артефакт без аутентификации может любой пользователь, знающий команду скачивания.

См.также