Skapa och etablera IoT Edge-enheter i stor skala i Linux med hjälp av symmetriska nycklar

Skapa en individuell DPS-registrering

1. I Azure Portal navigerar du till din instans av IoT Hub-enhetsetableringstjänsten.

2. Under Inställningar väljer du Hantera registreringar.

3. Välj Lägg till enskild registrering och slutför sedan följande steg för att konfigurera registreringen:

   1. För Mekanism väljer du Symmetrisk nyckel.

   2. Ange ett unikt registrerings-ID för din enhet.

   3. Du kan också ange ett IoT Hub-enhets-ID för din enhet. Du kan använda enhets-ID:n för att rikta in dig på en enskild enhet för moduldistribution. Om du inte anger något enhets-ID används registrerings-ID:t.

   4. Välj Sant för att deklarera att registreringen gäller för en IoT Edge-enhet.

   5. Du kan också lägga till ett taggvärde i det inledande enhetstvillingtillståndet. Du kan använda taggar till målgrupper med enheter för moduldistribution. Till exempel:

      {
         "tags": {
            "environment": "test"
         },
         "properties": {
            "desired": {}
         }
      }
      

   6. Välj Spara.

4. Kopiera den enskilda registreringens primärnyckelvärde som ska användas när du installerar IoT Edge-körningen.

Nu när det finns en registrering för den här enheten kan IoT Edge-körningen automatiskt etablera enheten under installationen.

Skapa en DPS-gruppregistrering

1. I Azure Portal navigerar du till din instans av IoT Hub-enhetsetableringstjänsten.

2. Under Inställningar väljer du Hantera registreringar.

3. Välj Lägg till enskild registrering och slutför sedan följande steg för att konfigurera registreringen:

   1. Ange ett gruppnamn.

   2. Välj Symmetrisk nyckel som attesteringstyp.

   3. Välj Sant för att deklarera att registreringen gäller för en IoT Edge-enhet. För en gruppregistrering måste alla enheter vara IoT Edge-enheter eller så kan ingen av dem vara det.

   4. Du kan också lägga till ett taggvärde i det inledande enhetstvillingtillståndet. Du kan använda taggar till målgrupper med enheter för moduldistribution. Till exempel:

      {
         "tags": {
            "environment": "test"
         },
         "properties": {
            "desired": {}
         }
      }
      

   5. Välj Spara.

4. Kopiera registreringsgruppens primärnyckelvärde som ska användas när du skapar enhetsnycklar för användning med en gruppregistrering.

Nu när det finns en registreringsgrupp kan IoT Edge-körningen automatiskt etablera enheter under installationen.

Härled en enhetsnyckel

Varje enhet som etableras som en del av en gruppregistrering behöver en härledd enhetsnyckel för att utföra symmetrisk nyckelattestering med registreringen under etableringen.

Om du vill generera en enhetsnyckel använder du nyckeln som du kopierade från dps-registreringsgruppen för att beräkna ett HMAC-SHA256 av enhetens unika registrerings-ID och konvertera resultatet till Base64-format.

I Windows kan du använda PowerShell för att generera din härledda enhetsnyckel enligt följande exempel.

Ersätt värdet för KEY med den primärnyckel som du antecknade tidigare.

Ersätt värdet för REG_ID med enhetens registrerings-ID.

$KEY='PASTE_YOUR_ENROLLMENT_KEY_HERE'
$REG_ID='PASTE_YOUR_REGISTRATION_ID_HERE'

$hmacsha256 = New-Object System.Security.Cryptography.HMACSHA256
$hmacsha256.key = [Convert]::FromBase64String($KEY)
$sig = $hmacsha256.ComputeHash([Text.Encoding]::ASCII.GetBytes($REG_ID))
$derivedkey = [Convert]::ToBase64String($sig)
echo "`n$derivedkey`n"

Nedan visas ett exempel på utdata från en härledd enhetsnyckel:

Jsm0lyGpjaVYVP2g3FnmnmG9dI/9qU24wNoykUmermc=

Installationen kan utföras med några få kommandon. Öppna en terminal och kör följande kommandon:

• 24.04:

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

• 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
  

Du kan installera med APT med några få kommandon. Öppna en terminal och kör följande kommandon:

• 12 - Bookworm (arm32v7):

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

• 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
  

Installationen kan utföras med några få kommandon. Öppna en terminal och kör följande kommandon:

• 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
  

Du installerar IoT Edge-körning från snaplagringsplatsen i ett senare steg. Fortsätt till nästa avsnitt.

Installera Moby-motorn.

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

Installera Moby-motorn.

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

Installera Moby-motorn och CLI.

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 har beroenden för Docker och IoT Identity Service. Installera beroendena med hjälp av följande kommandon:

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

Docker snap hanteras av Canonical och stöds för produktionsscenarier.

1. Skapa eller redigera den befintliga Docker-daemonens konfigurationsfil

   sudo nano /etc/docker/daemon.json
   

2. Ange loggningsdrivrutinen som standard till local loggningsdrivrutinen enligt exemplet.

      {
         "log-driver": "local"
      }
   

3. Starta om containermotorn för att ändringarna ska börja gälla.

   sudo systemctl restart docker
   

För närvarande stöds inte local inställningen för loggningsdrivrutinen för Docker-snap-paketet.

Installera den senaste versionen av IoT Edge och IoT-identitetstjänstpaketet (om du inte redan är uppdaterad):

• 22.04:

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

• 20.04:

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

Installera den senaste versionen av IoT Edge och IoT-identitetstjänstpaketet (om du inte redan är uppdaterad):

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

Installera den senaste versionen av IoT Edge och IoT-identitetstjänstpaketet (om du inte redan är uppdaterad):

sudo yum install aziot-edge

Installera IoT Edge från snaplagringsplatsen:

sudo snap install azure-iot-edge

Ansluta fästen

Som standard är snappar beroendefria, obetrodda och strikt begränsade. Därför måste fästen anslutas till andra fästen och systemresurser efter installationen. Använd följande kommandon för att ansluta IoT Identity Service och IoT Edge till varandra och till systemresurser. För att komma igång måste fästen vara manuellt anslutna. För produktionsdistributioner kan de konfigureras för att automatiskt ansluta för att minska etableringsarbetsbelastningen.

#------------------------
#  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

sudo cp /etc/aziot/config.toml.edge.template /etc/aziot/config.toml

Öppna konfigurationsfilen på IoT Edge-enheten.

sudo nano /etc/aziot/config.toml

Om du använder en snapinstallation av IoT Edge finns mallfilen på /snap/azure-iot-edge/current/etc/aziot/config.toml.edge.template. Kopiera mallfilen till din hemkatalog och ge den namnet config.toml. Till exempel:

cp /snap/azure-iot-edge/current/etc/aziot/config.toml.edge.template ~/config.toml

Öppna konfigurationsfilen i hemkatalogen på IoT Edge-enheten.

nano ~/config.toml

Kontrollera att den enskilda registrering som du skapade i enhetsetableringstjänsten används. Gå till din instans av enhetsetableringstjänsten i Azure-portalen. Öppna registreringsinformationen för den enskilda registrering som du skapade. Status för registreringen är tilldelad och enhets-ID är listad.

Kontrollera att den gruppregistrering som du skapade i enhetsetableringstjänsten används. Gå till din instans av enhetsetableringstjänsten i Azure-portalen. Öppna registreringsinformationen för den gruppregistrering som du skapade. Gå till fliken Registreringsposter för att visa alla enheter som är registrerade i gruppen.