Kör Azure IoT Edge på virtuella Ubuntu-datorer

Gäller för: IoT Edge 1.5

Azure IoT Edge-körningen omvandlar en enhet till en IoT Edge-enhet. Distribuera körmiljön på enheter så små som en Raspberry Pi eller så stora som industriella servrar. När du har konfigurerat IoT Edge-körningen distribuerar du affärslogik till enheten från molnet.

Mer information om hur IoT Edge-körningen fungerar och dess komponenter finns i förstå Azure IoT Edge-körningen och dess arkitektur.

I den här artikeln beskrivs stegen för att distribuera en virtuell Ubuntu-dator med Azure IoT Edge-körningen installerad och konfigurerad med hjälp av en angivet enhetsanslutningssträng. Distributionen använder en molnbaseradAzure Resource Manager-mall från projektlagringsplatsen iotedge-vm-deploy .

Vid den första starten installerar den virtuella datorn den senaste versionen av Azure IoT Edge-körningen med hjälp av cloud-init. Den anger också en angivet anslutningssträng innan körningen startar, så att du snabbt kan konfigurera och ansluta IoT Edge-enheten utan att starta en SSH- eller fjärrskrivbordssession.

Distribuera med hjälp av knappen Distribuera till Azure

Med knappen Distribuera till Azure kan du snabbt distribuera Azure Resource Manager-mallar från GitHub. Det här avsnittet visar hur du använder knappen Distribuera till Azure i projektlagringsplatsen iotedge-vm-deploy .

1. Distribuera en Azure IoT Edge-aktiverad virtuell Linux-dator med hjälp av azure resource manager-mallen iotedge-vm-deploy. Starta genom att välja följande knapp:

   

2. I det nya fönstret anger du värden för de tillgängliga formulärfälten:

   

   Fält	beskrivning
   Abonnemang	Den aktiva Azure-prenumerationen som den virtuella datorn ska distribueras till.
   Resursgrupp	En befintlig eller ny resursgrupp som ska innehålla den virtuella datorn och dess associerade resurser.
   Region	Den geografiska regionen där du distribuerar den virtuella datorn. Det här värdet är som standard platsen för den valda resursgruppen.
   DNS-etikettprefix	Ett obligatoriskt värde som du väljer för att prefixa värdnamnet för den virtuella datorn.
   Administratörsanvändarnamn	Ett användarnamn med rotbehörighet vid distribution.
   Enhetens anslutningssträng	En enhetsanslutningssträng för en enhet som du skapade i din IoT-hubb.
   VM-storlek	Storleken på den virtuella dator som ska distribueras.
   Ubuntu OS-version	Den version av Ubuntu OS som ska installeras på den virtuella basdatorn.
   Autentiseringstyp	Välj sshPublicKey eller lösenord baserat på dina önskemål.
   Administratörslösenord eller -nyckel	Den offentliga SSH-nyckeln eller lösenordsvärdet, beroende på vilken autentiseringstyp du väljer.

   Välj Next : Review + create för att granska villkoren och välj sedan Skapa för att starta distributionen.

3. Kontrollera att distributionen har slutförts. Den virtuella datorresursen distribueras till den valda resursgruppen. Observera datornamnet, som är i formatet vm-0000000000000. Observera även det associerade DNS-namnet, som är i formatet <dnsLabelPrefix>.<location>. cloudapp.azure.com.

   Du hittar DNS-namnet i avsnittet Översikt för den nya virtuella datorn i Azure-portalen.

   

4. Om du vill SSH till den här virtuella datorn efter installationen använder du det associerade DNS-namnet med kommandot : ssh <adminUsername>@<DNS_Name>

Distribuera från Azure CLI

1. Kontrollera att du har installerat Azure CLI iot-tillägget med:

   az extension add --name azure-iot
   

2. Om du sedan använder Azure CLI på skrivbordet börjar du med att logga in:

   az login
   

3. Om du har flera prenumerationer väljer du den prenumeration som du vill använda:

   1. Visa dina prenumerationer:

      az account list --output table
      

   2. Kopiera fältet SubscriptionID för den prenumeration som du vill använda.

   3. Ange din arbetsprenumeration med det ID som du kopierade:

      az account set -s <SubscriptionId>
      

4. Skapa en ny resursgrupp (eller ange en befintlig i nästa steg):

   az group create --name IoTEdgeResources --location westus2
   

5. Skapa en ny virtuell dator:

   Om du vill använda en authenticationType av passwordanvänder du följande exempel:

   az deployment group create \
   --resource-group IoTEdgeResources \
   --template-uri "https://raw.githubusercontent.com/Azure/iotedge-vm-deploy/main/edgeDeploy.json" \
   --parameters dnsLabelPrefix='my-edge-vm1' \
   --parameters adminUsername='<REPLACE_WITH_USERNAME>' \
   --parameters deviceConnectionString=$(az iot hub device-identity connection-string show --device-id <REPLACE_WITH_DEVICE-NAME> --hub-name <REPLACE-WITH-HUB-NAME> -o tsv) \
   --parameters authenticationType='password' \
   --parameters adminPasswordOrKey="<REPLACE_WITH_SECRET_PASSWORD>"
   

   Om du vill autentisera med en SSH-nyckel anger du en authenticationType för sshPublicKeyoch anger sedan värdet för SSH-nyckeln i parametern adminPasswordOrKey . Se följande exempel:

   #Generate the SSH Key
   ssh-keygen -m PEM -t rsa -b 4096 -q -f ~/.ssh/iotedge-vm-key -N ""
   
   #Create a VM using the iotedge-vm-deploy script
   az deployment group create \
   --resource-group IoTEdgeResources \
   --template-uri "https://raw.githubusercontent.com/Azure/iotedge-vm-deploy/main/edgeDeploy.json" \
   --parameters dnsLabelPrefix='my-edge-vm1' \
   --parameters adminUsername='<REPLACE_WITH_USERNAME>' \
   --parameters deviceConnectionString=$(az iot hub device-identity connection-string show --device-id <REPLACE_WITH_DEVICE-NAME> --hub-name <REPLACE-WITH-HUB-NAME> -o tsv) \
   --parameters authenticationType='sshPublicKey' \
   --parameters adminPasswordOrKey="$(< ~/.ssh/iotedge-vm-key.pub)"
   

6. Kontrollera att distributionen har slutförts. En virtuell datorresurs ska distribueras till den valda resursgruppen. Anteckna datornamnet, det är i formatet vm-0000000000000. Anteckna även det associerade DNS-namnet, som är i formatet <dnsLabelPrefix>.<location>. cloudapp.azure.com.

   Du kan hämta DNS-namnet från JSON-formaterade utdata från föregående steg i avsnittet utdata som en del av den offentliga SSH-posten . Använd det här värdet för att SSH till den nyligen distribuerade datorn.

   "outputs": {
     "public SSH": {
       "type": "String",
       "value": "ssh <adminUsername>@<DNS_Name>"
     }
   }
   

   Du kan också hämta DNS-namnet från avsnittet Översikt för den nyligen distribuerade virtuella datorn i Azure-portalen.

   

7. Om du vill SSH till den här virtuella datorn efter installationen använder du det associerade DNS-namnet med kommandot : ssh <adminUsername>@<DNS_Name>

Nästa steg

Nu när du har etablerat en IoT Edge-enhet med runtime installerad distribuerar du IoT Edge-moduler.

Om du har problem med att installera IoT Edge-miljön kan du läsa felsökningsinstruktionerna.

Information om hur du uppdaterar en befintlig installation till den senaste versionen av IoT Edge finns i Uppdatera IoT Edge-säkerhetsdaemonen och körningen.

Om du vill öppna portar för att komma åt den virtuella datorn via SSH eller andra inkommande anslutningar kan du läsa dokumentationen om hur du öppnar portar och slutpunkter för en virtuell Linux-dator.