Создать реестр

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

Yandex.Cloud

Использовать созданный реестр могут все пользователи и сервисные аккаунты, у которых есть права на каталог.

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

CLI

API

Terraform

В консоли управления выберите каталог, в котором будет создан реестр.
В списке сервисов выберите Container Registry.
Задайте имя реестра.
- Длина — от 3 до 63 символов.
- Может содержать строчные буквы латинского алфавита, цифры и дефисы.
- Первый символ — буква. Последний символ — не дефис.
Нажмите кнопку Создать реестр.

Если у вас еще нет интерфейса командной строки Yandex.Cloud, установите и инициализируйте его.

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

Убедитесь, что в каталоге еще не создан реестр:
```
yc container registry list
```
Результат выполнения команды:
```
+----+------+-----------+
| ID | NAME | FOLDER ID |
+----+------+-----------+
+----+------+-----------+
```
Если в каталоге уже есть реестр, посмотрите, как можно его изменить, в разделе Изменить реестр.
Создайте реестр:
```
yc container registry create --name my-reg
```
Результат выполнения команды:
```
done
id: crpd50616s9a2t7gr8mi
folder_id: b1g88tflru0ek1omtsu0
name: my-reg
status: ACTIVE
created_at: "2019-01-09T14:34:06.601Z"
```
- Длина — от 3 до 63 символов.
- Может содержать строчные буквы латинского алфавита, цифры и дефисы.
- Первый символ — буква. Последний символ — не дефис.
- Флаг --name — необязательный. Можно создать реестр без имени и обращаться к нему по идентификатору.
- Поле name — пользовательское, оно используется при листинге в YC CLI и не используется в Docker CLI.

Проверьте, что реестр создался:

yc container registry list

Результат выполнения команды:

+----------------------+--------+----------------------+
|          ID          |  NAME  |      FOLDER ID       |
+----------------------+--------+----------------------+
| crpd50616s9a2t7gr8mi | my-reg | b1g88tflru0ek1omtsu0 |
+----------------------+--------+----------------------+

Чтобы создать реестр, воспользуйтесь методом create для ресурса Registry.

Если у вас еще нет Terraform, установите его и настройте провайдер Yandex.Cloud.

Добавьте в конфигурационный файл параметры реестра, который необходимо создать. Например, файл с названием example.tf в директории ~/yandex-cloud-terraform:
```
resource "yandex_container_registry" "my-reg" {
  name = "my-registry"
  folder_id = "<идентификатор каталога>"
  labels = {
    my-label = "my-label-value"
  }
}
```
Где:
- name — имя реестра.
- folder_id — идентификатор каталога.
- labels — набор меток.
Более подробную информацию о ресурсах, которые можно создать с помощью Terraform, смотрите в документации провайдера.

Проверьте корректность конфигурационного файла.

В командной строке перейдите в директорию, где вы сохранили конфигурационный файл:
```
cd /Users/<имя пользователя>/yandex-cloud-terraform
```

Выполните проверку с помощью команды:

terraform plan

Результат выполнения команды:

Refreshing Terraform state in-memory prior to plan...
The refreshed state will be used to calculate this plan, but will not be
persisted to local or remote state storage.
...
Note: You didn't specify an "-out" parameter to save this plan, so Terraform
can't guarantee that exactly these actions will be performed if
"terraform apply" is subsequently run.

Создайте реестр.
1. Выполните команду:
```
terraform apply
```
  Результат выполнения команды:
```
An execution plan has been generated and is shown below.
Resource actions are indicated with the following symbols:
  + create
...
  Terraform will perform the actions described above.
  Only 'yes' will be accepted to approve.

  Enter a value:
```
2. Подтвердите создание реестра. Для этого введите значение yes и нажмите Enter:
```
Enter a value: yes
```
  Результат выполнения команды:
```
yandex_container_registry.default: Creating...
yandex_container_registry.default: Creation complete after 4s [id=crpuljdfqoj3ve9mtbt1]

Apply complete! Resources: 1 added, 0 changed, 0 destroyed.
```
  В каталоге будет создан реестр с именем my-registry.
3. Проверьте ресурсы и их настройки в консоли управления.