12.5.4. Работа с regclient

⁠12.5.4. Работа с regclient

⁠12.5.4.1. Просмотр информации об образах

Список всех репозиториев:

$ regctl repo ls registry.test.alt:5000
myapp

Список тегов в репозитории:

$ regctl tag ls registry.test.alt:5000/myapp
latest

Метаданные образа:

$ regctl image inspect registry.test.alt:5000/myapp:latest

Вывод включает OCI-манифест: архитектуру, ОС, слои, размер, аннотации.

⁠12.5.4.2. Работа с образами

Экспорт образа в tar (без Docker):

$ regctl image export registry.test.alt:5000/myapp:latest myapp.tar

Копирование образа между реестрами:

$ regctl image copy \
  docker.io/library/alpine:latest \
  registry.test.alt:5000/alpine:latest

⁠12.5.4.3. Работа с манифестами

Получить манифест:

$ regctl manifest get registry.test.alt:5000/myapp:latest

Для сохранения манифеста в файл в формате JSON необходимо указать формат вывода raw-body:

$ regctl manifest get registry.test.alt:5000/myapp:latest \
  --format raw-body > manifest.json

Отправить манифест:

$ regctl manifest put registry.test.alt:5000/myapp:1.0.0 \
  --content-type application/vnd.oci.image.manifest.v1+json \
  < manifest.json

Примечание

При отправке манифеста с помощью regctl manifest put необходимые образы слоёв и конфигурация (config, layers), на которые ссылается манифест, должны уже находиться в реестре. Для полного копирования образа между тегами или реестрами рекомендуется использовать команду regctl image copy.

Фильтрация манифеста по платформе:

$ regctl manifest get registry.test.alt:5000/myapp:latest --platform linux/arm64

⁠12.5.4.4. Работа с артефактами

Просмотр SBOM (если загружен как OCI-артефакт):

$ regctl artifact list registry.test.alt:5000/myapp:latest

⁠12.5.4.5. Модификация образов

Модификация образа:

добавить аннотацию ко всем платформам:

$ regctl image mod registry.test.alt:5000/myapp:latest \
  --replace \
  --annotation "[*]org.opencontainers.image.created=2026-03-30T05:06:07Z"

изменить entrypoint:

$ regctl image mod registry.test.alt:5000/myapp:latest \
  --create v1-bash \
  --config-entrypoint '["bash"]' \
  --config-cmd ""

Примечание

Флаг --replace перезаписывает существующий тег!