Distribuera containerinstanser i ett virtuellt Azure-nätverk

  • Artikel

Azure Virtual Network tillhandahåller säkra, privata nätverk för dina Azure-resurser och lokala resurser. Genom att distribuera containergrupper till ett virtuellt Azure-nätverk kan dina containrar kommunicera säkert med andra resurser i det virtuella nätverket.

Den här artikeln visar hur du använder kommandot az container create i Azure CLI för att distribuera containergrupper till antingen ett nytt virtuellt nätverk eller ett befintligt virtuellt nätverk.

Viktigt

Innan du distribuerar containergrupper i virtuella nätverk rekommenderar vi att du kontrollerar begränsningen först. Information om nätverksscenarier och begränsningar finns i Scenarier och resurser för virtuella nätverk för Azure Container Instances.

Viktigt

Distribution av containergrupper till ett virtuellt nätverk är allmänt tillgängligt för Linux- och Windows-containrar, i de flesta regioner där Azure Container Instances är tillgängligt. Mer information finns i tillgängliga regioner.

Viktigt

Nätverksprofiler har dragits tillbaka från och med API-versionen 2021-07-01 . Om du använder den här eller en senare version ignorerar du alla steg och åtgärder som rör nätverksprofiler.

Exempel i den här artikeln är formaterade för Bash-gränssnittet. Om du föredrar ett annat gränssnitt, till exempel PowerShell eller Kommandotolken, justerar du radfortsättningstecken i enlighet med detta.

Distribuera till nytt virtuellt nätverk

Anteckning

Om du använder undernätets IP-intervall /29 för att bara ha 3 IP-adresser. vi rekommenderar att du alltid går ett intervall över (aldrig nedan). Använd till exempel IP-intervall /28 för undernät så att du kan ha minst 1 eller flera IP-buffertar per containergrupp. Genom att göra detta kan du undvika att containrar fastnar, inte kan starta, starta om eller ens inte kunna stoppa tillstånd.

Om du vill distribuera till ett nytt virtuellt nätverk och låta Azure skapa nätverksresurserna automatiskt anger du följande när du kör az container create:

  • Virtuellt nätverksnamn
  • Adressprefix för virtuellt nätverk i CIDR-format
  • Namn på undernät
  • Undernätsadressprefix i CIDR-format

Adressprefixen för det virtuella nätverket och undernätet anger adressutrymmena för det virtuella nätverket respektive undernätet. Dessa värden representeras i CIDR-notation (Classless Inter-Domain Routing), till exempel 10.0.0.0/16. Mer information om hur du arbetar med undernät finns i Lägga till, ändra eller ta bort ett virtuellt nätverksundernät.

När du har distribuerat din första containergrupp med den här metoden kan du distribuera till samma undernät genom att ange namn på det virtuella nätverket och undernätet, eller den nätverksprofil som Azure skapar automatiskt åt dig. Eftersom Azure delegerar undernätet till Azure Container Instances kan du bara distribuera containergrupper till undernätet.

Exempel

Följande az container create-kommando anger inställningar för ett nytt virtuellt nätverk och undernät. Ange namnet på en resursgrupp som skapades i en region där distributioner av containergrupper i ett virtuellt nätverk är tillgängliga. Det här kommandot distribuerar den offentliga Microsoft aci-helloworld-containern som kör en liten Node.js webbserver som betjänar en statisk webbsida. I nästa avsnitt distribuerar du en andra containergrupp till samma undernät och testar kommunikationen mellan de två containerinstanserna.

az container create \
  --name appcontainer \
  --resource-group myResourceGroup \
  --image mcr.microsoft.com/azuredocs/aci-helloworld \
  --vnet aci-vnet \
  --vnet-address-prefix 10.0.0.0/16 \
  --subnet aci-subnet \
  --subnet-address-prefix 10.0.0.0/24

När du distribuerar till ett nytt virtuellt nätverk med den här metoden kan distributionen ta några minuter medan nätverksresurserna skapas. Efter den första distributionen slutförs ytterligare distributioner av containergrupper till samma undernät snabbare.

Distribuera till befintligt virtuellt nätverk

Så här distribuerar du en containergrupp till ett befintligt virtuellt nätverk:

  1. Skapa ett undernät i ditt befintliga virtuella nätverk, använd ett befintligt undernät där en containergrupp redan har distribuerats eller använd ett befintligt undernät tömt på alla andra resurser och konfigurationer.
  2. Distribuera en containergrupp med az container create och ange något av följande:
    • Namn på virtuellt nätverk och undernätsnamn
    • Resurs-ID för virtuellt nätverk och resurs-ID för undernät, vilket gör det möjligt att använda ett virtuellt nätverk från en annan resursgrupp
    • Nätverksprofilnamn eller ID, som du kan hämta med az network profile list

Exempel

I följande exempel distribueras en andra containergrupp till samma undernät som skapades tidigare och verifierar kommunikationen mellan de två containerinstanserna.

Hämta först IP-adressen för den första containergruppen som du distribuerade, appcontainern:

az container show --resource-group myResourceGroup \
  --name appcontainer \
  --query ipAddress.ip --output tsv

Utdata visar IP-adressen för containergruppen i det privata undernätet. Exempel:

10.0.0.4

Ange CONTAINER_GROUP_IP nu den IP-adress som du hämtade med az container show kommandot och kör följande az container create kommando. Den andra containern, commchecker, kör en Alpine Linux-baserad avbildning och körs wget mot den första containergruppens IP-adress för det privata undernätet.

CONTAINER_GROUP_IP=<container-group-IP-address>

az container create \
  --resource-group myResourceGroup \
  --name commchecker \
  --image alpine:3.5 \
  --command-line "wget $CONTAINER_GROUP_IP" \
  --restart-policy never \
  --vnet aci-vnet \
  --subnet aci-subnet

När den andra containerdistributionen har slutförts hämtar du loggarna så att du kan se utdata för kommandot som wget den körde:

az container logs --resource-group myResourceGroup --name commchecker

Om den andra containern kommunicerade med den första liknar utdata:

Connecting to 10.0.0.4 (10.0.0.4:80)
index.html           100% |*******************************|  1663   0:00:00 ETA

Loggutdata bör visa att wget det gick att ansluta och ladda ned indexfilen från den första containern med hjälp av dess privata IP-adress i det lokala undernätet. Nätverkstrafiken mellan de två containergrupperna fanns kvar i det virtuella nätverket.

Exempel – YAML

Du kan också distribuera en containergrupp till ett befintligt virtuellt nätverk med hjälp av en YAML-fil, en Resource Manager-mall eller en annan programmatisk metod, till exempel med Python SDK.

När du till exempel använder en YAML-fil kan du distribuera till ett virtuellt nätverk med ett undernät delegerat till Azure Container Instances. Ange följande egenskaper:

  • ipAddress: Inställningarna för den privata IP-adressen för containergruppen.
    • ports: Portarna som ska öppnas, om sådana finns.
    • protocol: Protokollet (TCP eller UDP) för den öppna porten.
  • subnetIds: Resurs-ID:t för de undernät som ska distribueras till
    • id: Resurs-ID för undernätet
    • name: Namnet på undernätet

Denna YAML skapar en containergrupp med namnet appcontaineryaml i ditt virtuella nätverk.

apiVersion: '2021-07-01'
location: westus
name: appcontaineryaml
properties:
  containers:
  - name: appcontaineryaml
    properties:
      image: mcr.microsoft.com/azuredocs/aci-helloworld
      ports:
      - port: 80
        protocol: TCP
      resources:
        requests:
          cpu: 1.0
          memoryInGB: 1.5
  ipAddress:
    type: Private
    ports:
    - protocol: tcp
      port: '80'
  osType: Linux
  restartPolicy: Always
  subnetIds:
    - id: <subnet-id>
      name: default
tags: null
type: Microsoft.ContainerInstance/containerGroups

Distribuera containergruppen med kommandot az container create och ange YAML-filnamnet för parametern --file :

az container create --resource-group myResourceGroup \
  --file vnet-deploy-aci.yaml

När distributionen är klar kör du kommandot az container show för att visa dess status. Exempel på utdata:

Name              ResourceGroup    Status    Image                                       IP:ports     Network    CPU/Memory       OsType    Location
----------------  ---------------  --------  ------------------------------------------  -----------  ---------  ---------------  --------  ----------
appcontaineryaml  myResourceGroup  Running   mcr.microsoft.com/azuredocs/aci-helloworld  10.0.0.5:80  Private    1.0 core/1.5 gb  Linux     westus

Rensa resurser

Ta bort containerinstanser

När du är klar med att arbeta med containerinstanserna som du skapade tar du bort dem med följande kommandon:

az container delete --resource-group myResourceGroup --name appcontainer -y
az container delete --resource-group myResourceGroup --name commchecker -y
az container delete --resource-group myResourceGroup --name appcontaineryaml -y

Ta bort nätverksresurser

Den här funktionen kräver för närvarande flera ytterligare kommandon för att ta bort de nätverksresurser som du skapade tidigare. Om du använde exempelkommandona i föregående avsnitt i den här artikeln för att skapa ditt virtuella nätverk och undernät kan du använda följande skript för att ta bort dessa nätverksresurser. Skriptet förutsätter att resursgruppen innehåller ett enda virtuellt nätverk med en enda nätverksprofil.

Innan du kör skriptet anger du variabeln RES_GROUP till namnet på resursgruppen som innehåller det virtuella nätverket och undernätet som ska tas bort. Uppdatera namnet på det virtuella nätverket om du inte använde namnet som föreslogs aci-vnet tidigare. Skriptet är formaterat för Bash-gränssnittet. Om du föredrar ett annat gränssnitt, till exempel PowerShell eller Kommandotolken, måste du justera variabeltilldelning och åtkomst till dem i enlighet med detta.

Varning

Det här skriptet tar bort resurser! Det tar bort det virtuella nätverket och alla undernät som det innehåller. Se till att du inte längre behöver några av resurserna i det virtuella nätverket, inklusive eventuella undernät som det innehåller, innan du kör skriptet. När resurserna har tagits bort går det inte att återställa dem.

# Replace <my-resource-group> with the name of your resource group
# Assumes one virtual network in resource group
RES_GROUP=<my-resource-group>

# Get network profile ID
# Assumes one profile in virtual network
NETWORK_PROFILE_ID=$(az network profile list --resource-group $RES_GROUP --query [0].id --output tsv)

# Delete the network profile
az network profile delete --id $NETWORK_PROFILE_ID -y

# Delete virtual network
az network vnet delete --resource-group $RES_GROUP --name aci-vnet

Nästa steg