az container

Beheer Azure Container Instances.

Opdracht

az container app

Opdrachten voor het beheren Azure Container Instances app.

az container app up

Implementeer naar Azure Container Instances met behulp GitHub Acties.

az container attach

Lokale standaarduitvoer en foutstromen koppelen aan een container in een containergroep.

az container create

Maak een containergroep.

az container delete

Verwijder een containergroep.

az container exec

Voer een opdracht uit vanuit een container die wordt uitgevoerd in een containergroep.

az container export

Exporteert een containergroep in yaml-indeling.

az container list

Lijst met containergroepen maken.

az container logs

Bekijk de logboeken voor een container in een containergroep.

az container restart

Start alle containers in een containergroep opnieuw op.

az container show

Haal de details van een containergroep op.

az container start

Start alle containers in een containergroep.

az container stop

Stopt alle containers in een containergroep.

az container attach

Lokale standaarduitvoer en foutstromen koppelen aan een container in een containergroep.

az container attach [--container-name]
                    [--ids]
                    [--name]
                    [--resource-group]
                    [--subscription]

Voorbeelden

Lokale standaarduitvoer en foutstromen koppelen aan een container in een containergroep. (automatisch gegenereerd)

az container attach --name MyContainerGroup --resource-group MyResourceGroup

Optionele parameters

--container-name

De container om aan te koppelen. Als u dit weggelaten, wordt de eerste container in de containergroep gekozen.

--ids

Een of meer resource-ID's (door spaties scheidingstekens). Dit moet een volledige resource-id zijn die alle gegevens van de argumenten 'Resource-id' bevat. U moet --id's of andere argumenten voor resource-id's verstrekken.

--name -n

De naam van de containergroep.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met az account set -s NAME_OR_ID behulp van .

az container create

Maak een containergroep.

az container create --resource-group
                    [--assign-identity]
                    [--azure-file-volume-account-key]
                    [--azure-file-volume-account-name]
                    [--azure-file-volume-mount-path]
                    [--azure-file-volume-share-name]
                    [--command-line]
                    [--cpu]
                    [--dns-name-label]
                    [--environment-variables]
                    [--file]
                    [--gitrepo-dir]
                    [--gitrepo-mount-path]
                    [--gitrepo-revision]
                    [--gitrepo-url]
                    [--image]
                    [--ip-address {Private, Public}]
                    [--location]
                    [--log-analytics-workspace]
                    [--log-analytics-workspace-key]
                    [--memory]
                    [--name]
                    [--network-profile]
                    [--no-wait]
                    [--os-type {Linux, Windows}]
                    [--ports]
                    [--protocol {TCP, UDP}]
                    [--registry-login-server]
                    [--registry-password]
                    [--registry-username]
                    [--restart-policy {Always, Never, OnFailure}]
                    [--role]
                    [--scope]
                    [--secrets]
                    [--secrets-mount-path]
                    [--secure-environment-variables]
                    [--subnet]
                    [--subnet-address-prefix]
                    [--subscription]
                    [--vnet]
                    [--vnet-address-prefix]
                    [--vnet-name]

Voorbeelden

Maak een container in een containergroep met 1 kern en 1 GB geheugen.

az container create -g MyResourceGroup --name myapp --image myimage:latest --cpu 1 --memory 1

Maak een container in een containergroep met Windows, met 2 kernen en 3,5 GB geheugen.

az container create -g MyResourceGroup --name mywinapp --image winappimage:latest --os-type Windows --cpu 2 --memory 3.5

Maak een container in een containergroep met een openbaar IP-adres, poorten en DNS-naamlabel.

az container create -g MyResourceGroup --name myapp --image myimage:latest --ports 80 443 --dns-name-label contoso

Maak een container in een containergroep die een script aanroept bij het starten.

az container create -g MyResourceGroup --name myapp --image myimage:latest --command-line "/bin/sh -c '/path to/myscript.sh'"

Maak een container in een containergroep waarin een opdracht wordt uitgevoerd en stop de container daarna.

az container create -g MyResourceGroup --name myapp --image myimage:latest --command-line "echo hello" --restart-policy Never

Maak een container in een containergroep met omgevingsvariabelen.

az container create -g MyResourceGroup --name myapp --image myimage:latest --environment-variables key1=value1 key2=value2

Maak een container in een containergroep met behulp van een containerafbeelding van Azure Container Registry.

az container create -g MyResourceGroup --name myapp --image myAcrRegistry.azurecr.io/myimage:latest --registry-password password

Maak een container in een containergroep die een Azure-bestands share als volume aan elkaar bevestigt.

az container create -g MyResourceGroup --name myapp --image myimage:latest --command-line "cat /mnt/azfile/myfile" --azure-file-volume-share-name myshare --azure-file-volume-account-name mystorageaccount --azure-file-volume-account-key mystoragekey --azure-file-volume-mount-path /mnt/azfile

Maak een container in een containergroep die een Git-repo als volume aan een container groepeert.

az container create -g MyResourceGroup --name myapp --image myimage:latest --command-line "cat /mnt/gitrepo" --gitrepo-url https://github.com/user/myrepo.git --gitrepo-dir ./dir1 --gitrepo-mount-path /mnt/gitrepo

Maak een container in een containergroep met behulp van een yaml-bestand.

az container create -g MyResourceGroup -f containerGroup.yaml

Maak een containergroep met behulp van Log Analytics op basis van de naam van een werkruimte.

az container create -g MyResourceGroup --name myapp --log-analytics-workspace myworkspace

Maak een containergroep met een door het systeem toegewezen identiteit.

az container create -g MyResourceGroup --name myapp --image myimage:latest --assign-identity

Maak een containergroep met een door het systeem toegewezen identiteit. De groep heeft de rol 'Inzender' met toegang tot een opslagaccount.

az container create -g MyResourceGroup --name myapp --image myimage:latest --assign-identity --scope /subscriptions/99999999-1bf0-4dda-aec3-cb9272f09590/MyResourceGroup/myRG/providers/Microsoft.Storage/storageAccounts/storage1

Maak een containergroep met een door de gebruiker toegewezen identiteit.

az container create -g MyResourceGroup --name myapp --image myimage:latest --assign-identity  /subscriptions/mySubscriptionId/resourcegroups/myRG/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myID

Maak een containergroep met een door het systeem en de gebruiker toegewezen identiteit.

az container create -g MyResourceGroup --name myapp --image myimage:latest --assign-identity [system] /subscriptions/mySubscriptionId/resourcegroups/myRG/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myID

Vereiste parameters

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

Optionele parameters

--assign-identity

Door spatie gescheiden lijst met toegewezen identiteiten. Toegewezen identiteiten zijn door de gebruiker toegewezen identiteiten (resource-id's) en/of de door het systeem toegewezen identiteit ('[system]'). Zie voorbeelden voor meer informatie.

--azure-file-volume-account-key

De toegangssleutel voor het opslagaccount die wordt gebruikt voor toegang tot de Azure-bestands share.

--azure-file-volume-account-name

De naam van het opslagaccount dat de Azure-bestands share bevat.

--azure-file-volume-mount-path

Het pad binnen de container waar het Azure-bestandsvolume moet worden bevestigd. Mag geen dubbele punt ':' bevatten.

--azure-file-volume-share-name

De naam van de Azure-bestands share die moet worden bevestigd als een volume.

--command-line

De opdrachtregel die moet worden uitgevoerd wanneer de container wordt gestart, bijvoorbeeld '/bin/bash -c myscript.sh'.

--cpu

Het vereiste aantal CPU-kernen van de containers, nauwkeurig tot één decimale plaats.

standaardwaarde: 1
--dns-name-label

Het DNS-naamlabel voor de containergroep met een openbaar IP-adres.

--environment-variables -e

Een lijst met omgevingsvariabele voor de container. Door spaties gescheiden waarden in de notatie 'sleutel=waarde'.

--file -f

Het pad naar het invoerbestand.

--gitrepo-dir

Het pad naar de doelmap in de Git-opslagplaats. Mag geen '..' bevatten.

standaardwaarde: .
--gitrepo-mount-path

Het pad binnen de container waar het git-repo-volume moet worden bevestigd. Mag geen dubbele punt ':' bevatten.

--gitrepo-revision

De commit-hash voor de opgegeven revisie.

--gitrepo-url

De URL van een Git-opslagplaats die als een volume moet worden bevestigd.

--image

De naam van de containerafbeelding.

--ip-address

Het IP-adrestype van de containergroep.

geaccepteerde waarden: Private, Public
--location -l

Locatie. Waarden van: az account list-locations . U kunt de standaardlocatie configureren met az configure --defaults location=<location> behulp van .

--log-analytics-workspace

De naam of id van de Log Analytics-werkruimte. Gebruik het huidige abonnement of gebruik de vlag --subscription om het gewenste abonnement in te stellen.

--log-analytics-workspace-key

De Log Analytics-werkruimtesleutel.

--memory

Het vereiste geheugen van de containers in GB, nauwkeurig tot één decimale plaats.

standaardwaarde: 1.5
--name -n

De naam van de containergroep.

--network-profile

De naam of id van het netwerkprofiel.

--no-wait

Wacht niet tot de langlopende bewerking is uitgevoerd.

--os-type

Het type besturingssysteem van de containers.

geaccepteerde waarden: Linux, Windows
standaardwaarde: Linux
--ports

Een lijst met poorten die moeten worden geopend. Door spaties gescheiden lijst met poorten.

standaardwaarde: [80]
--protocol

Het netwerkprotocol dat moet worden gebruikt.

geaccepteerde waarden: TCP, UDP
--registry-login-server

De aanmeldingsserver voor het containerregister.

--registry-password

Het wachtwoord voor het aanmelden bij de registerserver voor containerafbeeldingen.

--registry-username

De gebruikersnaam voor het aanmelden bij de registerserver voor containerafbeeldingen.

--restart-policy

Beleid voor opnieuw opstarten voor alle containers in de containergroep.

geaccepteerde waarden: Always, Never, OnFailure
standaardwaarde: Always
--role

Rolnaam of id van de door het systeem toegewezen identiteit.

standaardwaarde: Contributor
--scope

Bereik waar de door het systeem toegewezen identiteit toegang toe heeft.

--secrets

Door ruimte gescheiden geheimen in de indeling 'key=value'.

--secrets-mount-path

Het pad binnen de container waar het geheimenvolume moet worden bevestigd. Mag geen dubbele punt ':' bevatten.

--secure-environment-variables

Een lijst met beveiligde omgevingsvariabele voor de container. Door spaties gescheiden waarden in de notatie 'key=value'.

--subnet

De naam van het subnet bij het maken van een nieuw VNET of bij het verwijzen naar een bestaand subnet. Kan ook verwijzen naar een bestaand subnet op id.

--subnet-address-prefix

Het VOORvoegsel van het IP-adres van het subnet dat moet worden gebruikt bij het maken van een nieuw VNET in CIDR-indeling.

standaardwaarde: 10.0.0.0/24
--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID .

--vnet

De naam van het VNET wanneer u een nieuw VNET maakt of verwijst naar een bestaand VNET. Kan ook verwijzen naar een bestaand vnet op id. Hiermee kunt u vnets uit andere resourcegroepen gebruiken.

--vnet-address-prefix

Het IP-adres voorvoegsel dat moet worden gebruikt bij het maken van een nieuw VNET in CIDR-indeling.

standaardwaarde: 10.0.0.0/16
--vnet-name

De naam van het VNET wanneer u een nieuw VNET maakt of verwijst naar een bestaand VNET.

az container delete

Verwijder een containergroep.

az container delete [--ids]
                    [--name]
                    [--resource-group]
                    [--subscription]
                    [--yes]

Voorbeelden

Verwijder een containergroep. (automatisch gegenereerd)

az container delete --name MyContainerGroup --resource-group MyResourceGroup

Optionele parameters

--ids

Een of meer resource-ID's (door spaties scheidingstekens). Dit moet een volledige resource-id zijn die alle gegevens van de argumenten 'Resource-id' bevat. U moet --id's of andere argumenten voor resource-id's verstrekken.

--name -n

De naam van de containergroep.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met az account set -s NAME_OR_ID behulp van .

--yes -y

Niet vragen om bevestiging.

az container exec

Voer een opdracht uit vanuit een container die wordt uitgevoerd in een containergroep.

De meest voorkomende use-case is het openen van een interactieve bash-shell. Zie de onderstaande voorbeelden. Deze opdracht wordt momenteel niet ondersteund voor Windows-machines.

az container exec --exec-command
                  [--container-name]
                  [--ids]
                  [--name]
                  [--resource-group]
                  [--subscription]
                  [--terminal-col-size]
                  [--terminal-row-size]

Voorbeelden

Stream een shell vanuit een nginx-container.

az container exec -g MyResourceGroup --name mynginx --container-name nginx --exec-command "/bin/bash"

Vereiste parameters

--exec-command

De opdracht die moet worden uitgevoerd vanuit de container.

Optionele parameters

--container-name

De containernaam waar de opdracht moet worden uitgevoerd. Kan worden weggelaten voor containergroepen met slechts één container.

--ids

Een of meer resource-ID's (door spaties scheidingstekens). Dit moet een volledige resource-id zijn die alle gegevens van de argumenten 'Resource-id' bevat. U moet --id's of andere argumenten voor resource-id's verstrekken.

--name -n

De naam van de containergroep.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID .

--terminal-col-size

De colgrootte voor de uitvoer van de opdracht.

standaardwaarde: 80
--terminal-row-size

De rijgrootte voor de uitvoer van de opdracht.

standaardwaarde: 20

az container export

Exporteert een containergroep in yaml-indeling.

az container export --file
                    [--ids]
                    [--name]
                    [--resource-group]
                    [--subscription]

Voorbeelden

Exporteert u een containergroep in yaml.

az container export -g MyResourceGroup --name mynginx -f output.yaml

Vereiste parameters

--file -f

Het bestandspad voor het exporteren van de containergroep.

Optionele parameters

--ids

Een of meer resource-ID's (door spaties scheidingstekens). Dit moet een volledige resource-id zijn die alle gegevens van de argumenten 'Resource-id' bevat. U moet --id's of andere argumenten voor resource-id's verstrekken.

--name -n

De naam van de containergroep.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID .

az container list

Lijst met containergroepen maken.

az container list [--query-examples]
                  [--resource-group]
                  [--subscription]

Optionele parameters

--query-examples

JMESPath-tekenreeks voor u aanbevelen. U kunt een van de query's kopiëren en deze na de parameter --query tussen dubbele aanhalingstekens plakken om de resultaten te bekijken. U kunt een of meer positionele trefwoorden toevoegen, zodat we suggesties kunnen geven op basis van deze sleutelwoorden.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met az account set -s NAME_OR_ID behulp van .

az container logs

Bekijk de logboeken voor een container in een containergroep.

az container logs [--container-name]
                  [--follow]
                  [--ids]
                  [--name]
                  [--resource-group]
                  [--subscription]

Voorbeelden

Bekijk de logboeken voor een container in een containergroep. (automatisch gegenereerd)

az container logs --name MyContainerGroup --resource-group MyResourceGroup

Optionele parameters

--container-name

De containernaam voor het volgen van de logboeken. Als u dit weggelaten, wordt de eerste container in de containergroep gekozen.

--follow

Geef aan dat de tailing-logboeken moeten worden gestreamd.

--ids

Een of meer resource-ID's (door spaties scheidingstekens). Dit moet een volledige resource-id zijn die alle gegevens van de argumenten 'Resource-id' bevat. U moet --id's of andere argumenten voor resource-id's verstrekken.

--name -n

De naam van de containergroep.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met az account set -s NAME_OR_ID behulp van .

az container restart

Start alle containers in een containergroep opnieuw op.

Start alle containers in een containergroep opnieuw op. Als de containerafbeelding updates heeft, wordt er een nieuwe afbeelding gedownload.

az container restart --name
                     --resource-group
                     [--no-wait]
                     [--subscription]

Vereiste parameters

--name -n

De naam van de containergroep.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

Optionele parameters

--no-wait

Wacht niet tot de langlopende bewerking is uitgevoerd.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met az account set -s NAME_OR_ID behulp van .

az container show

Haal de details van een containergroep op.

az container show [--ids]
                  [--name]
                  [--query-examples]
                  [--resource-group]
                  [--subscription]

Voorbeelden

Haal de details van een containergroep op. (automatisch gegenereerd)

az container show --name MyContainerGroup --resource-group MyResourceGroup

Optionele parameters

--ids

Een of meer resource-ID's (door spaties scheidingstekens). Dit moet een volledige resource-id zijn die alle gegevens van de argumenten 'Resource-id' bevat. U moet --id's of andere argumenten voor resource-id's verstrekken.

--name -n

De naam van de containergroep.

--query-examples

JMESPath-tekenreeks voor u aanbevelen. U kunt een van de query's kopiëren en plakken na de parameter --query tussen dubbele aanhalingstekens om de resultaten te bekijken. U kunt een of meer positionele trefwoorden toevoegen, zodat we suggesties kunnen geven op basis van deze sleutelwoorden.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met az account set -s NAME_OR_ID behulp van .

az container start

Start alle containers in een containergroep.

Start alle containers in een containergroep.

az container start --name
                   --resource-group
                   [--no-wait]
                   [--subscription]

Vereiste parameters

--name -n

De naam van de containergroep.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

Optionele parameters

--no-wait

Wacht niet tot de langlopende bewerking is uitgevoerd.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met az account set -s NAME_OR_ID behulp van .

az container stop

Stopt alle containers in een containergroep.

Stopt alle containers in een containergroep. De toewijzing van rekenbronnen wordt niet meer toegewezen en de facturering wordt gestopt.

az container stop --name
                  --resource-group
                  [--subscription]

Vereiste parameters

--name -n

De naam van de containergroep.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

Optionele parameters

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met az account set -s NAME_OR_ID behulp van .