Создать удаленный реестр

Статья создана

Yandex Cloud

Обновлена 22 июля 2026 г.

Открыть в Markdown

Примечание

Удаленный реестр можно создать любого формата, кроме Binary и Go.

Консоль управления

CLI

API

В консоли управления выберите каталог, в котором хотите создать удаленный реестр.
Перейдите в сервис Cloud Registry.
На панели слева выберите Реестры.
В правом верхнем углу нажмите кнопку Создать реестр.
Выберите формат реестра.
В поле Тип реестра выберите Remote.

Выберите тип источника:

Public — публичный источник.

Формат реестра	Адреса публичных источников
Maven	`Maven Central` `Gradle Plugin Portal` `Gradle Distributions` `Confluent` `Axiom`
Npm	`Npm`
Docker	`Docker Hub` `Amazon ECR Public` `Kubernetes Registry` `GitHub Container Registry` `GitLab Container Registry` `Kyverno Registry` `Microsoft Container Registry` `NVIDIA NGC Registry` `Red Hat Quay`
Debian	`Debian` `Ubuntu`
NuGet	`NuGet`
PyPI	`PyPI` `PyPI Test`

Примечание

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

Custom — пользовательский источник.

Укажите свой адрес пользовательского источника.

Выберите тип авторизации:

Примечание

Авторизация доступна для пользовательских источников и публичного источника Docker Hub. Для публичного источника Docker Hub доступен только тип авторизации Basic.
- None — без авторизации.
- Basic — авторизация по имени пользователя и паролю.
- Bearer — авторизация по Bearer-токену.
Если вы выбрали тип авторизации Basic или Bearer:
1. Создайте секрет Yandex Lockbox. В поле Ключ укажите value, в поле Значение укажите:
  - пароль, если тип авторизации — Basic.
  - Bearer-токен, если тип авторизации — Bearer.
2. Предоставьте сервисному агенту сервиса Cloud Registry доступ к содержимому секрета, назначив ему на этот секрет роль lockbox.payloadViewer.
  
  В настоящее время такой доступ можно выдать только с помощью команды Yandex Cloud CLI, указав в ней идентификатор секрета Yandex Lockbox, содержащего пароль или Bearer-токен, и идентификатор облака, в котором вы создаете реестр:
```
yc lockbox secret add-access-binding \
  --id <идентификатор_секрета> \
  --role lockbox.payloadViewer \
  --agent cloud-registry:data-plane \
  --cloud-id <идентификатор_облака>
```
3. В настройках реестра укажите имя пользователя (если тип авторизации — Basic) и идентификатор созданного секрета Yandex Lockbox.
Укажите паттерны фильтрации.
Введите имя и описание реестра.
Добавьте метки в формате ключ: значение.
Нажмите Создать.

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

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

Где:

--name — имя реестра.
--description — описание реестра.
--registry-kind — формат реестра. Доступные форматы: maven, npm, docker, debian, nuget, pypi.
--registry-type — тип реестра.

--properties — свойства реестра. Задаются строкой в формате name1=value1,name2=value2. Доступные свойства для удаленных реестров:

source — реестр-источник. Можно указать публичный источник или пользовательский. Доступные публичные источники:

Формат реестра	Адреса публичных источников
`maven`	`@maven-central` `@gradle-plugin-portal` `@gradle-distributions` `@confluent` `@axiom`
`npm`	`@npmjs`
`docker`	`@docker-hub` `@ecr-public` `@k8s` `@ghcr` `@gitlab` `@kyverno` `@mcr` `@nvcr` `@quay`
`debian`	`@debian` `@ubuntu`
`nuget`	`@nuget`
`pypi`	`@pypi` `@pypi-test`

Примечание

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

authorizationType — тип авторизации. Доступные типы авторизации: none, basic, bearer. Значение по умолчанию — none.

Примечание

Авторизация доступна для пользовательских источников и публичного источника @docker-hub. Для публичного источника @docker-hub доступен только тип авторизации basic.

Если вы указали authorizationType — basic или bearer:
1. Создайте секрет Yandex Lockbox. В параметре key укажите value, в качестве значения ключа укажите:
  - пароль, если authorizationType — basic.
  - Bearer-токен, если authorizationType — bearer.
2. Предоставьте сервисному агенту сервиса Cloud Registry доступ к содержимому секрета, назначив ему на этот секрет роль lockbox.payloadViewer.
  
  Выполните команду, указав в ней идентификатор секрета Yandex Lockbox, содержащего пароль или Bearer-токен, и идентификатор облака, в котором вы создаете реестр:
```
yc lockbox secret add-access-binding \
  --id <идентификатор_секрета> \
  --role lockbox.payloadViewer \
  --agent cloud-registry:data-plane \
  --cloud-id <идентификатор_облака>
```
authorizationSecretId — идентификатор секрета пользователя, в котором хранится пароль или Bearer-токен. Требуется, если authorizationType — basic или bearer.
authorizationUsername — имя пользователя. Требуется, если authorizationType — basic.

Результат:

done (3s)
id: cn1fsnc2dak********
folder_id: b1gc1t4cb638********
name: my-first-registry
kind: DOCKER
type: REMOTE
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.

В поле type укажите REMOTE.

Создать удаленный реестр

Была ли статья полезна?