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

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

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

1. Убедитесь, что в каталоге еще не создан реестр:

   yc container registry list
   

   Результат:

   +----+------+-----------+
   | ID | NAME | FOLDER ID |
   +----+------+-----------+
   +----+------+-----------+
   

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

2. Создайте реестр:

   • с автоматическим сканированием уязвимостей:

     Важно

     Функциональность доступна только в регионе Россия.

     yc container registry create --name my-reg --secure
     

   • без автоматического сканирования уязвимостей:

     yc container registry create --name my-reg
     

   Результат:

   done
   id: crpd50616s9a********
   folder_id: b1g88tflru0e********
   name: my-reg
   status: ACTIVE
   created_at: "2019-01-09T14:34:06.601Z"
   

   Требования к имени реестра:

   • длина — от 2 до 63 символов;
   • может содержать строчные буквы латинского алфавита, цифры и дефисы;
   • первый символ — буква, последний — не дефис.

   Параметр --name необязательный, можно создать реестр без имени и обращаться к нему по идентификатору. Поле name пользовательское, оно используется при листинге в Yandex Cloud CLI и не используется в Docker CLI.

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

   yc container registry list
   

   Результат:

   +----------------------+--------+----------------------+
   |          ID          |  NAME  |      FOLDER ID       |
   +----------------------+--------+----------------------+
   | crpd50616s9a******** | my-reg | b1g88tflru0e******** |
   +----------------------+--------+----------------------+
   

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

1. Добавьте в конфигурационный файл параметры реестра, который необходимо создать. Например, файл с названием example.tf в директории ~/cloud-terraform:

   resource "yandex_container_registry" "my-reg" {
     name = "my-registry"
     folder_id = "<идентификатор_каталога>"
     labels = {
       my-label = "my-label-value"
     }
   }
   

   Где:

   • name — имя реестра.
   • folder_id — идентификатор каталога.
   • labels — набор меток.

   Более подробную информацию о ресурсах, которые можно создать с помощью Terraform, смотрите в документации провайдера.

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

   1. В командной строке перейдите в директорию, где вы сохранили конфигурационный файл:

      cd /Users/<имя_пользователя>/cloud-terraform
      

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

      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.
      

3. Создайте реестр.

   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=crpuljdfqoj3********]
      
      Apply complete! Resources: 1 added, 0 changed, 0 destroyed.
      

      В каталоге будет создан реестр с именем my-registry.

   3. Проверьте ресурсы и их настройки в консоли управления.

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