Связаться с намиПодключиться

Создание реестра

Статья создана
Обновлена 1 ноября 2025 г.

  1. В консоли управления выберите каталог, в котором хотите создать реестр.

  2. В списке сервисов выберите Cloud Registry.

  3. На панели слева выберите Реестры.

  4. В правом верхнем углу нажмите кнопку Создать реестр.

  5. Выберите формат реестра.

  6. Настройте формат реестра:

    1. В поле Тип реестра выберите нужный тип создаваемого реестра:

      • Local — локальный реестр. Тип доступен для всех форматов реестра.
      • Remote — удаленный реестр. Доступен для форматов Maven, Npm и Docker.
      • Virtual — виртуальный реестр. Доступен для форматов Maven, Npm и Docker.

    2. Если вы выбрали формат реестра Maven и тип Local, в поле Политика версий выберите политику версий:

      • Release — стабильные версии;
      • Snapshot — разработка с частыми обновлениями;
      • Mixed — сочетание политик Release и Snapshot для гибкости.

    3. Если вы выбрали тип реестра Remote, выберите адрес удаленного реестра:

      • Для формата Maven доступны репозитории Maven Central и Axiom.

        Примечание

        Репозиторий Axiom доступен по запросу. Чтобы активировать доступ к Axiom, создайте обращение в службу технической поддержки.

      • Для формата Npm доступен только репозиторий Npm.

      • Для формата Docker доступен только репозиторий Docker Hub. При этом необходимо задать данные для аутентификации в Docker Hub:

        • Предоставьте сервисному агенту сервиса Cloud Registry доступ к содержимому секрета Yandex Lockbox, назначив ему на этот секрет роль lockbox.payloadViewer.

          В настоящее время такой доступ можно выдать только с помощью команды Yandex Cloud CLI, указав в ней идентификатор секрета Yandex Lockbox, содержащего токен или пароль, и идентификатор облака, в котором вы создаете реестр:

          yc lockbox secret add-access-binding \
  --id <идентификатор_секрета> \
  --role lockbox.payloadViewer \
  --agent cloud-registry:data-plane \
  --cloud-id <идентификатор_облака>

        • Аутентифицируйтесь в Docker Hub по токену доступа. Для этого выберите вариант аутентификации Basic, укажите имя пользователя и в поле Идентификатор секрета в Lockbox выберите секрет Yandex Lockbox, в ключе value которого сохранен токен.

    4. Если вы выбрали тип реестра Virtual, в поле Реестры с помощью кнопки Добавить реестр добавьте в виртуальный реестр нужные локальные и/или удаленные реестры, указав их идентификаторы.

      Идентификатор реестра можно посмотреть в консоли управления на странице с информацией о реестре.

  7. Введите имя и описание реестра.

  8. Нажмите Создать.

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

yc cloud-registry registry create \
  --name <имя_реестра> \
  --description <описание_реестра> \
  --registry-kind <формат_реестра> \
  --registry-type <тип_реестра> \
  --properties <cвойства_реестра>

Где:

  • --name — имя реестра.
  • --description — описание реестра.
  • --registry-kind — формат реестра. Доступные значения — maven, npm и docker.
  • --registry-type — тип реестра. Доступные значения: local, remote и virtual.
  • --properties — cвойства реестра. Задаются строкой в формате name1=value1,name2=value2. Доступные свойства:
    • для локальных реестров (local):
      • versionPolicy — политика версий для реестра, формат которого — maven. Доступные значения: mixed, release, snapshot. Значение по умолчанию — mixed.
    • для удаленных реестров (remote):
      • source — реестр-источник. Доступные значения определяются форматом реестра. Например, @maven-central — для maven, @npmjs — для npm.
      • authorizationType — тип авторизации. Доступные значения: none, basic. Значение по умолчанию — none. Доступно только для реестра, формат которого — docker.
      • authorizationSecretId — идентификатор секрета пользователя, в котором хранится токен или пароль. Требуется, если authorizationType — basic. Доступно только для реестра, формат которого — docker.
      • authorizationUsername — имя пользователя. Требуется, если authorizationType — basic. Доступно только для реестра, формат которого — docker.
    • для виртуальных реестров (virtual):
      • registryIds — список идентификаторов локальных и удаленных реестров в порядке их обхода. Указывается в формате registryIds=registry1;registry2.
      • readOnly — разрешение загрузки артефактов в реестр. Доступные значения: true — загрузка запрещена, false — загрузка разрешена.
      • deploymentRegistryId — идентификатор реестра для загрузки артефактов. Требуется, если readOnly — false.

Результат:

done (3s)
id: cn1fsnc2dak********
folder_id: b1gc1t4cb638********
name: my-first-registry
kind: DOCKER
type: LOCAL
status: ACTIVE
description: docker
created_at: "2024-11-30T16:11:12.901356Z"
modified_at: "2024-11-30T16:11:16.243323Z"

Чтобы создать реестр, воспользуйтесь методом REST API create для ресурса Registry или вызовом gRPC API RegistryService/Create.

Предыдущая
Все инструкции
Следующая
Установить и настроить Docker