مشاركة عبر

التشغيل السريع: إعداد خدمة توفير جهاز IoT Hub (DPS) باستخدام Bicep

يمكنك استخدام ملف Bicep لإعداد موارد سحابة Azure الضرورية لتوفير أجهزتك برمجيا. توضح هذه الخطوات كيفية إنشاء مركز IoT ومثيل خدمة توفير جهاز IoT Hub جديد مع ملف Bicep. يرتبط مركز IoT أيضا بمورد DPS باستخدام ملف Bicep. يسمح هذا الارتباط للمورد DPS بتعيين أجهزة إلى لوحة الوصل استنادًا إلى نهج التخصيص التي تقوم بتكوينها.

Bicep هي لغة المجال المخصصة (DSL) التي تستخدم بناء الجملة التعريفي لتوزيع موارد Azure. توفر بناء جملة مختصر، وسلامة موثوقة من النوع، ودعمًا لإعادة استخدام التعليمة البرمجية. تقدم Bicep أفضل تجربة تأليف لحلول البنية الأساسية باعتبارها تعليمة برمجية في Azure.

يستخدم هذا التشغيل السريع Azure PowerShell وAzure CLI لتنفيذ الخطوات البرمجية اللازمة لإنشاء مجموعة موارد ونشر ملف Bicep، ولكن يمكنك بسهولة استخدام .NET أو Ruby أو لغات برمجة أخرى لتنفيذ هذه الخطوات ونشر ملف Bicep الخاص بك.

المتطلبات الأساسية

إذا لم يكن لديك حساب Azure، فأنشئ حساباً مجانياً قبل أن تبدأ.

مراجعة ملف Bicep

ملف Bicep المستخدم في هذا التشغيل السريع مأخوذ من قوالب التشغيل السريع لـ Azure.

إشعار

حاليا لا يوجد دعم ملف Bicep لإنشاء عمليات تسجيل باستخدام موارد DPS جديدة. وهذا طلب شائع ومفهوم يجري النظر في تنفيذه.

@description('Specify the name of the Iot hub.')
param iotHubName string

@description('Specify the name of the provisioning service.')
param provisioningServiceName string

@description('Specify the location of the resources.')
param location string = resourceGroup().location

@description('The SKU to use for the IoT Hub.')
param skuName string = 'S1'

@description('The number of IoT Hub units.')
param skuUnits int = 1

var iotHubKey = 'iothubowner'

resource iotHub 'Microsoft.Devices/IotHubs@2021-07-02' = {
  name: iotHubName
  location: location
  sku: {
    name: skuName
    capacity: skuUnits
  }
  properties: {}
}

resource provisioningService 'Microsoft.Devices/provisioningServices@2022-02-05' = {
  name: provisioningServiceName
  location: location
  sku: {
    name: skuName
    capacity: skuUnits
  }
  properties: {
    iotHubs: [
      {
        connectionString: 'HostName=${iotHub.properties.hostName};SharedAccessKeyName=${iotHubKey};SharedAccessKey=${iotHub.listkeys().value[0].primaryKey}'
        location: location
      }
    ]
  }
}

يتم تعريف موردين من موارد Azure في ملف Bicep أعلاه:

احفظ نسخة من ملف Bicep محليا ك main.bicep.

نشر ملف Bicep

سجل الدخول إلى حسابك في Azure، وحدد اشتراكك.

  1. سجل الدخول إلى Azure في موجه الأوامر:

    اتبع الإرشادات للمصادقة باستخدام التعليمات البرمجية، ثم قم بتسجيل الدخول إلى حسابك في Azure من خلال مستعرض ويب.

  2. إذا كان لديك العديد من اشتراكات Azure، فإن تسجيل الدخول إلى Azure يمنحك حق الوصول إلى كافة حسابات Azure المقترنة ببيانات الاعتماد الخاصة بك.

    az account list -o table

    استخدم الأمر التالي لتحديد الاشتراك الذي تريد استخدامه لتشغيل الأوامر لإنشاء مركز IoT وموارد DPS. يمكنك استخدام اسم الاشتراك، أو معرف ID من إخراج الأمر السابق:

    az account set --subscription {your subscription name or id}

  3. انشر ملف Bicep بالأوامر التالية.

    تلميح

    سوف يطالب الأوامر لموقع مجموعة موارد. يمكنك عرض قائمة بالمواقع المتوفرة عن طريق تشغيل الأمر أولاً:

    az account list-locations -o table

    az group create --name exampleRG --location eastus
az deployment group create --resource-group exampleRG --template-file main.bicep --parameters iotHubName={IoT-Hub-name} provisioningServiceName={DPS-name}

    استبدل {IoT-Hub-name} باسم IoT Hub فريد عالميا، واستبدل {DPS-name} باسم مورد خدمة توفير الأجهزة (DPS) فريدا عالميا.

    يستغرق إنشاء الموارد بضع لحظات.

مراجعة الموارد الموزعة

  1. للتحقق من النشر، قم بتشغيل الأمر التالي وابحث عن خدمة التوفير الجديدة ومركز IoT في الإخراج:

     az resource list -g exampleRg

  2. للتحقق من أن المركز مرتبط بالفعل بمورد DPS، قم بتشغيل الأمر التالي.

    az iot dps show --name <Your provisioningServiceName>

تنظيف الموارد

تعتمد قوالب التشغيل السريع الأخرى في هذه المجموعة على هذا التشغيل السريع. إذا كنت تخطط لمواصلة العمل مع قوالب التشغيل السريع اللاحقة أو مع البرامج التعليمية، فلا تنظف الموارد التي تم إنشاؤها في هذا التشغيل السريع. إذا كنت لا تخطط للمتابعة، يمكنك استخدام Azure PowerShell أو Azure CLI لحذف مجموعة الموارد وجميع مواردها.

لحذف مجموعة موارد وجميع مواردها من مدخل Microsoft Azure، ما عليك سوى فتح مجموعة الموارد وتحديد حذف مجموعة الموارد والأعلى.

لحذف مجموعة الموارد المنشورة:

az group delete --name exampleRG

يمكنك أيضا حذف مجموعات الموارد والموارد الفردية باستخدام مدخل Microsoft Azure أو PowerShell أو واجهات برمجة تطبيقات REST أو مع SDKs للنظام الأساسي المدعوم.

الخطوات التالية

في هذا التشغيل السريع، قمت بنشر مركز IoT ومثيل خدمة توفير الأجهزة، وربطت الموردين. لمعرفة كيفية استخدام هذا الإعداد لتوفير جهاز، تابع التشغيل السريع لإنشاء جهاز.

التشغيل السريع: توفير جهاز مفتاح متماثل مُحاكي

  • Last updated on