Подключиться
Yandex IoT Core

Создание устройства

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

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

    1. В консоли управления выберите каталог, в котором вы хотите создать устройство.
    2. Выберите сервис Yandex IoT Core.
    3. Выберите в списке нужный реестр.
    4. В левой части окна выберите раздел Устройства.
    5. Нажмите кнопку Добавить устройство.
    6. Задайте Базовые параметры устройства:
      • Введите Имя устройства. Например, my-device.
      • (опционально) Добавьте Описание с дополнительной информацией об устройстве.
      • Задайте Пароль, который вы будете использовать для доступа к устройству.
        Для создания пароля можно воспользоваться генератором паролей.
        Не забудьте сохранить пароль, он вам понадобится.
    7. (опционально) Добавьте алиасы:
      1. Нажмите кнопку Добавить алиас.
      2. Заполните поля: введите алиас (например, events) и тип топика после $devices/<deviceID> (например, events).
        Вы сможете использовать алиас events вместо топика $devices/<deviceID>/events.
    8. (опционально) Добавьте сертификаты:
      • Чтобы добавить файл:
        1. Выберите способ Файл.
        2. Нажмите Выбрать файл.
        3. Укажите файл сертификата на вашем компьютере, нажмите Открыть.
        4. Нажмите Добавить.
      • Чтобы добавить текст:
        1. Выберите способ Текст.
        2. Вставьте тело сертификата в поле Содержимое.
        3. Нажмите Добавить.
    9. Нажмите кнопку Добавить.

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

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

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

      $ yc iot device create --registry-name my-registry --name my-device

id: b9135goeh1uc1s2i07nm
registry_id: b91ki3851hab9m0l68je
created_at: "2019-05-28T16:08:30.938Z"
name: my-device
      • Длина — от 3 до 63 символов.
      • Может содержать строчные буквы латинского алфавита, цифры и дефисы.
      • Первый символ — буква. Последний символ — не дефис.

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

      $ yc iot device list --registry-name  my-registry
+----------------------+-----------+
|          ID          |   NAME    |
+----------------------+-----------+
| b9135goeh1uc1s2i07nm | my-device |
+----------------------+-----------+

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

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

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

    Примечание

    Чтобы добавить сертификаты устройству, подготовьте их заранее.

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

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

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

      • 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("<путь к файлу c сертификатом>")
  ]
}

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

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

      1. В командной строке перейдите в папку, где вы создали конфигурационный файл.
      2. Выполните проверку с помощью команды: 
        $ terraform plan

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

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

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

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