Delen via

az containerapp sessionpool

  • Preview
  • Referentie

Notitie

Deze verwijzing maakt deel uit van de containerapp-extensie voor de Azure CLI (versie 2.62.0 of hoger). De extensie installeert automatisch de eerste keer dat u een az containerapp sessionpool-opdracht uitvoert. Meer informatie over extensies.

Deze opdrachtgroep is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Opdrachten voor het beheren van sessiegroepen.

Opdracht

Name Description Type Status
az containerapp sessionpool create

Een sessiegroep maken of bijwerken.

 Toestel Preview uitvoeren
az containerapp sessionpool delete

Een sessiegroep verwijderen.

 Toestel Preview uitvoeren
az containerapp sessionpool list

Lijst met sessiegroepen per abonnement of resourcegroep.

 Toestel Preview uitvoeren
az containerapp sessionpool show

Details van een sessiegroep weergeven.

 Toestel Preview uitvoeren
az containerapp sessionpool update

Een sessiegroep bijwerken.

 Toestel Preview uitvoeren

az containerapp sessionpool create

Preview

De opdrachtgroep 'containerapp sessionpool' is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Een sessiegroep maken of bijwerken.

az containerapp sessionpool create --name
                                   --resource-group
                                   [--args]
                                   [--command]
                                   [--container-name]
                                   [--container-type {CustomContainer, NodeLTS, PythonLTS}]
                                   [--cooldown-period]
                                   [--cpu]
                                   [--env-vars]
                                   [--environment]
                                   [--image]
                                   [--location]
                                   [--max-sessions]
                                   [--memory]
                                   [--mi-system-assigned]
                                   [--mi-user-assigned]
                                   [--network-status {EgressDisabled, EgressEnabled}]
                                   [--no-wait]
                                   [--ready-sessions]
                                   [--registry-identity]
                                   [--registry-password]
                                   [--registry-server]
                                   [--registry-username]
                                   [--secrets]
                                   [--target-port]

Voorbeelden

Een sessiegroep maken of bijwerken met standaardinstellingen voor PythonLTS van het containertype.

az containerapp sessionpool create -n mysessionpool -g MyResourceGroup \
    --location eastasia

Maak of werk een sessiegroep bij met het containertype PythonLTS, waarbij maximaal 30 gelijktijdige sessies gereed zijn voor sessie-exemplaren 20.

az containerapp sessionpool create -n mysessionpool -g MyResourceGroup \
    --container-type PythonLTS --max-sessions 30 --ready-sessions 20 \
    --location eastasia

Maak of werk een sessiegroep bij met het containertype CustomContainer met standaard quickstart-installatiekopie.

az containerapp sessionpool create -n mysessionpool -g MyResourceGroup \
    --container-type CustomContainer --environment MyEnvironment \
    --cpu 0.5 --memory 1Gi --target-port 80 --location eastasia --image mcr.microsoft.com/k8se/quickstart:latest

Maak of werk een sessiegroep bij met het containertype CustomContainer met geheimen en omgevingsvariabelen.

az containerapp sessionpool create -n mysessionpool -g MyResourceGroup \
    --container-type CustomContainer --environment MyEnvironment \
    --cpu 0.5 --memory 1Gi --target-port 80 --image MyImage \
    --env-vars GREETING="Hello, world" SECRETENV=secretref:anothersecret \
    --secrets mysecret=secretvalue1 anothersecret="secret value 2" --location eastasia

Een sessiegroep maken of bijwerken met het containertype CustomContainer die afkomstig is van een privéregister

az containerapp sessionpool create -n mysessionpool -g MyResourceGroup \
    --container-type CustomContainer --environment MyEnvironment --image MyImage \
    --cpu 0.5 --memory 1Gi --target-port 80 --registry-server myregistry.azurecr.io \
    --registry-username myregistry --registry-password $REGISTRY_PASSWORD \
    --location eastasia

Een sessiegroep maken of bijwerken met het containertype CustomContainer en Managed Identity om Azure Container Registry te verifiëren

az containerapp sessionpool create -n mysessionpool -g MyResourceGroup \
    --container-type CustomContainer --environment MyEnvironment --image MyImage \
    --cpu 0.5 --memory 1Gi --target-port 80 --registry-server myregistry.azurecr.io \
    --registry-identity  MyUserIdentityResourceId \
    --location eastasia

Maak of werk een sessiegroep bij met het containertype CustomContainer met door het systeem toegewezen en door de gebruiker toegewezen identiteit.

az containerapp sessionpool create -n mysessionpool -g MyResourceGroup \
    --container-type CustomContainer --environment MyEnvironment --image MyImage \
    --cpu 0.5 --memory 1Gi --target-port 80 \
    --mi-system-assigned --mi-user-assigned MyUserIdentityResourceId \
    --location eastasia

Een sessiegroep maken of bijwerken met het containertype CustomContainer met cooldownperiode 360s

az containerapp sessionpool create -n mysessionpool -g MyResourceGroup \
    --environment MyEnvironment --cpu 0.5 --memory 1Gi --target-port 80 --container-type CustomContainer \
    --cooldown-period 360 --location eastasia

Vereiste parameters

--name -n

De naam van de sessiegroep.

--resource-group -g

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

Optionele parameters

--args

Een lijst met opstartopdrachtargumenten voor containers. Door spaties gescheiden waarden, bijvoorbeeld '-c' 'mycommand'. Lege tekenreeks om bestaande waarden te wissen.

--command

Een lijst met ondersteunde opdrachten in de container die wordt uitgevoerd tijdens het opstarten. Door spaties gescheiden waarden, bijvoorbeeld '/bin/queue' 'mycommand'. Lege tekenreeks om bestaande waarden te wissen.

--container-name

Naam van de container. Bij het maken als er geen containernaam is opgegeven, wordt de containernaam standaard ingesteld op de naam van de sessiegroep die wordt bedekt met kleine letters.

--container-type

Het groepstype van de sessiegroep, default='PythonLTS'.

Geaccepteerde waarden: CustomContainer, NodeLTS, PythonLTS
--cooldown-period

Periode (in seconden), waarna de sessie wordt verwijderd, standaard=300.

--cpu

Vereiste CPU in kernen van 0,25 - 2.0, bijvoorbeeld 0,5.

--env-vars

Een lijst met omgevingsvariabelen voor de container. Door spaties gescheiden waarden in de notatie 'key=value'. Lege tekenreeks om bestaande waarden te wissen. Voorvoegselwaarde met 'secretref:' om te verwijzen naar een geheim.

--environment

Naam of resource-id van de omgeving van de container-app.

--image -i

Containerinstallatiekopieën, bijvoorbeeld publisher/image-name:tag.

--location -l

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

--max-sessions

Het maximum aantal sessies kan tegelijkertijd worden uitgevoerd.

--memory

Vereist geheugen van 0,5 - 4,0 eindigend op "Gi", bijvoorbeeld 1.0Gi.

--mi-system-assigned

Booleaanse waarde die aangeeft of een door het systeem toegewezen identiteit moet worden toegewezen.

Default value: False
--mi-user-assigned

Door ruimte gescheiden gebruikersidentiteiten die moeten worden toegewezen.

--network-status

Uitgaand verkeer is ingeschakeld voor de sessies of niet.

Geaccepteerde waarden: EgressDisabled, EgressEnabled
--no-wait

Wacht niet totdat de langdurige bewerking is voltooid.

Default value: False
--ready-sessions

Het aantal sessies dat altijd gereed is in de sessiegroep.

--registry-identity

De beheerde identiteit waarmee moet worden geverifieerd bij Azure Container Registry (in plaats van gebruikersnaam/wachtwoord). Gebruik 'systeem' voor een door het systeem toegewezen identiteit, gebruik een resource-id voor een door de gebruiker toegewezen identiteit. De beheerde identiteit moet zijn toegewezen aan acrpull-machtigingen voor de ACR vóór de implementatie (gebruik 'az role assignment create --role acrpull ...').

--registry-password

Het wachtwoord om u aan te melden bij het containerregister. Als deze is opgeslagen als geheim, moet de waarde beginnen met 'secretref:', gevolgd door de geheime naam.

--registry-server

De hostnaam van de containerregisterserver, bijvoorbeeld myregistry.azurecr.io.

--registry-username

De gebruikersnaam om u aan te melden bij het containerregister.

--secrets -s

Een lijst met geheimen voor de sessiegroep. Door spaties gescheiden waarden in de notatie 'key=value'. Lege tekenreeks om bestaande waarden te wissen.

--target-port

De sessiepoort die wordt gebruikt voor inkomend verkeer.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

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

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az containerapp sessionpool delete

Preview

De opdrachtgroep 'containerapp sessionpool' is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Een sessiegroep verwijderen.

az containerapp sessionpool delete --resource-group
                                   [--ids]
                                   [--name]
                                   [--no-wait]
                                   [--subscription]
                                   [--yes]

Voorbeelden

Een sessiegroep verwijderen.

az containerapp sessionpool delete -n mysessionpool -g MyResourceGroup

Vereiste parameters

--resource-group -g

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

Optionele parameters

--ids

Een of meer resource-id's (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. Geef de argumenten --id's of andere resource-id's op.

--name -n

De naam van de sessiegroep.

--no-wait

Wacht niet totdat de langdurige bewerking is voltooid.

Default value: False
--subscription

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

--yes -y

Niet vragen om bevestiging.

Default value: False
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

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

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az containerapp sessionpool list

Preview

De opdrachtgroep 'containerapp sessionpool' is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Lijst met sessiegroepen per abonnement of resourcegroep.

az containerapp sessionpool list [--resource-group]

Voorbeelden

Lijst met sessiegroepen in het huidige abonnement.

az containerapp sessionpool list

Lijst met sessiegroepen per resourcegroep.

az containerapp sessionpool list -g MyResourceGroup

Optionele parameters

--resource-group -g

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

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

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

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az containerapp sessionpool show

Preview

De opdrachtgroep 'containerapp sessionpool' is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Details van een sessiegroep weergeven.

az containerapp sessionpool show --resource-group
                                 [--ids]
                                 [--name]
                                 [--subscription]

Voorbeelden

De details van een sessiegroep weergeven.

az containerapp sessionpool show -n mysessionpool -g MyResourceGroup

Vereiste parameters

--resource-group -g

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

Optionele parameters

--ids

Een of meer resource-id's (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. Geef de argumenten --id's of andere resource-id's op.

--name -n

De naam van de sessiegroep.

--subscription

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

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

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

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az containerapp sessionpool update

Preview

De opdrachtgroep 'containerapp sessionpool' is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Een sessiegroep bijwerken.

az containerapp sessionpool update --resource-group
                                   [--args]
                                   [--command]
                                   [--container-name]
                                   [--cooldown-period]
                                   [--cpu]
                                   [--env-vars]
                                   [--ids]
                                   [--image]
                                   [--location]
                                   [--max-sessions]
                                   [--memory]
                                   [--name]
                                   [--network-status {EgressDisabled, EgressEnabled}]
                                   [--no-wait]
                                   [--ready-sessions]
                                   [--registry-password]
                                   [--registry-server]
                                   [--registry-username]
                                   [--secrets]
                                   [--subscription]
                                   [--target-port]

Voorbeelden

Werk de maximale configuratie en installatiekopieën van een sessiegroep bij.

az containerapp sessionpool update -n mysessionpool -g MyResourceGroup --max-sessions 20 --image MyNewImage

Vereiste parameters

--resource-group -g

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

Optionele parameters

--args

Een lijst met opstartopdrachtargumenten voor containers. Door spaties gescheiden waarden, bijvoorbeeld '-c' 'mycommand'. Lege tekenreeks om bestaande waarden te wissen.

--command

Een lijst met ondersteunde opdrachten in de container die wordt uitgevoerd tijdens het opstarten. Door spaties gescheiden waarden, bijvoorbeeld '/bin/queue' 'mycommand'. Lege tekenreeks om bestaande waarden te wissen.

--container-name

Naam van de container. Bij het maken als er geen containernaam is opgegeven, wordt de containernaam standaard ingesteld op de naam van de sessiegroep die wordt bedekt met kleine letters.

--cooldown-period

Periode (in seconden), waarna de sessie wordt verwijderd, standaard=300.

--cpu

Vereiste CPU in kernen van 0,25 - 2.0, bijvoorbeeld 0,5.

--env-vars

Een lijst met omgevingsvariabelen voor de container. Door spaties gescheiden waarden in de notatie 'key=value'. Lege tekenreeks om bestaande waarden te wissen. Voorvoegselwaarde met 'secretref:' om te verwijzen naar een geheim.

--ids

Een of meer resource-id's (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. Geef de argumenten --id's of andere resource-id's op.

--image -i

Containerinstallatiekopieën, bijvoorbeeld publisher/image-name:tag.

--location -l

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

--max-sessions

Het maximum aantal sessies kan tegelijkertijd worden uitgevoerd.

--memory

Vereist geheugen van 0,5 - 4,0 eindigend op "Gi", bijvoorbeeld 1.0Gi.

--name -n

De naam van de sessiegroep.

--network-status

Uitgaand verkeer is ingeschakeld voor de sessies of niet.

Geaccepteerde waarden: EgressDisabled, EgressEnabled
--no-wait

Wacht niet totdat de langdurige bewerking is voltooid.

Default value: False
--ready-sessions

Het aantal sessies dat altijd gereed is in de sessiegroep.

--registry-password

Het wachtwoord om u aan te melden bij het containerregister. Als deze is opgeslagen als geheim, moet de waarde beginnen met 'secretref:', gevolgd door de geheime naam.

--registry-server

De hostnaam van de containerregisterserver, bijvoorbeeld myregistry.azurecr.io.

--registry-username

De gebruikersnaam om u aan te melden bij het containerregister.

--secrets -s

Een lijst met geheimen voor de sessiegroep. Door spaties gescheiden waarden in de notatie 'key=value'. Lege tekenreeks om bestaande waarden te wissen.

--subscription

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

--target-port

De sessiepoort die wordt gebruikt voor inkomend verkeer.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

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

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.