Spuštění Azure IoT Edge na virtuálních počítačích s Ubuntu

Platí pro: IoT Edge 1.5

Důležité

Podporovanou verzí je IoT Edge 1.5 LTS. IoT Edge 1.4 LTS je konec životnosti od 12. listopadu 2024. Pokud používáte starší verzi, podívejte se na článek Aktualizace IoT Edge.

Modul runtime Azure IoT Edge změní zařízení na zařízení IoT Edge. Nasazte runtime na zařízeních, která mohou být tak malá jako Raspberry Pi nebo tak velká jako průmyslový server. Po nastavení modulu runtime IoT Edge nasaďte obchodní logiku do zařízení z cloudu.

Další informace o fungování modulu runtime IoT Edge a jeho komponentách najdete v tématu Vysvětlení modulu runtime Azure IoT Edge a jeho architektury.

Tento článek uvádí postup nasazení virtuálního počítače s Ubuntu s nainstalovaným a nakonfigurovaným modulem runtime Azure IoT Edge pomocí zadaného připojovacího řetězce zařízení. Nasazení využívá šablonu Resource Manageru Azure založenou na cloud-init z úložiště projektu iotedge-vm-deploy.

Při prvním spuštění nainstaluje virtuální počítač nejnovější verzi modulu runtime Azure IoT Edge pomocí cloud-init. Nastaví také zadaný připojovací řetězec před spuštěním runtime, takže můžete rychle zařízení IoT Edge nastavit a připojit bez spuštění relace SSH nebo vzdálené plochy.

Nasazení pomocí tlačítka Nasadit do Azure

Tlačítko Nasadit do Azure umožňuje rychle nasadit šablony Azure Resource Manageru z GitHubu. Tato část ukazuje, jak použít tlačítko Nasadit do Azure v úložišti projektu iotedge-vm-deploy .

1. Nasaďte virtuální počítač s Linuxem s podporou Azure IoT Edge pomocí šablony iotedge-vm-deploy Azure Resource Manageru. Začněte tím, že vyberete následující tlačítko:

   

2. V novém okně zadejte hodnoty dostupných polí formuláře:

   

   Pole	Popis
   Předplatné	Aktivní předplatné Azure pro nasazení virtuálního počítače do.
   Skupina prostředků	Existující nebo nová skupina prostředků, která bude obsahovat virtuální počítač a jeho přidružené prostředky.
   Oblast	Geografická oblast, ve které nasazujete virtuální počítač. Tato hodnota je výchozí umístění vybrané skupiny prostředků.
   Předpona popisku DNS	Požadovaná hodnota, kterou zvolíte pro předponu názvu hostitele virtuálního počítače.
   Uživatelské jméno správce	Uživatelské jméno s kořenovými oprávněními pro nasazení.
   Připojovací řetězec zařízení	Připojovací řetězec zařízení pro zařízení, které jste vytvořili ve službě IoT Hub.
   Velikost virtuálního počítače	Velikost virtuálního počítače, který se má nasadit.
   Verze operačního systému Ubuntu	Verze operačního systému Ubuntu, která se má nainstalovat na základní virtuální počítač.
   Typ ověření	Na základě vašich preferencí zvolte sshPublicKey nebo heslo .
   Heslo nebo klíč správce	Veřejný klíč nebo hodnota hesla SSH v závislosti na zvoleném typu ověřování.

   Vyberte Next : Review + create, a poté vyberte Vytvořit, abyste spustili nasazení.

3. Zkontrolujte, jestli se nasazení úspěšně dokončilo. Prostředek virtuálního počítače se nasadí do vybrané skupiny prostředků. Poznamenejte si název počítače, který je ve formátu vm-0000000000000. Všimněte si také přidruženého názvu DNS, který je ve formátu <dnsLabelPrefix>.<location>. cloudapp.azure.com.

   Název DNS najdete v části Přehled nového virtuálního počítače na webu Azure Portal.

   

4. Pokud chcete po instalaci připojit SSH k tomuto virtuálnímu počítači, použijte přidružený název DNS s příkazem: ssh <adminUsername>@<DNS_Name>

Nasazení z Azure CLI

1. Ujistěte se, že jste nainstalovali rozšíření IoT Azure CLI pomocí:

   az extension add --name azure-iot
   

2. Pokud na počítači používáte Azure CLI, začněte přihlášením:

   az login
   

3. Pokud máte více předplatných, vyberte předplatné, které chcete použít:

   1. Zobrazte výpis vašich předplatných:

      az account list --output table
      

   2. Zkopírujte pole SubscriptionID pro předplatné, které chcete použít.

   3. Nastavte si pracovní předplatné s ID, které jste zkopírovali:

      az account set -s <SubscriptionId>
      

4. Vytvořte novou skupinu prostředků (nebo zadejte existující skupinu v dalších krocích):

   az group create --name IoTEdgeResources --location westus2
   

5. Vytvoření nového virtuálního počítače:

   Pokud chcete použít typ ověřovánípassword, využijte následující příklad:

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

   Pokud se chcete ověřit pomocí klíče SSH, zadejte typ ověřovánísshPublicKey, a pak zadejte hodnotu klíče SSH v parametru adminPasswordOrKey . Prohlédněte si následující příklad:

   #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. Ověřte, že se nasazení úspěšně dokončilo. Prostředek virtuálního počítače by se měl nasadit do vybrané skupiny prostředků. Poznamenejte si název počítače, je ve formátu vm-0000000000000. Poznamenejte si také přidružený název DNS, který je ve formátu <dnsLabelPrefix>.<location>. cloudapp.azure.com.

   Název DNS můžete získat z výstupu ve formátu JSON předchozího kroku v části Výstupy jako součást veřejné položky SSH. Tuto hodnotu použijte pro SSH do nově nasazeného počítače.

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

   Název DNS můžete získat také v části Přehled nově nasazeného virtuálního počítače na webu Azure Portal.

   

7. Pokud chcete po instalaci připojit SSH k tomuto virtuálnímu počítači, použijte přidružený název DNS s příkazem: ssh <adminUsername>@<DNS_Name>

Další kroky

Teď, když jste zřídili zařízení IoT Edge s nainstalovaným modulem runtime, nasaďte moduly IoT Edge.

Pokud máte problémy s instalací modulu runtime IoT Edge, podívejte se na stránku pro řešení potíží .

Pokud chcete aktualizovat existující instalaci na nejnovější verzi IoT Edge, přečtěte si téma Aktualizace démona zabezpečení IoT Edge a modulu runtime.

Pokud chcete otevřít porty pro přístup k virtuálnímu počítači přes SSH nebo jiná příchozí připojení, projděte si dokumentaci k Virtuálním počítačům Azure o otevírání portů a koncových bodů pro virtuální počítač s Linuxem.