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

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

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

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

   yc iot registry create --name my-registry
   

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

   Результат:

   id: b91ki3851hab9m0l68je
   folder_id: aoek49ghmknnpj1ll45e
   created_at: "2019-05-28T11:29:42.420Z"
   name: my-registry
   

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

   yc iot registry list
   

   Результат:

   +----------------------+-------------+
   |          ID          |    NAME     |
   +----------------------+-------------+
   | b91ki3851hab9m0l68je | my-registry |
   +----------------------+-------------+
   

Terraform позволяет быстро создать облачную инфраструктуру в Yandex Cloud и управлять ею с помощью файлов конфигураций. В файлах конфигураций хранится описание инфраструктуры на языке HCL (HashiCorp Configuration Language). Terraform и его провайдеры распространяются под лицензией Mozilla Public License.

Подробную информацию о ресурсах провайдера смотрите в документации на сайте Terraform или в зеркале.

При изменении файлов конфигураций Terraform автоматически определяет, какая часть вашей конфигурации уже развернута, что следует добавить или удалить.

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

Чтобы создать реестр устройств:

1. Опишите в конфигурационном файле параметры ресурса, который необходимо создать:

   • yandex_iot_core_registry — параметры реестра:
     • name — имя реестра.
     • description — описание реестра.
     • labels — метки реестра в формате ключ:значение.
     • passwords — список паролей реестра для авторизации с помощью логина и пароля.
     • certificates — список сертификатов реестра для авторизации с помощью сертификатов.

   Пример структуры ресурса в конфигурационном файле:

   resource "yandex_iot_core_registry" "my_registry" {
     name        = "test-registry"
     description = "test registry for terraform provider documentation"
     labels = {
       test-label = "label-test"
     }
   
     passwords = [
       "<пароль_1>",
       "<пароль_2>"
     ]
   
     certificates = [
       file("<путь_к_первому_файлу_с_сертификатом>"),
       file("<путь_ко_второму_файлу_с_сертификатом>")
     ]
   }
   
   output "yandex_iot_core_registry_my_registry" {
     value = "${yandex_iot_core_registry.my_registry.id}"
   }
   

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

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

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

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

      terraform plan
      

   Если конфигурация описана верно, в терминале отобразится список создаваемых ресурсов и их параметров. Если в конфигурации есть ошибки, Terraform на них укажет.

3. Разверните облачные ресурсы.

   1. Если в конфигурации нет ошибок, выполните команду:

      terraform apply
      

   2. Подтвердите создание ресурсов.

      После этого в указанном каталоге будут созданы все требуемые ресурсы. Проверить появление ресурсов и их настройки можно в консоли управления или с помощью команды CLI:

      yc iot registry list
      

Cоздать реестр можно с помощью метода API create.