Управление реестром с помощью regctl

Управлять реестром контейнеров можно не только через панель управления, но и с помощью сторонних CLI-утилит. Одна из таких утилит — regctl, кроссплатформенная утилита для работы с реестрами.

Установка

Установите regctl одним из способов в зависимости от операционной системы.

    

      

    
    scoop bucket add extras
scoop install regclient

  

Проверьте установку:

    

      

    
    regctl version
  

Другие способы установки описаны в официальной документации regclient.

Авторизация

Для авторизации выполните команду:

    

      

    
    regctl registry login имя_реестра.registry.twcstorage.ru \
--user имя_пользователя \
--pass токен

  

Где:

• имя_реестра — имя, указанное при создании реестра;

• имя_пользователя — любое значение;

• токен — токен, выданный при создании реестра.

После выполнения команды данные будут сохранены в ~/.regctl/config.json, и повторная авторизация не потребуется.

Команды

Получить список всех доступных команд:

    

      

    
    regctl
  

Загрузка образа

Для проверки загрузки создайте локальный минимальный OCI-образ:

    

      

    
    regctl image create ocidir://minimal-image:latest \
--created now \
--platform linux/amd64

  

Загрузите образ в реестр:

    

      

    
    regctl image copy \
ocidir://minimal-image:latest \
имя_реестра.registry.twcstorage.ru/имя_репозитория/имя_образа:latest

  

Если указать имя несуществующего репозитория, он будет создан автоматически.

Просмотр репозиториев и образов

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

    

      

    
    regctl repo ls имя_реестра.registry.twcstorage.ru
  

Просмотреть теги образа:

    

      

    
    regctl tag ls имя_реестра.registry.twcstorage.ru/имя_репозитория/имя_образа
  

Получить информацию об образе:

    

      

    
    regctl image inspect имя_реестра.registry.twcstorage.ru/имя_репозитория/имя_образа:тег
  

Удаление образа

Образ удаляется по его digest (хешу). Вместе с образом удаляются все теги, которые на него ссылаются.

Получите digest образа:

    

      

    
    regctl image digest имя_реестра.registry.twcstorage.ru/имя_репозитория/имя_образа:тег
  

Также digest можно найти в панели управления реестром, во вкладке «Репозитории».

Удалите образ:

    

      

    
    regctl manifest rm имя_реестра.registry.twcstorage.ru/имя_репозитория/имя_образа@sha256:хеш
  

Также образ можно удалить по тегу с флагом --force-tag-dereference:

    

      

    
    regctl manifest rm имя_реестра.registry.twcstorage.ru/имя_репозитория/имя_образа:тег --force-tag-dereference
  

Обратите внимание, что при удалении образа исчезнут все теги, которые на него указывают. Например, если на образ ссылаются теги latest, v1.2.3 и stable, будут удалены все три тега.

При удалении образа через regctl место в реестре освобождается не сразу. Образ становится недоступен, но его слои удаляются позже при сборке мусора. Если место нужно освободить сразу, удалите образ через панель управления.

Удаление тега

Чтобы удалить только тег и оставить образ, выполните команду:

    

      

    
    regctl tag rm имя_реестра.registry.twcstorage.ru/имя_репозитория/имя_образа:тег
  

Другие теги, которые указывают на тот же образ, продолжат работать.