Bagikan melalui

Menyebarkan modul Azure IoT Edge menggunakan Azure CLI

Berlaku untuk:Tanda centang IoT Edge 1.5 IoT Edge 1.5

Penting

IoT Edge 1.5 LTS adalah rilis yang didukung. IoT Edge 1.4 LTS adalah akhir masa pakai per 12 November 2024. Jika Anda menggunakan rilis sebelumnya, lihat Memperbarui IoT Edge.

Setelah membuat modul Azure IoT Edge dengan logika bisnis Anda, terapkan ke perangkat Anda untuk beroperasi di tepi. Jika beberapa modul bekerja sama untuk mengumpulkan dan memproses data, sebarkan semuanya sekaligus. Tentukan aturan perutean yang menghubungkannya juga.

Azure CLI adalah alat baris perintah lintas platform sumber terbuka untuk mengelola sumber daya Azure seperti IoT Edge. Ini memungkinkan Anda mengelola sumber daya Azure IoT Hub, instans layanan provisi perangkat, dan hub tertaut dengan mudah dan cepat. Ekstensi IoT baru memperkaya Azure CLI dengan fitur seperti manajemen perangkat dan kemampuan IoT Edge penuh.

Artikel ini menjelaskan cara membuat manifes penyebaran JSON dan menggunakan file tersebut untuk mendorong penyebaran ke perangkat IoT Edge. Untuk informasi tentang membuat penyebaran yang menargetkan beberapa perangkat berdasarkan tag bersama mereka, lihat Menerapkan dan memantau modul IoT Edge dalam skala besar.

Prasyarat

  • IoT Hub di langganan Azure Anda.

  • Perangkat IoT Edge

    Jika Anda tidak memiliki perangkat IoT Edge yang disiapkan, buat perangkat di komputer virtual Azure. Ikuti langkah-langkah di salah satu artikel mulai cepat untuk membuat perangkat Linux virtual atau membuat perangkat Windows virtual.

  • Azure CLI di lingkungan Anda. Versi Azure CLI Anda harus 2.0.70 atau lebih tinggi. Gunakan az --version untuk memeriksa. Versi ini mendukung perintah ekstensi az dan menggunakan kerangka kerja perintah Knack.

  • Ekstensi IoT untuk Azure CLI

Mengonfigurasi manifes penerapan

Manifes penyebaran adalah dokumen JSON yang menjelaskan modul mana yang akan disebarkan, bagaimana data mengalir di antara modul, dan properti yang diinginkan dari modul twin. Untuk informasi selengkapnya tentang cara kerja manifes penyebaran dan cara membuatnya, lihat memahami bagaimana modul IoT Edge dapat digunakan, dikonfigurasi, dan digunakan kembali.

Untuk menyebarkan modul menggunakan Azure CLI, simpan manifes penyebaran secara lokal sebagai file .json. Gunakan jalur file di bagian berikutnya untuk menjalankan perintah dan menerapkan konfigurasi ke perangkat Anda.

Berikut adalah manifes penyebaran dasar dengan satu modul sebagai contoh:

Catatan

Manifes penyebaran sampel ini menggunakan skema versi 1.1 untuk agen dan hub IoT Edge. Skema versi 1.1 disertakan dengan IoT Edge versi 1.0.10 dan memungkinkan fitur seperti urutan startup modul dan prioritas rute.

{
  "content": {
    "modulesContent": {
      "$edgeAgent": {
        "properties.desired": {
          "schemaVersion": "1.1",
          "runtime": {
            "type": "docker",
            "settings": {
              "minDockerVersion": "v1.25",
              "loggingOptions": "",
              "registryCredentials": {}
            }
          },
          "systemModules": {
            "edgeAgent": {
              "type": "docker",
              "settings": {
                "image": "mcr.microsoft.com/azureiotedge-agent:1.5",
                "createOptions": "{}"
              }
            },
            "edgeHub": {
              "type": "docker",
              "status": "running",
              "restartPolicy": "always",
              "settings": {
                "image": "mcr.microsoft.com/azureiotedge-hub:1.5",
                "createOptions": "{\"HostConfig\":{\"PortBindings\":{\"5671/tcp\":[{\"HostPort\":\"5671\"}],\"8883/tcp\":[{\"HostPort\":\"8883\"}],\"443/tcp\":[{\"HostPort\":\"443\"}]}}}"
              }
            }
          },
          "modules": {
            "SimulatedTemperatureSensor": {
              "version": "1.0",
              "type": "docker",
              "status": "running",
              "restartPolicy": "always",
              "settings": {
                "image": "mcr.microsoft.com/azureiotedge-simulated-temperature-sensor:1.5",
                "createOptions": "{}"
              }
            }
          }
        }
      },
      "$edgeHub": {
        "properties.desired": {
          "schemaVersion": "1.1",
          "routes": {
            "upstream": "FROM /messages/* INTO $upstream"
          },
          "storeAndForwardConfiguration": {
            "timeToLiveSecs": 7200
          }
        }
      },
      "SimulatedTemperatureSensor": {
        "properties.desired": {
          "SendData": true,
          "SendInterval": 5
        }
      }
    }
  }
}

Sebarkan ke perangkat Anda

Anda menyebarkan modul ke perangkat dengan menerapkan manifes penyebaran yang Anda konfigurasi dengan informasi modul.

Ubah direktori ke folder tempat Anda menyimpan manifes penyebaran. Jika Anda menggunakan salah satu templat Visual Studio Code IoT Edge, gunakan deployment.json file di folder konfigurasi direktori solusi Anda dan bukan deployment.template.json file .

Gunakan perintah berikut untuk menerapkan konfigurasi ke perangkat IoT Edge:

az iot edge set-modules --device-id [device id] --hub-name [hub name] --content [file path]

Parameter ID perangkat peka huruf besar/kecil. Parameter konten menunjuk ke file manifes penyebaran yang Anda simpan.

Cuplikan layar memperlihatkan output baris perintah az iot edge set-modules.

Melihat modul di perangkat Anda

Setelah menyebarkan modul ke perangkat, Anda dapat melihat semuanya dengan perintah berikut:

Lihat modul di perangkat IoT Edge Anda:

az iot hub module-identity list --device-id [device id] --hub-name [hub name]

Parameter ID perangkat peka huruf besar/kecil.

Cuplikan layar memperlihatkan output perintah az iot hub module-identity list.

Langkah berikutnya

Pelajari cara Menyebarkan dan memantau modul IoT Edge dalam skala besar

  • Last updated on