Azure CLI kullanarak Azure IoT Edge modülleri dağıtma

Şunun için geçerlidir: IoT Edge 1.6

Önemli

IoT Edge 1.6 LTS desteklenen sürümdür. IoT Edge 1.5 LTS desteği 10 Kasım 2026'da sona erer; IoT Edge 1.4 LTS, 12 Kasım 2024'te ömrünün sonuna ulaştı. Önceki bir sürümü kullanıyorsanız bkz. Update IoT Edge.

İş mantığınızla Azure IoT Edge modülleri oluşturduktan sonra uçta çalışmak üzere bunları cihazlarınıza dağıtın. Verileri toplamak ve işlemek için birden çok modül birlikte çalışıyorsa hepsini bir kerede dağıtın. Bunları bağlayan yönlendirme kurallarını da bildirin.

Azure CLI IoT Edge gibi Azure kaynaklarını yönetmeye yönelik açık kaynaklı, platformlar arası bir komut satırı aracıdır. Azure IoT Hub kaynaklarını, cihaz sağlama hizmeti örneklerini ve bağlı hub'ları kullanıma hazır olarak yönetmenize olanak tanır. Yeni IoT uzantısı, cihaz yönetimi ve tam IoT Edge özellikleri gibi özelliklerle Azure CLI zenginleştirir.

Bu makalede, bir JSON dağıtım bildiriminin nasıl oluşturulacağı ve dağıtımı bir IoT Edge cihaza göndermek için bu dosyanın nasıl kullanılacağı açıklanmaktadır. Paylaşılan etiketlerine göre birden çok cihazı hedefleyen bir dağıtım oluşturma hakkında bilgi için bkz. IoT Edge modüllerini büyük ölçekte dağıtma ve izleme.

Önkoşullar

• Azure aboneliğinizde bir IoT Hub.

• Bir IoT Edge cihazı

  IoT Edge cihazınız yoksa Azure bir sanal makinede bir cihaz oluşturun. Hızlı başlangıç makalelerinden birinde yer alan adımları izleyerek bir sanal Linux cihazı veya bir sanal Windows cihazı oluşturun.

• Ortamınızda Azure CLI kullanın. Azure CLI sürümünüz 2.0.70 veya üzeri olmalıdır. Denetlemek için kullanın az --version . Bu sürüm az extension komutlarını destekler ve Knack komut çerçevesini kullanır.

• Azure CLI için IoT uzantısı

Dağıtım manifestosunu yapılandırın

Dağıtım bildirimi, dağıtılacak modülleri, modüller arasında verilerin nasıl aktığını ve modül ikizlerinin istenen özelliklerini açıklayan bir JSON belgesidir. Dağıtım bildirimlerinin nasıl çalıştığı ve nasıl oluşturulacağı hakkında daha fazla bilgi için bkz. IoT Edge modüllerinin nasıl kullanılabileceğini, yapılandırılabileceğini ve yeniden kullanılabileceğini anlama.

Azure CLI kullanarak modülleri dağıtmak için dağıtım bildirimini yerel olarak .json dosyası olarak kaydedin. Sonraki bölümdeki dosya yolunu kullanarak komutunu çalıştırın ve yapılandırmayı cihazınıza uygulayın.

Örnek olarak tek modül içeren temel bir dağıtım bildirimi aşağıda verilmiştir:

Not

Bu örnek dağıtım bildirimi, IoT Edge aracısı ve hub'ı için şema sürümü 1.1'i kullanır. Şema sürümü 1.1, IoT Edge sürüm 1.0.10 ile birlikte gelir ve modül başlatma sırası ve rota önceliklendirmesi gibi özellikleri etkinleştirir.

{
  "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.6",
                "createOptions": "{}"
              }
            },
            "edgeHub": {
              "type": "docker",
              "status": "running",
              "restartPolicy": "always",
              "settings": {
                "image": "mcr.microsoft.com/azureiotedge-hub:1.6",
                "createOptions": "{\"HostConfig\":{\"PortBindings\":{\"5671/tcp\":[{\"HostPort\":\"5671\"}],\"8883/tcp\":[{\"HostPort\":\"8883\"}],\"443/tcp\":[{\"HostPort\":\"443\"}]}}}"
              }
            }
          },
          "modules": {
            "SimulatedTemperatureSensor": {
              "version": "1.6",
              "type": "docker",
              "status": "running",
              "restartPolicy": "always",
              "settings": {
                "image": "mcr.microsoft.com/azureiotedge-simulated-temperature-sensor:1.6",
                "createOptions": "{}"
              }
            }
          }
        }
      },
      "$edgeHub": {
        "properties.desired": {
          "schemaVersion": "1.1",
          "routes": {
            "upstream": "FROM /messages/* INTO $upstream"
          },
          "storeAndForwardConfiguration": {
            "timeToLiveSecs": 7200
          }
        }
      },
      "SimulatedTemperatureSensor": {
        "properties.desired": {
          "SendData": true,
          "SendInterval": 5
        }
      }
    }
  }
}

Cihazınıza dağıtın

Modül bilgileriyle yapılandırdığınız dağıtım bildirimini uygulayarak modülleri cihazınıza dağıtırsınız.

Dizinleri dağıtım bildiriminizi kaydettiğiniz klasöre değiştirin. Visual Studio Code IoT Edge şablonlarından birini kullandıysanız, deployment.json dosyasını değil çözüm dizininizin config klasöründeki deployment.template.json dosyasını kullanın.

Yapılandırmayı bir IoT Edge cihazına uygulamak için aşağıdaki komutu kullanın:

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

Cihaz kimliği parametresi büyük/küçük harfe duyarlıdır. İçerik parametresi, kaydettiğiniz dağıtım bildirimi dosyasını gösterir.

Cihazınızda modülleri görüntüleme

Modülleri cihazınıza dağıttıktan sonra, aşağıdaki komutla bunların tümünü görüntüleyebilirsiniz:

modülleri IoT Edge cihazınızda görüntüleyin:

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

Cihaz kimliği parametresi büyük/küçük harfe duyarlıdır.

Sonraki adımlar

IoT Edge modüllerini geniş ölçekte kullanıma almayı ve izlemeyi öğrenin