다음을 통해 공유

az containerapp sessionpool

  • 미리 보기
  • 참조

참고 항목

이 참조는 Azure CLI(버전 2.62.0 이상)에 대한 containerapp 확장의 일부입니다. az containerapp sessionpool 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장 프로그램에 대해 자세히 알아보세요.

이 명령 그룹은 미리 보기 상태이며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

세션 풀을 관리하는 명령입니다.

명령

Name Description 형식 상태
az containerapp sessionpool create

세션 풀을 만들거나 업데이트합니다.

 내선 번호 프리뷰
az containerapp sessionpool delete

세션 풀을 삭제합니다.

 내선 번호 프리뷰
az containerapp sessionpool list

구독 또는 리소스 그룹별로 세션 풀을 나열합니다.

 내선 번호 프리뷰
az containerapp sessionpool show

세션 풀의 세부 정보를 표시합니다.

 내선 번호 프리뷰
az containerapp sessionpool update

세션 풀을 업데이트합니다.

 내선 번호 프리뷰

az containerapp sessionpool create

미리 보기

명령 그룹 'containerapp sessionpool'은 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

세션 풀을 만들거나 업데이트합니다.

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]

예제

컨테이너 유형 PythonLTS 기본 설정을 사용하여 세션 풀을 만들거나 업데이트합니다.

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

최대 동시 세션이 30개, 준비된 세션 인스턴스 20인 컨테이너 형식 PythonLTS를 사용하여 세션 풀을 만들거나 업데이트합니다.

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

기본 빠른 시작 이미지를 사용하여 컨테이너 형식 CustomContainer를 사용하여 세션 풀을 만들거나 업데이트합니다.

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

비밀 및 환경 변수가 있는 CustomContainer 컨테이너 형식으로 세션 풀을 만들거나 업데이트합니다.

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

프라이빗 레지스트리에서 컨테이너 형식 CustomContainer를 사용하여 세션 풀 만들기 또는 업데이트

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

컨테이너 유형 CustomContainer 및 관리 ID를 사용하여 세션 풀을 만들거나 업데이트하여 Azure 컨테이너 레지스트리를 인증합니다.

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

시스템 할당 및 사용자 할당 ID를 사용하여 컨테이너 유형 CustomContainer를 사용하여 세션 풀을 만들거나 업데이트합니다.

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

컨테이너 유형 CustomContainer를 사용하여 세션 풀 만들기 또는 업데이트(쿨다운 기간 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

필수 매개 변수

--name -n

세션 풀 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--args

컨테이너 시작 명령 인수 목록입니다. 공백으로 구분된 값(예: "-c" "mycommand") 기존 값을 지우는 빈 문자열입니다.

--command

시작 중에 실행될 컨테이너에서 지원되는 명령 목록입니다. 공백으로 구분된 값(예: "/bin/queue" "mycommand") 기존 값을 지우는 빈 문자열입니다.

--container-name

컨테이너의 이름입니다. 컨테이너 이름이 제공되지 않으면 생성 시 컨테이너 이름은 기본적으로 소문자로 덮인 세션 풀의 이름으로 설정됩니다.

--container-type

세션 풀의 풀 유형(default='PythonLTS')입니다.

허용되는 값: CustomContainer, NodeLTS, PythonLTS
--cooldown-period

세션이 삭제되는 기간(초),기본값=300입니다.

--cpu

0.25에서 2.0(예: 0.5)의 코어에 필요한 CPU입니다.

--env-vars

컨테이너에 대한 환경 변수 목록입니다. 'key=value' 형식의 공백으로 구분된 값입니다. 기존 값을 지우는 빈 문자열입니다. 비밀을 참조하기 위해 'secretref:'가 있는 접두사 값입니다.

--environment

컨테이너 앱 환경의 이름 또는 리소스 ID입니다.

--image -i

컨테이너 이미지(예: publisher/image-name:tag).

--location -l

위치. 값 출처: az account list-locations. az configure --defaults location=<location>을 사용하여 기본 위치를 구성할 수 있습니다.

--max-sessions

세션의 최대 개수를 동시에 실행할 수 있습니다.

--memory

"Gi"로 끝나는 0.5- 4.0의 필수 메모리(예: 1.0Gi).

--mi-system-assigned

시스템 할당 ID를 할당할지 여부를 나타내는 부울입니다.

Default value: False
--mi-user-assigned

할당할 공백으로 구분된 사용자 ID입니다.

--network-status

송신은 세션에 대해 사용하도록 설정되어 있는지 여부입니다.

허용되는 값: EgressDisabled, EgressEnabled
--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

Default value: False
--ready-sessions

세션 풀에서 항상 준비할 세션 수입니다.

--registry-identity

사용자 이름/암호 대신 Azure Container Registry에 인증할 관리 ID입니다. 시스템 할당 ID에 'system'을 사용하고 사용자 할당 ID에 리소스 ID를 사용합니다. 배포 전에 관리 ID에 ACR에 대한 acrpull 권한이 할당되어야 합니다('az role assignment create --role acrpull ...'사용).

--registry-password

컨테이너 레지스트리에 로그인할 암호입니다. 비밀로 저장되는 경우 값은 'secretref:' 뒤에 비밀 이름으로 시작해야 합니다.

--registry-server

컨테이너 레지스트리 서버 호스트 이름(예: myregistry.azurecr.io)입니다.

--registry-username

컨테이너 레지스트리에 로그인할 사용자 이름입니다.

--secrets -s

세션 풀에 대한 비밀 목록입니다. 'key=value' 형식의 공백으로 구분된 값입니다. 기존 값을 지우는 빈 문자열입니다.

--target-port

수신 트래픽에 사용되는 세션 포트입니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az containerapp sessionpool delete

미리 보기

명령 그룹 'containerapp sessionpool'은 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

세션 풀을 삭제합니다.

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

예제

세션 풀을 삭제합니다.

az containerapp sessionpool delete -n mysessionpool -g MyResourceGroup

필수 매개 변수

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 완전한 리소스 ID여야 합니다. --ids 또는 기타 '리소스 ID' 인수를 제공해야 합니다.

--name -n

세션 풀 이름입니다.

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

Default value: False
--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--yes -y

확인을 묻는 메시지를 표시하지 마세요.

Default value: False
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az containerapp sessionpool list

미리 보기

명령 그룹 'containerapp sessionpool'은 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

구독 또는 리소스 그룹별로 세션 풀을 나열합니다.

az containerapp sessionpool list [--resource-group]

예제

현재 구독의 세션 풀을 나열합니다.

az containerapp sessionpool list

리소스 그룹별 세션 풀을 나열합니다.

az containerapp sessionpool list -g MyResourceGroup

선택적 매개 변수

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az containerapp sessionpool show

미리 보기

명령 그룹 'containerapp sessionpool'은 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

세션 풀의 세부 정보를 표시합니다.

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

예제

세션 풀의 세부 정보를 표시합니다.

az containerapp sessionpool show -n mysessionpool -g MyResourceGroup

필수 매개 변수

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 완전한 리소스 ID여야 합니다. --ids 또는 기타 '리소스 ID' 인수를 제공해야 합니다.

--name -n

세션 풀 이름입니다.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az containerapp sessionpool update

미리 보기

명령 그룹 'containerapp sessionpool'은 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

세션 풀을 업데이트합니다.

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]

예제

세션 풀의 최대 동시 세션 구성 및 이미지를 업데이트합니다.

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

필수 매개 변수

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--args

컨테이너 시작 명령 인수 목록입니다. 공백으로 구분된 값(예: "-c" "mycommand") 기존 값을 지우는 빈 문자열입니다.

--command

시작 중에 실행될 컨테이너에서 지원되는 명령 목록입니다. 공백으로 구분된 값(예: "/bin/queue" "mycommand") 기존 값을 지우는 빈 문자열입니다.

--container-name

컨테이너의 이름입니다. 컨테이너 이름이 제공되지 않으면 생성 시 컨테이너 이름은 기본적으로 소문자로 덮인 세션 풀의 이름으로 설정됩니다.

--cooldown-period

세션이 삭제되는 기간(초),기본값=300입니다.

--cpu

0.25에서 2.0(예: 0.5)의 코어에 필요한 CPU입니다.

--env-vars

컨테이너에 대한 환경 변수 목록입니다. 'key=value' 형식의 공백으로 구분된 값입니다. 기존 값을 지우는 빈 문자열입니다. 비밀을 참조하기 위해 'secretref:'가 있는 접두사 값입니다.

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 완전한 리소스 ID여야 합니다. --ids 또는 기타 '리소스 ID' 인수를 제공해야 합니다.

--image -i

컨테이너 이미지(예: publisher/image-name:tag).

--location -l

위치. 값 출처: az account list-locations. az configure --defaults location=<location>을 사용하여 기본 위치를 구성할 수 있습니다.

--max-sessions

세션의 최대 개수를 동시에 실행할 수 있습니다.

--memory

"Gi"로 끝나는 0.5- 4.0의 필수 메모리(예: 1.0Gi).

--name -n

세션 풀 이름입니다.

--network-status

송신은 세션에 대해 사용하도록 설정되어 있는지 여부입니다.

허용되는 값: EgressDisabled, EgressEnabled
--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

Default value: False
--ready-sessions

세션 풀에서 항상 준비할 세션 수입니다.

--registry-password

컨테이너 레지스트리에 로그인할 암호입니다. 비밀로 저장되는 경우 값은 'secretref:' 뒤에 비밀 이름으로 시작해야 합니다.

--registry-server

컨테이너 레지스트리 서버 호스트 이름(예: myregistry.azurecr.io)입니다.

--registry-username

컨테이너 레지스트리에 로그인할 사용자 이름입니다.

--secrets -s

세션 풀에 대한 비밀 목록입니다. 'key=value' 형식의 공백으로 구분된 값입니다. 기존 값을 지우는 빈 문자열입니다.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--target-port

수신 트래픽에 사용되는 세션 포트입니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.