Создание реестра
-
В консоли управления
выберите каталог, в котором вы хотите создать реестр. -
Выберите сервис IoT Core.
-
На панели слева выберите иконку Реестры.
-
Нажмите кнопку Создать реестр.
-
В блоке Общая информация добавьте:
-
Имя реестра. Например,
my-registry
. -
(Опционально) Описание с дополнительной информацией о реестре.
-
Пароль, который вы будете использовать для доступа к реестру. Для создания пароля можно воспользоваться генератором паролей
.Примечание
Сохраните пароль, он понадобится вам для аутентификации.
-
(Опционально) Для присвоения реестру метки заполните поля Ключ и Значение и нажмите кнопку Добавить метку.
-
-
(Опционально) Добавьте сертификат:
-
Чтобы добавить файл:
- Выберите способ
Файл
. - Нажмите кнопку Прикрепить файл.
- Выберите файл с публичным ключом сертификата и нажмите кнопку Открыть.
- Нажмите кнопку Добавить.
- Выберите способ
-
Чтобы добавить текст:
- Выберите способ
Текст
. - Вставьте публичный ключ сертификата в поле Содержимое.
- Нажмите кнопку Добавить.
- Выберите способ
-
-
Нажмите кнопку Создать.
Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.
По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name
или --folder-id
.
-
Создайте реестр:
yc iot registry create --name <имя_реестра>
Требования к названию реестра:
- длина — от 3 до 63 символов;
- может содержать строчные буквы латинского алфавита, цифры и дефисы;
- первый символ — буква, последний — не дефис.
Результат:
id: b91hafek85********** folder_id: aoek49ghmk********* created_at: "2019-05-27T13:40:06.923Z" name: <имя_реестра> status: ACTIVE log_group_id: ckghotead**********
-
(Опционально) Присвойте реестру пароль для аутентификации с помощью логина и пароля:
yc iot registry password add --registry-name <имя_реестра>
Команда предложит ввести пароль. Требования к паролю:
- пароль должен содержать цифры, буквы в верхнем и нижнем регистре, специальные символы;
- длина пароля — не менее 14 символов.
Результат:
registry_id: b91hafek85********** id: aoek49ghmk********* created_at: "2019-05-27T13:44:06.923Z"
-
(Опционально) Добавьте реестру сертификат для аутентификации с помощью сертификатов:
yc iot registry certificate add \ --registry-name <имя_реестра> \ --certificate-file <сертификат>
Где:
--registry-name
— имя реестра;--certificate-file
— путь к публичному ключу сертификата, напримерcert.pem
.
Результат:
registry_id: b91hafek85********** fingerprint: 589ce16050**** certificate_data: | -----BEGIN CERTIFICATE----- MIIE/jCCAuagAwIBAgIJAPRA... -----END CERTIFICATE----- created_at: "2019-05-27T13:41:45.295Z"
Terraform
Terraform распространяется под лицензией Business Source License
Подробную информацию о ресурсах провайдера смотрите в документации на сайте Terraform
Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.
Примечание
Чтобы добавить сертификаты реестру, подготовьте их заранее.
Чтобы создать реестр устройств:
-
Опишите в конфигурационном файле параметры ресурса, который необходимо создать:
-
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, см. в документации провайдера
. -
-
Проверьте корректность конфигурационных файлов.
-
В командной строке перейдите в папку, где вы создали конфигурационный файл.
-
Выполните проверку с помощью команды:
terraform plan
Если конфигурация описана верно, в терминале отобразится список создаваемых ресурсов и их параметров. Если в конфигурации есть ошибки, Terraform на них укажет.
-
-
Разверните облачные ресурсы.
-
Если в конфигурации нет ошибок, выполните команду:
terraform apply
-
Подтвердите создание ресурсов.
После этого в указанном каталоге будут созданы все требуемые ресурсы. Проверить появление ресурсов и их настройки можно в консоли управления
или с помощью команды CLI:yc iot registry list
-
Чтобы создать реестр, воспользуйтесь методом REST API create для ресурса Registry или вызовом gRPC API RegistryService/Create.