Så här konfigurerar du alternativ för att skapa containrar för IoT Edge-moduler

Gäller för: IoT Edge 1.5 IoT Edge 1.4

Med parametern createOptions i distributionsmanifestet kan du konfigurera modulcontainrarna vid körning. Den här parametern utökar kontrollen över modulerna och möjliggör uppgifter som att tillåta eller begränsa modulens åtkomst till värdenhetens resurser eller konfigurera nätverk.

IoT Edge-moduler implementeras som Docker-kompatibla containrar på din IoT Edge-enhet. Docker erbjuder många alternativ för att skapa containrar, och dessa alternativ gäller även för IoT Edge-moduler. Mer information finns i Skapa alternativ för Docker-container.

Alternativ för att skapa format

IoT Edge-distributionsmanifestet accepterar alternativ för att skapa formaterade som JSON. Ta till exempel de skapa-alternativ som automatiskt ingår för varje edgeHub-modul:

"createOptions": {
  "HostConfig": {
    "PortBindings": {
      "5671/tcp": [
        {
          "HostPort": "5671"
        }
      ],
      "8883/tcp": [
        {
          "HostPort": "8883"
        }
      ],
      "443/tcp": [
        {
          "HostPort": "443"
        }
      ]
    }
  }
}

Det här edgeHub-exemplet använder parametern HostConfig.PortBindings för att mappa exponerade portar på containern till en port på värdenheten.

Om du använder Azure IoT Edge-tillägget för Visual Studio eller Visual Studio Code kan du skriva skapa-alternativen i JSON-format i deployment.template.json-filen . När du sedan använder tillägget för att skapa IoT Edge-lösningen eller generera distributionsmanifestet, kommer det att strängbegränsa JSON åt dig i det format som IoT Edge-körningen förväntar sig. Till exempel:

"createOptions": "{\"HostConfig\":{\"PortBindings\":{\"5671/tcp\":[{\"HostPort\":\"5671\"}],\"8883/tcp\":[{\"HostPort\":\"8883\"}],\"443/tcp\":[{\"HostPort\":\"443\"}]}}}"

Ett tips för att skriva skapa alternativ är att använda docker inspect kommandot . Som en del av utvecklingsprocessen kör du modulen lokalt med hjälp av docker run <container name>. När du har fått modulen att fungera som du vill ha den kör docker inspect <container name>du . Det här kommandot matar ut modulinformationen i JSON-format. Leta upp de parametrar som du har konfigurerat och kopiera JSON. Till exempel:

Vanliga scenarier

Alternativ för att skapa containrar möjliggör många scenarier, men här är några som kommer upp oftast när du skapar IoT Edge-lösningar:

• Ge moduler åtkomst till värdlagring
• Mappa värdporten till modulporten
• Begränsa modulminne och CPU-användning
• GPU-optimera en IoT Edge-modul

Mappa värdporten till modulporten

Om modulen behöver kommunicera med en tjänst utanför IoT Edge-lösningen och inte använder meddelandedirigering för att göra det, måste du mappa en värdport till en modulport.

Kontrollera först att en port i modulen exponeras för att lyssna efter anslutningar. Du kan göra detta med hjälp av en EXPOSE-instruktion i dockerfile. Exempel: EXPOSE 8080 Instruktionen exponerar som standard TCP-protokollet om det inte anges, eller så kan du ange UDP.

Använd sedan inställningen PortBindings i gruppen HostConfig i Docker-containern för att skapa alternativ för att mappa den exponerade porten i modulen till en port på värdenheten. Om du till exempel exponerade port 8080 i modulen och vill mappa den till port 80 på värdenheten, skulle skapandealternativen i template.json-filen se ut som i följande exempel:

"createOptions": {
  "HostConfig": {
    "PortBindings": {
      "8080/tcp": [
        {
          "HostPort": "80"
        }
      ]
    }
  }
}

När du har stringifierats för distributionsmanifestet skulle samma konfiguration se ut som i följande exempel:

"createOptions": "{\"HostConfig\":{\"PortBindings\":{\"8080/tcp\":[{\"HostPort\":\"80\"}]}}}"

Begränsa modulminne och CPU-användning

Du kan deklarera hur mycket av värdresurserna som en modul kan använda. Den här kontrollen är användbar för att säkerställa att en modul inte kan förbruka för mycket minne eller CPU-användning och förhindrar att andra processer körs på enheten. Du kan hantera de här inställningarna med alternativ för att skapa Docker-container i gruppen HostConfig , inklusive:

• Minne: Minnesgräns i byte. Till exempel 268435456 byte = 256 MB.
• MemorySwap: Total minnesgräns (minne + växling). Till exempel 536870912 byte = 512 MB.
• NanoCpus: CPU-kvot i enheter på 10^–9 (1 miljarddels) processorer. Till exempel 2500000000 nanocpus = 0,25 CPU.

I template.json format skulle dessa värden se ut som i följande exempel:

"createOptions": {
  "HostConfig": {
    "Memory": 268435456,
    "MemorySwap": 536870912,
    "NanoCpus": 250000000
  }
}

När de har stringifierats för det slutliga distributionsmanifestet ser dessa värden ut som i följande exempel:

"createOptions":"{\"HostConfig\":{\"Memory\":268435456,\"MemorySwap\":536870912,\"CpuPeriod\":25000}}"

GPU-optimera en IoT Edge-modul

Om du kör IoT Edge-modulen på en GPU-optimerad virtuell dator kan du även aktivera en IoT Edge-modul för att ansluta till din GPU. Om du vill göra detta med en befintlig modul lägger du till några specifikationer i :createOptions

{"HostConfig": {"DeviceRequests": [{"Count": -1,"Capabilities": [["gpu"]]}]}}

Om du vill bekräfta att de här inställningarna har lagts till använder du kommandot Docker inspect för att se den nya inställningen i en JSON-utskrift.

sudo docker inspect <YOUR-MODULE-NAME>

Mer information om hur din enhet och virtuella dator ansluter till en GPU finns i Konfigurera, ansluta och verifiera en IoT Edge-modul för en GPU.

Nästa steg

Fler exempel på hur du skapar alternativ i praktiken finns i följande IoT Edge-exempel:

• Custom Vision och Azure IoT Edge på en Raspberry Pi 3
• Azure IoT Edge-bloblagringsexempel