Öğretici: IoT Tak Çalıştır hızlı başlangıçları ve öğreticileri için ortamınızı ayarlama

IoT Tak Çalıştır hızlı başlangıç ve öğreticilerinden herhangi birini tamamlayabilmeniz için önce Azure aboneliğinizde bir IoT hub'ı ve Cihaz Sağlama Hizmeti'ni (DPS) yapılandırmanız gerekir. Örnek uygulamalar ve Azure IoT gezgini aracı tarafından kullanılan model dosyalarının yerel kopyalarına da ihtiyacınız olacaktır.

Önkoşullar

Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.

Ortamınızı Azure CLI’ye hazırlama

  • Azure Cloud Shell'de Bash ortamını kullanın. Daha fazla bilgi için bkz . Azure Cloud Shell'de Bash için hızlı başlangıç.

  • CLI başvuru komutlarını yerel olarak çalıştırmayı tercih ediyorsanız Azure CLI'yı yükleyin . Windows veya macOS üzerinde çalışıyorsanız Azure CLI’yi bir Docker kapsayıcısında çalıştırmayı değerlendirin. Daha fazla bilgi için bkz . Docker kapsayıcısında Azure CLI'yi çalıştırma.

    • Yerel yükleme kullanıyorsanız az login komutunu kullanarak Azure CLI ile oturum açın. Kimlik doğrulama işlemini tamamlamak için terminalinizde görüntülenen adımları izleyin. Diğer oturum açma seçenekleri için bkz . Azure CLI ile oturum açma.

    • İstendiğinde, ilk kullanımda Azure CLI uzantısını yükleyin. Uzantılar hakkında daha fazla bilgi için bkz. Azure CLI ile uzantıları kullanma.

    • Yüklü sürümü ve bağımlı kitaplıkları bulmak için az version komutunu çalıştırın. En son sürüme yükseltmek için az upgrade komutunu çalıştırın.

Kaynakları oluşturma

Kaynaklar için bir Azure kaynak grubu oluşturun:

az group create --name my-pnp-resourcegroup --location centralus

Bir IoT hub'ı oluşturun. Aşağıdaki komut, oluşturulacak IoT hub'ının adı için örnek olarak adını kullanır my-pnp-hub . IoT hub'ınız için yerine kullanılacak my-pnp-hubbenzersiz bir ad seçin:

az iot hub create --name my-pnp-hub --resource-group my-pnp-resourcegroup --sku F1 --partition-count 2

BIR DPS örneği oluşturun. Aşağıdaki komut, oluşturulacak DPS örneğinin adı için örnek olarak adını kullanır my-pnp-dps . DPS örneğiniz için yerine kullanılacak my-pnp-dpsbenzersiz bir ad seçin:

az iot dps create --name my-pnp-dps --resource-group my-pnp-resourcegroup

DPS örneğini IoT hub'ınıza bağlamak için aşağıdaki komutları kullanın. ve my-pnp-hub değerini daha önce seçtiğiniz benzersiz adlarla değiştirinmy-pnp-dps:

hubConnectionString=$(az iot hub connection-string show -n my-pnp-hub --key primary --query connectionString -o tsv)
az iot dps linked-hub create --dps-name my-pnp-dps --resource-group my-pnp-resourcegroup --location centralus --connection-string $hubConnectionString

Ayarları alma

Bazı hızlı başlangıçlar ve öğreticilerde IoT hub'ınız için bağlantı dizesi kullanılır. Azure IoT gezgini aracını ayarlarken de bağlantı dizesi gerekir. bağlantı dizesi alın ve şimdi not alın. değerini IoT hub'ınız için seçtiğiniz benzersiz adla değiştirin my-pnp-hub :

az iot hub connection-string show -n my-pnp-hub --key primary --query connectionString

Hızlı başlangıçların ve öğreticilerin çoğu DPS yapılandırmanızın kimlik kapsamını kullanır. Kimlik kapsamını alın ve şimdi not alın. değerini DPS örneğin için seçtiğiniz benzersiz adla değiştirin my-pnp-dps :

az iot dps show --name my-pnp-dps --query properties.idScope

Tüm hızlı başlangıçlar ve öğreticiler bir DPS cihaz kaydı kullanır. DPS örneğinizde tek bir my-pnp-devicecihaz kaydı oluşturmak için aşağıdaki komutu kullanın. değerini DPS örneğin için seçtiğiniz benzersiz adla değiştirin my-pnp-dps . Hızlı başlangıçlarda ve öğreticilerde kullanılacak kayıt kimliğini ve birincil anahtar değerlerini not edin:

az iot dps enrollment create --attestation-type symmetrickey --dps-name my-pnp-dps --resource-group my-pnp-resourcegroup --enrollment-id my-pnp-device --device-id my-pnp-device --query '{registrationID:registrationId,primaryKey:attestation.symmetricKey.primaryKey}'

Ortam değişkenlerini oluşturma

IoT hub'ınıza bağlanmak için Cihaz Sağlama Hizmeti'ni (DPS) kullanmak üzere hızlı başlangıç ve öğreticilerdeki örnekleri yapılandırmak için beş ortam değişkeni oluşturun:

  • IOTHUB_DEVICE_SECURITY_TYPE: değeriDPS.
  • IOTHUB_DEVICE_DPS_ID_SCOPE: Daha önce not aldığınız DPS kimliği kapsamı.
  • IOTHUB_DEVICE_DPS_DEVICE_ID: değerimy-pnp-device.
  • IOTHUB_DEVICE_DPS_DEVICE_KEY: Daha önce not aldığınız kayıt birincil anahtarı.
  • IOTHUB_DEVICE_DPS_ENDPOINT: değerglobal.azure-devices-provisioning.net

Hizmet örnekleri, bağlanacak hub'ı ve cihazı tanımlamak için aşağıdaki ortam değişkenlerine ihtiyaç duyar:

  • IOTHUB_CONNECTION_STRING: Daha önce not aldığınız IoT hub'ı bağlantı dizesi.
  • IOTHUB_DEVICE_ID: my-pnp-device.

Örneğin, Linux bash kabuğunda:

export IOTHUB_DEVICE_SECURITY_TYPE="DPS"
export IOTHUB_DEVICE_DPS_ID_SCOPE="<Your ID scope>"
export IOTHUB_DEVICE_DPS_DEVICE_ID="my-pnp-device"
export IOTHUB_DEVICE_DPS_DEVICE_KEY="<Your enrolment primary key>"
export IOTHUB_DEVICE_DPS_ENDPOINT="global.azure-devices-provisioning.net"
export IOTHUB_CONNECTION_STRING="<Your IoT hub connection string>"
export IOTHUB_DEVICE_ID="my-pnp-device"

Örneğin, Windows komut satırında:

set IOTHUB_DEVICE_SECURITY_TYPE=DPS
set IOTHUB_DEVICE_DPS_ID_SCOPE=<Your ID scope>
set IOTHUB_DEVICE_DPS_DEVICE_ID=my-pnp-device
set IOTHUB_DEVICE_DPS_DEVICE_KEY=<Your enrolment primary key>
set IOTHUB_DEVICE_DPS_ENDPOINT=global.azure-devices-provisioning.net
set IOTHUB_CONNECTION_STRING=<Your IoT hub connection string>
set IOTHUB_DEVICE_ID=my-pnp-device

Model dosyalarını indirme

Hızlı başlangıçlar ve öğreticiler, sıcaklık denetleyicisi ve termostat cihazları için örnek model dosyalarını kullanır. Örnek model dosyalarını indirmek için:

  1. Yerel makinenizde modeller adlı bir klasör oluşturun.

  2. TemperatureController.json sağ tıklayın ve JSON dosyasını models klasörüne kaydedin.

  3. Thermostat.json sağ tıklayın ve JSON dosyasını models klasörüne kaydedin.

Azure IoT gezginini yükleme

Hızlı başlangıçlar ve öğreticiler Azure IoT gezgini aracını kullanır. Azure IoT gezgini sürümlerine gidin ve en son sürümün varlık listesini genişletin. İşletim sisteminiz için uygulamanın en son sürümünü indirin ve yükleyin.

Aracı ilk kez çalıştırdığınızda IoT hub bağlantı dizesi istenir. Daha önce not aldığınız bağlantı dizesi kullanın.

Aracı daha önce indirdiğiniz model dosyalarını kullanacak şekilde yapılandırın. Araçtaki giriş sayfasından IoT Tak Çalıştır Ayarlar ve ardından + Yerel klasör ekle'yi > seçin. Daha önce oluşturduğunuz modeller klasörünü seçin. Ardından, ayarları kaydetmek için Kaydet'i seçin.

Daha fazla bilgi edinmek için bkz . Azure IoT gezginini yükleme ve kullanma.

Kaynakları temizleme

Tüm IoT Tak Çalıştır hızlı başlangıçları ve öğreticileri için IoT hub'ını ve DPS örneğini kullanabilirsiniz, bu nedenle bu makaledeki adımları yalnızca bir kez tamamlamanız yeterlidir. İşiniz bittiğinde, bunları aşağıdaki komutla aboneliğinizden kaldırabilirsiniz:

az group delete --name my-pnp-resourcegroup

Sonraki adımlar

Artık ortamınızı ayarladığınıza göre, aşağıdaki gibi hızlı başlangıçlardan veya öğreticilerden birini deneyebilirsiniz: