Создание устройства
-
В консоли управления
выберите каталог, в котором вы хотите создать устройство. -
Выберите сервис IoT Core.
-
Выберите в списке нужный реестр.
-
В левой части окна выберите раздел Устройства.
-
Нажмите кнопку Добавить устройство.
-
В блоке Общая информация добавьте:
-
Имя устройства. Например,
my-device
. -
(Опционально) Описание с дополнительной информацией об устройстве.
-
(Опционально) Пароль, который вы будете использовать для доступа к устройству. Для создания пароля можно воспользоваться генератором паролей
.Примечание
Сохраните пароль, он вам понадобится для аутентификации.
-
-
(Опционально) Добавьте алиасы:
- Нажмите кнопку Добавить алиас.
- Заполните поля: введите алиас (например,
events
) и тип топика после$devices/<идентификатор_устройства>
(например,events
). Вы сможете использовать алиасevents
вместо топика$devices/<идентификатор_устройства>/events
.
-
(Опционально) Добавьте сертификат:
-
Чтобы добавить файл:
- Выберите способ
Файл
. - Нажмите кнопку Прикрепить файл.
- Выберите файл с публичным ключом сертификата и нажмите кнопку Открыть.
- Нажмите кнопку Добавить.
- Выберите способ
-
Чтобы добавить текст:
- Выберите способ
Текст
. - Вставьте публичный ключ сертификата в поле Содержимое.
- Нажмите кнопку Добавить.
- Выберите способ
-
-
Нажмите кнопку Создать.
Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.
-
Посмотрите список реестров, в которых можно создать устройство, или создайте новый реестр.
-
Создайте устройство:
yc iot device create \ --registry-name <имя_реестра> \ --name <имя_устройства>
Требования к названию устройства:
- длина — от 3 до 63 символов;
- может содержать строчные буквы латинского алфавита, цифры и дефисы;
- первый символ — буква, последний — не дефис.
Результат:
id: b9135goeh********** registry_id: b91ki3851h********** created_at: "2019-05-28T16:08:30.938Z" name: <имя_устройства> status: ACTIVE
-
(Опционально) Присвойте устройству пароль для аутентификации с помощью логина и пароля:
yc iot device password add --device-name <имя_устройства>
Команда предложит ввести пароль. Требования к паролю:
- пароль должен содержать цифры, буквы в верхнем и нижнем регистре, специальные символы;
- длина пароля — не менее 14 символов.
Результат:
device_id: b9135goeh********** id: aoek49ghmk********* created_at: "2019-05-28T16:12:30.938Z"
-
(Опционально) Добавьте реестру сертификат для аутентификации с помощью сертификатов:
yc iot device certificate add \ --device-name <имя_устройства> \ --certificate-file <сертификат>
Где:
--device-name
— имя устройства;--certificate-file
— путь к публичному ключу сертификата, напримерcert.pem
.
Результат:
device_id: b9135goeh********** fingerprint: 589ce16050**** certificate_data: | -----BEGIN CERTIFICATE----- MIIE/jCCAuagAwIBAgIJAPRA... -----END CERTIFICATE----- created_at: "2019-05-28T16:15:30.938Z"
-
(Опционально) Добавьте алиасы:
yc iot device add-topic-aliases \ --name <имя_устройства> \ --topic-aliases <алиас>='<топик>'
Пример:
yc iot device add-topic-aliases \ --name my-device \ --topic-aliases events='$devices/are0ej5kpik1********/events'
Результат:
id: aoek49ghmk********* registry_id: b91ki3851h********** created_at: "2019-05-28T16:17:30.938Z" name: <имя_устройства> topic_aliases: <алиас>: <топик> status: ACTIVE
Terraform
Terraform распространяется под лицензией Business Source License
Подробную информацию о ресурсах провайдера смотрите в документации на сайте Terraform
Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.
Примечание
Чтобы добавить сертификаты устройству, подготовьте их заранее.
Чтобы создать устройство:
-
Посмотрите список реестров, в которых можно создать устройство, или создайте новый реестр.
-
Опишите в конфигурационном файле параметры ресурса, который необходимо создать:
-
yandex_iot_core_device
— параметры устройства:registry_id
— идентификатор реестра, в котором создается устройство.name
— имя устройства.description
— описание устройства.aliases
— алиасы топиков. Подробнее см. Создание алиаса.passwords
— список паролей для аутентификации с помощью логина и пароля.certificates
— список сертификатов для аутентификации с помощью сертификатов.
Примечание
Используйте только один из двух способов аутентификации.
Пример структуры ресурса в конфигурационном файле:
resource "yandex_iot_core_device" "my_device" { registry_id = "<идентификатор_реестра>" name = "test-device" description = "test device for terraform provider documentation" aliases = { "some-alias1/subtopic" = "$devices/{id}/events/somesubtopic", "some-alias2/subtopic" = "$devices/{id}/events/aaa/bbb", } passwords = [ "<пароль>", ] certificates = [ file("<путь_к_файлу_с_сертификатом>") ] }
Более подробную информацию о ресурсах, которые вы можете создать с помощью Terraform, см. в документации провайдера
. -
-
Проверьте корректность конфигурационных файлов.
- В командной строке перейдите в папку, где вы создали конфигурационный файл.
- Выполните проверку с помощью команды:
terraform plan
Если конфигурация описана верно, в терминале отобразится список создаваемых ресурсов и их параметров. Если в конфигурации есть ошибки, Terraform на них укажет.
-
Разверните облачные ресурсы.
- Если в конфигурации нет ошибок, выполните команду:
terraform apply
- Подтвердите создание ресурсов.
После этого в указанном каталоге будут созданы все требуемые ресурсы. Проверить появление ресурсов и их настройки можно в консоли управления
. - Если в конфигурации нет ошибок, выполните команду:
Чтобы создать устройство, воспользуйтесь методом REST API create для ресурса Device или вызовом gRPC API DeviceService/Create.