Simetrik anahtarları kullanarak Linux üzerinde IoT Edge cihazı oluşturma ve sağlama

Azure aboneliğinizde ücretsiz veya standart bir IoT hub'ı .

• Azure aboneliğinizde ücretsiz veya standart bir IoT hub'ı
• Visual Studio Code
• Azure IoT Edge uzantısı. Visual Studio Code uzantısı için Azure IoT Edge araçları bakım modundadır.
• Azure IoT Hub uzantısı

• Azure aboneliğinizde ücretsiz veya standart bir IoT hub'ı

• Ortamınızda Azure CLI

  Azure CLI sürümünüz en az 2.0.70 veya daha yeni olmalıdır. Doğrulamak için az --version kullanın. Bu sürüm uzantı komutlarını destekler az ve Knack komut çerçevesini tanıtır.

Azure portalındaki IoT hub'ınızda IoT Edge cihazları, edge etkin olmayan IoT cihazlarından ayrı olarak oluşturulur ve yönetilir.

1. Azure portalında oturum açın ve IoT hub'ınıza gidin.

2. Sol bölmede menüden Cihazlar'ı ve ardından Cihaz Ekle'yi seçin.

3. Cihaz oluştur sayfasında aşağıdaki bilgileri sağlayın:

   • Açıklayıcı bir Cihaz Kimliği oluşturun, örneğin my-edge-device-1 (tümü küçük harf). Daha sonra kullanacağınız için bu Cihaz Kimliğini kopyalayın.
   • IoT Edge Cihazı onay kutusunu işaretleyin.
   • Kimlik doğrulama türü olarak Simetrik anahtar'ı seçin.
   • Yeni cihazı hub'ınıza bağlayan kimlik doğrulama anahtarlarını otomatik olarak oluşturmak için varsayılan ayarları kullanın.

4. Kaydet'i seçin.

Yeni cihazınızın IoT hub'ınızda listelendiğini görmeniz gerekir.

Azure'da oturum açma

IoT hub'ınızla işlem gerçekleştirmek için Visual Studio Code için Azure IoT uzantılarını kullanabilirsiniz. Azure IoT uzantısı önkoşullarını yüklediğinizden emin olun.

Azure IoT Edge ve Azure IoT Hub uzantıları yüklendikten sonra, sol simge menüsüne bir Azure simgesi eklendiğini fark edeceksiniz. Azure simgesini ve ardından Azure'da oturum aç'ı seçerek Visual Studio Code aracılığıyla Azure hesabınızda oturum açabilirsiniz.

Visual Studio Code ile yeni bir cihaz kaydetme

Yeni bir cihaz kaydetmek, Azure portalında ioT Edge cihazı oluşturmaya yöneliktir. Bu sanal cihaz ikizlerden biridir, gerçek cihaz ise diğer ikizdir. Visual Studio Code, aşağıdaki adımları izleyerek bunu sizin için ayarlayabilir.

1. Visual Studio Code Gezgini menüsünde Azure IoT Hub bölümünü genişletin.
2. Azure IoT Hub bölüm üst bilgisindeki ... öğesini seçin. Üç noktayı görmüyorsanız üst bilgiyi seçin veya üzerine gelin.
3. IoT Edge Cihazı Oluştur'u seçin.
4. Açılan metin kutusunda, cihazınıza örneğin (tümü küçük harf) bir kimlik my-edge-device-1 verin ve enter tuşuna basın.

Visual Studio Code'un çıkış konsolunda komutun sonucunu görürsünüz: JSON çıktısı. Cihaz bilgileri, sağladığınız deviceId değerini içerir ve fiziksel cihazınızı IoT hub'ınıza bağlamak için kullanabileceğiniz bir connectionString oluşturur. Çıkış konsolu, anahtarlarınızı ve diğer cihaz tanımlama bilgilerini de gösterir.

Artık cihazınızı Gezgin menüsünün Azure IoT Hub>Cihazları bölümünde görebilirsiniz.

IoT hub'ınızda yeni bir cihaz kimliği oluşturmak için az iot hub device-identity create komutunu kullanın. değerini kendi yeni ve benzersiz cihaz kimliğinizle değiştirin device_id_here ( örneğin my-edge-device-1 , tümü küçük harf). değerini mevcut IoT hub'ınızla değiştirin hub_name_here .

Bu komut üç parametre içerir:

• --device-id veya -d: IoT hub'ınızda benzersiz olan açıklayıcı bir ad sağlayın.

• --hub-name veya -n: IoT hub'ınızın adını belirtin.

• --edge-enabled veya --ee: Cihazın bir IoT Edge cihazı olduğunu bildirin.

  az iot hub device-identity create --device-id device_id_here --hub-name hub_name_here --edge-enabled
  

CLI'nız Komutun azure-iot uzantısını gerektirdiğini söylüyorsa . Şimdi yüklemek istiyor musunuz?, ardından yazın Y ve cihazınızı oluşturmak üzere indirmeyi başlatmak için basın Enter .

IoT hub'ınıza bağlanan uç özellikli cihazlar, IoT hub'ınızın Cihazlar sayfasında listelenir. Birden çok cihazınız varsa Iot Edge Cihazları türünü seçip Uygula'yı seçerek listeyi filtreleyebilirsiniz.

Cihazınızı ayarlamaya hazır olduğunuzda, fiziksel cihazınızı IoT hub'ında kimliğine bağlayan bağlantı dizesi gerekir. Simetrik anahtarlarla kimlik doğrulaması yapılan cihazların bağlantı dizesi portalda kopyalanabilir. portalda bağlantı dizesi bulmak için:

1. Cihazlar sayfasından listeden IoT Edge cihaz kimliğini seçin.
2. Birincil Bağlantı Dizesi veya İkincil Bağlantı Dizesi değerini kopyalayın. her iki anahtar da çalışır.

IoT hub'ınıza bağlanan tüm cihazlar Visual Studio Code Explorer'ın Azure IoT Hub bölümünde listelenir. IoT Edge cihazları, farklı bir simgeye sahip olduklarından ve her IoT Edge cihazına $edgeAgent ve $edgeHub modüllerinin dağıtıldığından Edge dışı cihazlardan ayırt edilebilir.

Cihazınızı ayarlamaya hazır olduğunuzda, fiziksel cihazınızı IoT hub'ında kimliğine bağlayan bağlantı dizesi gerekir. Visual Studio Code'dan bağlantı dizesi alma burada anlatılmaktadır.

1. Azure IoT Hub bölümünde cihazınızın kimliğine (adı) sağ tıklayın.

2. Cihaz Bağlantı Dizesini Kopyala'yı seçin.

   bağlantı dizesi panonuza kopyalanır.

Çıkış penceresinde bağlantı dizesi dahil olmak üzere tüm cihaz bilgilerini görmek için sağ tıklama menüsünden Cihaz Bilgilerini Al'ı da seçebilirsiniz.

IoT hub'ınızdaki tüm cihazları görmek için az iot hub device-identity list komutunu kullanın. değerini kendi IoT hub'ınızın adıyla değiştirin hub_name_here .

az iot hub device-identity list --hub-name hub_name_here

IoT Edge cihazı olarak kaydedilen tüm cihazlarda capabilities.iotEdge özelliği true olarak ayarlanır. Cihaz kimlikleriniz de dahil olmak üzere JSON çıkışı olarak birçok meta veri görürsünüz.

Cihazınızı ayarlamaya hazır olduğunuzda, fiziksel cihazınızı IoT hub'ında kimliğine bağlayan bağlantı dizesi gerekir. Tek bir cihazın bağlantı dizesi döndürmek için aşağıdaki az iot hub device-identity connection-string show komutunu kullanın. ve [hub_name] değerlerini kendi değerlerinizle değiştirin[device_id]. parametresinin device-identity değeri büyük/küçük harfe duyarlıdır.

az iot hub device-identity connection-string show --device-id [device_id] --hub-name [hub_name]

Konsolda aşağıdakine benzer şekilde JSON çıkışı görmeniz gerekir:

{
  "connectionString": "HostName=[hub_name].azure-devices.net;DeviceId=[device_id];SharedAccessKey=[device_key]"
}

cihazda kullanmak üzere bağlantı dizesi kopyalarken, bağlantı dizesi çevresinde tırnak işaretlerini eklemeyin.

Yükleme birkaç komutla yapılabilir. Bir terminal açın ve aşağıdaki komutları çalıştırın:

• 22.04:

  wget https://packages.microsoft.com/config/ubuntu/22.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
  sudo dpkg -i packages-microsoft-prod.deb
  rm packages-microsoft-prod.deb
  

• 20.04:

  wget https://packages.microsoft.com/config/ubuntu/20.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
  sudo dpkg -i packages-microsoft-prod.deb
  rm packages-microsoft-prod.deb
  

APT ile yükleme birkaç komutla yapılabilir. Bir terminal açın ve aşağıdaki komutları çalıştırın:

• 11 - Bullseye (arm32v7):

  curl https://packages.microsoft.com/config/debian/11/packages-microsoft-prod.deb > ./packages-microsoft-prod.deb
  sudo apt install ./packages-microsoft-prod.deb
  

Yükleme birkaç komutla yapılabilir. Bir terminal açın ve aşağıdaki komutları çalıştırın:

• 9.x (amd64):

    wget https://packages.microsoft.com/config/rhel/9.0/packages-microsoft-prod.rpm -O packages-microsoft-prod.rpm
    sudo yum localinstall packages-microsoft-prod.rpm
    rm packages-microsoft-prod.rpm
  

• 8.x (amd64):

    wget https://packages.microsoft.com/config/rhel/8/packages-microsoft-prod.rpm -O packages-microsoft-prod.rpm
    sudo yum localinstall packages-microsoft-prod.rpm
    rm packages-microsoft-prod.rpm
  

IoT Edge çalışma zamanını sonraki bir adımda ek bileşen deposundan yükleyebilirsiniz. Sonraki bölüme geçin.

Moby motorunu yükleyin.

sudo apt-get update; \
  sudo apt-get install moby-engine

Moby motorunu yükleyin.

sudo apt-get update; \
  sudo apt-get install moby-engine

Moby altyapısını ve CLI'yi yükleyin.

sudo yum install moby-engine moby-cli

curl -ssl https://raw.githubusercontent.com/moby/moby/master/contrib/check-config.sh -o check-config.sh
chmod +x check-config.sh
./check-config.sh

IoT Edge'in Docker ve IoT Kimlik Hizmeti'ne bağımlılıkları vardır. Aşağıdaki komutları kullanarak bağımlılıkları yükleyin:

sudo snap install docker
sudo snap install azure-iot-identity

Docker snap canonical tarafından sağlanır ve üretim senaryoları için desteklenir.

1. Mevcut Docker daemon'un yapılandırma dosyasını oluşturma veya düzenleme

   sudo nano /etc/docker/daemon.json
   

2. Varsayılan günlük sürücüsünü local örnekte gösterildiği gibi günlük sürücüsüne ayarlayın.

      {
         "log-driver": "local"
      }
   

3. Değişikliklerin etkili olması için kapsayıcı altyapısını yeniden başlatın.

   sudo systemctl restart docker
   

Şu anda Docker snap için yerel günlük sürücüsü ayarı desteklenmiyor.

IoT Edge'in en son sürümünü ve IoT kimlik hizmeti paketini yükleyin (henüz güncel değilseniz):

• 22.04:

  sudo apt-get update; \
     sudo apt-get install aziot-edge
  

• 20.04:

  sudo apt-get update; \
     sudo apt-get install aziot-edge defender-iot-micro-agent-edge
  

İsteğe bağlı defender-iot-micro-agent-edge paket, IoT Edge cihazlarınızın güvenliğini sağlamanıza yardımcı olmak için güvenlik duruşu yönetimi, güvenlik açıkları, tehdit algılama, filo yönetimi ve daha fazlası için uç nokta görünürlüğü sağlayan IoT için Microsoft Defender güvenlik mikro aracısını içerir. Edge cihazlarınızın güvenlik izlemesini ve sağlamlaştırmasını sağlamak için mikro aracıyı Edge aracısıyla yüklemeniz önerilir. IoT için Microsoft Defender hakkında daha fazla bilgi edinmek için bkz . Cihaz oluşturucuları için IoT için Microsoft Defender nedir?

IoT Edge'in en son sürümünü ve IoT kimlik hizmeti paketini yükleyin (henüz güncel değilseniz):

sudo apt-get update; \
  sudo apt-get install aziot-edge defender-iot-micro-agent-edge

İsteğe bağlı defender-iot-micro-agent-edge paketi, IoT Edge cihazlarınızın güvenliğini sağlamanıza yardımcı olmak için güvenlik duruşu yönetimi, güvenlik açıkları, tehdit algılama, filo yönetimi ve daha fazlası için uç nokta görünürlüğü sağlayan IoT için Microsoft Defender güvenlik mikro aracısını içerir. Edge cihazlarınızın güvenlik izlemesini ve sağlamlaştırmasını sağlamak için mikro aracıyı Edge aracısıyla yüklemeniz önerilir. IoT için Microsoft Defender hakkında daha fazla bilgi edinmek için bkz . Cihaz oluşturucuları için IoT için Microsoft Defender nedir?

IoT Edge'in en son sürümünü ve IoT kimlik hizmeti paketini yükleyin (henüz güncel değilseniz):

sudo yum install aziot-edge

IoT Edge'i snap store'dan yükleyin:

sudo snap install azure-iot-edge

Tutturmaları bağlama

Varsayılan olarak, tutturmalar bağımlılık içermez, güvenilmezdir ve kesinlikle kısıtlanır. Bu nedenle, yüklemeden sonra tutturmaların diğer tutturmalara ve sistem kaynaklarına bağlanması gerekir. IoT Kimlik Hizmeti'ni ve IoT Edge'i birbirine ve sistem kaynaklarına bağlamak için aşağıdaki komutları kullanın. Başlamak için tutturmaların el ile bağlanması gerekir. Üretim dağıtımları için, sağlama iş yükünü azaltmak üzere otomatik olarak bağlanacak şekilde yapılandırılabilirler.

#------------------------
#  IoT Identity Service
#------------------------

# Connect the Identity Service snap to the logging system
# and grant permission to query system info

sudo snap connect azure-iot-identity:log-observe
sudo snap connect azure-iot-identity:mount-observe
sudo snap connect azure-iot-identity:system-observe
sudo snap connect azure-iot-identity:hostname-control

# If using a TPM, enable TPM access

sudo snap connect azure-iot-identity:tpm

#------------
#  IoT Edge
#------------

# Connect to your /home directory to enable writing support bundles

sudo snap connect azure-iot-edge:home

# Connect to logging and grant permission to query system info

sudo snap connect azure-iot-edge:log-observe
sudo snap connect azure-iot-edge:mount-observe
sudo snap connect azure-iot-edge:system-observe
sudo snap connect azure-iot-edge:hostname-control
# Allow IoT Edge to connect to the /var/run/iotedge folder and use sockets

sudo snap connect azure-iot-edge:run-iotedge

# Connect IoT Edge to Docker

sudo snap connect azure-iot-edge:docker docker:docker-daemon

Aşağıdaki komutu kullanarak IoT Edge cihazınızı simetrik anahtar kimlik doğrulamasıyla yapılandırabilirsiniz:

sudo iotedge config mp --connection-string 'PASTE_DEVICE_CONNECTION_STRING_HERE'

Bu iotedge config mp komut cihazda bir yapılandırma dosyası oluşturur ve yapılandırma dosyasına bağlantı dizesi girer.

1. Yapılandırma değişikliklerini uygulayın.

   sudo iotedge config apply
   

2. Yapılandırma dosyasını görüntülemek için dosyayı açabilirsiniz:

   sudo nano /etc/aziot/config.toml
   

1. Giriş dizininizde bir config.toml dosyası oluşturun ve IoT Edge cihazınızı tutturma için simetrik anahtar kimlik doğrulamasıyla yapılandırın.

   sudo nano ~/config.toml
   

2. Aşağıdaki sağlama ayarlarını kullanarak bir bağlantı dizesi el ile sağlayabilirsiniz:

   [provisioning]
   source = "manual"
   connection_string = "REPLACE_WITH_DEVICE_CONNECTION_STRING"
   

   Yapılandırma ayarlarını sağlama hakkında daha fazla bilgi için bkz . IoT Edge cihaz ayarlarını yapılandırma.

3. Aşağıdaki komutu kullanarak IoT Edge ve Kimlik Hizmeti yapılandırmasını ayarlayın:

   sudo snap set azure-iot-edge raw-config="$(cat ~/config.toml)"
   

sudo apt-get autoremove --purge aziot-edge

IoT Edge'i --purge yeniden yüklemeyi planlıyorsanız ve gelecekte aynı yapılandırma bilgilerini kullanmayı planlıyorsanız bayrağı atlayın. bayrağı, --purge yapılandırma dosyalarınız da dahil olmak üzere IoT Edge ile ilişkili tüm dosyaları siler.

sudo yum remove aziot-edge

IoT Edge çalışma zamanını kaldırın:

sudo snap remove azure-iot-edge

Azure Kimlik Hizmeti'nin kaldırılması:

sudo snap remove azure-iot-identity

sudo apt-get autoremove --purge moby-engine

sudo yum remove moby-cli
sudo yum remove moby-engine

sudo snap remove docker