az spring app

참고 항목

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

Azure Spring Apps에서 앱을 관리하는 명령입니다.

명령

Name	Description	형식	상태
az spring app append-loaded-public-certificate	Azure Spring Apps의 앱에 로드된 새 공용 인증서를 추가합니다.	내선 번호	GA
az spring app append-persistent-storage	Azure Spring Apps의 앱에 새 영구 스토리지를 추가합니다.	내선 번호	GA
az spring app binding	Azure Data Services를 사용하여 바인딩을 관리하려면 설정을 적용하려면 앱을 수동으로 다시 시작해야 합니다.	내선 번호	더 이상 사용되지 않음
az spring app binding cosmos	Azure Cosmos DB 바인딩을 관리하는 명령입니다.	내선 번호	더 이상 사용되지 않음
az spring app binding cosmos add	Azure Cosmos DB를 앱과 바인딩합니다.	내선 번호	더 이상 사용되지 않음
az spring app binding cosmos update	앱의 Azure Cosmos DB 서비스 바인딩을 업데이트합니다.	내선 번호	더 이상 사용되지 않음
az spring app binding list	앱의 모든 서비스 바인딩을 나열합니다.	내선 번호	더 이상 사용되지 않음
az spring app binding mysql	Azure Database for MySQL 바인딩을 관리하는 명령입니다.	내선 번호	더 이상 사용되지 않음
az spring app binding mysql add	Azure Database for MySQL을 앱과 바인딩합니다.	내선 번호	더 이상 사용되지 않음
az spring app binding mysql update	앱의 Azure Database for MySQL 서비스 바인딩을 업데이트합니다.	내선 번호	더 이상 사용되지 않음
az spring app binding redis	Azure Cache for Redis 바인딩을 관리하는 명령입니다.	내선 번호	더 이상 사용되지 않음
az spring app binding redis add	앱에 Azure Cache for Redis를 바인딩합니다.	내선 번호	더 이상 사용되지 않음
az spring app binding redis update	앱의 Azure Cache for Redis 서비스 바인딩을 업데이트합니다.	내선 번호	더 이상 사용되지 않음
az spring app binding remove	앱의 서비스 바인딩을 제거합니다.	내선 번호	더 이상 사용되지 않음
az spring app binding show	서비스 바인딩의 세부 정보를 표시합니다.	내선 번호	더 이상 사용되지 않음
az spring app connect	문제 해결을 위해 앱 인스턴스의 대화형 셸에 연결합니다.'	내선 번호	GA
az spring app create	Azure Spring Apps 인스턴스에서 기본 배포를 사용하여 새 앱을 만듭니다.	내선 번호	GA
az spring app custom-domain	사용자 지정 도메인을 관리하는 명령입니다.	내선 번호	GA
az spring app custom-domain bind	앱과 사용자 지정 도메인을 바인딩합니다.	내선 번호	GA
az spring app custom-domain list	앱의 모든 사용자 지정 도메인을 나열합니다.	내선 번호	GA
az spring app custom-domain show	사용자 지정 도메인의 세부 정보를 표시합니다.	내선 번호	GA
az spring app custom-domain unbind	앱의 사용자 지정 도메인을 바인딩 해제합니다.	내선 번호	GA
az spring app custom-domain update	앱의 사용자 지정 도메인을 업데이트합니다.	내선 번호	GA
az spring app delete	Azure Spring Apps에서 앱을 삭제합니다.	내선 번호	GA
az spring app deploy	소스 코드 또는 미리 빌드된 이진 파일을 앱에 배포하고 관련 구성을 업데이트합니다.	내선 번호	GA
az spring app deployment	Azure Spring Apps에서 앱 배포의 수명 주기를 관리하는 명령입니다. --deployment 매개 변수를 사용하여 앱 수준에서 배포에 대한 추가 작업을 수행할 수 있습니다. 예를 들어 az spring app deploy --deployment .	내선 번호	GA
az spring app deployment create	앱에 대한 스테이징 배포를 만듭니다. 기존 배포에 코드 또는 업데이트 설정을 배포하려면 .를 사용합니다 az spring app deploy/update --deployment <staging deployment>.	내선 번호	GA
az spring app deployment delete	앱 배포를 삭제합니다.	내선 번호	GA
az spring app deployment generate-heap-dump	지정된 파일 경로에 대한 대상 앱 인스턴스의 힙 덤프를 생성합니다.	내선 번호	GA
az spring app deployment generate-thread-dump	지정된 파일 경로에 대한 대상 앱 인스턴스의 스레드 덤프를 생성합니다.	내선 번호	GA
az spring app deployment list	앱의 모든 배포를 나열합니다.	내선 번호	GA
az spring app deployment show	배포의 세부 정보를 표시합니다.	내선 번호	GA
az spring app deployment start-jfr	지정된 파일 경로에 대한 대상 앱 인스턴스에서 JFR을 시작합니다.	내선 번호	GA
az spring app disable-remote-debugging	배포에 대한 원격 디버깅을 사용하지 않도록 설정합니다.	내선 번호	GA
az spring app enable-remote-debugging	배포에 대해 원격 디버깅을 사용하도록 설정합니다.	내선 번호	GA
az spring app get-remote-debugging-config	배포의 원격 디버깅 구성을 가져옵니다.	내선 번호	GA
az spring app identity	앱의 관리 ID를 관리합니다.	내선 번호	GA
az spring app identity assign	시스템 할당 관리 ID를 사용하도록 설정하거나 사용자 할당 관리 ID를 앱에 할당합니다.	내선 번호	GA
az spring app identity force-set	앱에서 관리 ID를 강제로 설정합니다.	내선 번호	GA
az spring app identity remove	앱에서 관리 ID를 제거합니다.	내선 번호	GA
az spring app identity show	앱의 관리 ID 정보를 표시합니다.	내선 번호	GA
az spring app list	Azure Spring Apps의 모든 앱을 나열합니다.	내선 번호	GA
az spring app log	여러 옵션이 있는 비상 앱 인스턴스 로그에 대한 명령입니다. 앱에 인스턴스가 하나만 있는 경우 인스턴스 이름은 선택 사항입니다.	내선 번호	더 이상 사용되지 않음
az spring app log tail	앱 인스턴스의 로그를 표시하면 '-f/--follow'를 설정할 때 로그가 스트리밍됩니다.	내선 번호	더 이상 사용되지 않음
az spring app logs	앱 인스턴스의 로그를 표시하면 '-f/--follow'를 설정할 때 로그가 스트리밍됩니다.	내선 번호	GA
az spring app restart	앱 인스턴스를 다시 시작하며, 기본적으로 프로덕션 배포로 설정됩니다.	내선 번호	GA
az spring app scale	앱 또는 해당 배포의 크기를 수동으로 조정합니다.	내선 번호	GA
az spring app set-deployment	앱의 프로덕션 배포를 설정합니다.	내선 번호	GA
az spring app show	Azure Spring Apps에서 앱의 세부 정보를 표시합니다.	내선 번호	GA
az spring app show-deploy-log	마지막 배포의 빌드 로그를 표시하고 소스 코드 배포에만 적용되며, 기본적으로 프로덕션 배포에 적용됩니다.	내선 번호	GA
az spring app start	앱의 인스턴스를 시작하며, 기본적으로 프로덕션 배포로 설정됩니다.	내선 번호	GA
az spring app stop	앱 인스턴스를 중지하고, 기본적으로 프로덕션 배포를 중지합니다.	내선 번호	GA
az spring app unset-deployment	앱의 설정되지 않은 프로덕션 배포입니다.	내선 번호	GA
az spring app update	앱의 구성을 업데이트합니다.	내선 번호	GA

az spring app append-loaded-public-certificate

Azure Spring Apps의 앱에 로드된 새 공용 인증서를 추가합니다.

az spring app append-loaded-public-certificate --certificate-name
                                               --load-trust-store {false, true}
                                               --name
                                               --resource-group
                                               --service

예제

로드된 새 공용 인증서를 앱에 추가합니다.

az spring app append-loaded-public-certificate --name MyApp --service MyCluster --resource-group MyResourceGroup --certificate-name MyCertName --load-trust-store true

필수 매개 변수

--certificate-name

추가할 인증서의 이름입니다.

--load-trust-store

true이면 인증서가 Java 애플리케이션에 대한 신뢰 저장소로 로드됩니다.

허용되는 값: false, true

Default value: False

--name -n

지정된 Azure Spring Apps 인스턴스에서 실행되는 앱의 이름입니다.

--resource-group -g

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

--service -s

Azure Spring Apps 인스턴스의 이름으로, az configure --defaults spring=를 사용하여 기본 서비스를 구성할 수 있습니다.

전역 매개 변수

--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 spring app append-persistent-storage

Azure Spring Apps의 앱에 새 영구 스토리지를 추가합니다.

az spring app append-persistent-storage --mount-path
                                        --name
                                        --persistent-storage-type
                                        --resource-group
                                        --service
                                        --storage-name
                                        [--enable-sub-path {false, true}]
                                        [--mount-options]
                                        [--read-only {false, true}]
                                        [--share-name]

예제

앱에 새 영구 스토리지를 추가합니다.

az spring app append-persistent-storage --persistent-storage-type AzureFileVolume --share-name MyShareName --mount-path /MyMountPath --storage-name MyStorageName -n MyApp -g MyResourceGroup -s MyService

필수 매개 변수

--mount-path

탑재할 영구 스토리지 볼륨의 경로입니다.

--name -n

지정된 Azure Spring Apps 인스턴스에서 실행되는 앱의 이름입니다.

--persistent-storage-type -t

볼륨된 영구 스토리지의 유형입니다.

--resource-group -g

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

--service -s

Azure Spring Apps 인스턴스의 이름으로, az configure --defaults spring=를 사용하여 기본 서비스를 구성할 수 있습니다.

--storage-name

Azure Spring Apps에서 만든 스토리지 리소스의 이름입니다.

선택적 매개 변수

--enable-sub-path

[선택 사항] true이면 각 앱 인스턴스에 대해 동일한 경로를 사용하여 별도의 하위 디렉터리에 탑재됩니다.

허용되는 값: false, true

Default value: False

--mount-options

[선택 사항] 영구 스토리지 볼륨에 대한 탑재 옵션입니다.

--read-only

[선택 사항] true이면 영구 스토리지 볼륨은 읽기 전용입니다.

허용되는 값: false, true

Default value: False

--share-name

미리 만든 파일 공유의 이름입니다. ShareName은 영구 스토리지 볼륨의 형식이 AzureFileVolume인 경우에만 제공해야 합니다.

전역 매개 변수

--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 spring app connect

문제 해결을 위해 앱 인스턴스의 대화형 셸에 연결합니다.'

az spring app connect --name
                      --resource-group
                      --service
                      [--deployment]
                      [--instance]
                      [--shell-cmd]

필수 매개 변수

--name -n

지정된 Azure Spring Apps 인스턴스에서 실행되는 앱의 이름입니다.

--resource-group -g

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

--service -s

Azure Spring Apps 인스턴스의 이름으로, az configure --defaults spring=를 사용하여 기본 서비스를 구성할 수 있습니다.

선택적 매개 변수

--deployment -d

앱의 기존 배포 이름입니다. 지정하지 않은 경우 프로덕션 배포의 기본값입니다.

--instance -i

배포의 기존 인스턴스 이름입니다.

--shell-cmd

앱 인스턴스에 연결할 때 실행할 셸 명령입니다.

Default value: /bin/sh

전역 매개 변수

--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 spring app create

Azure Spring Apps 인스턴스에서 기본 배포를 사용하여 새 앱을 만듭니다.

az spring app create --name
                     --resource-group
                     --service
                     [--assign-endpoint {false, true}]
                     [--assign-public-endpoint {false, true}]
                     [--backend-protocol {Default, GRPC}]
                     [--bind-acs]
                     [--bind-config-server]
                     [--bind-service-registry]
                     [--client-auth-certs]
                     [--cpu]
                     [--deployment-name]
                     [--disable-probe {false, true}]
                     [--disable-tea {false, true}]
                     [--enable-liveness-probe {false, true}]
                     [--enable-persistent-storage {false, true}]
                     [--enable-readiness-probe {false, true}]
                     [--enable-startup-probe {false, true}]
                     [--env]
                     [--grace-period]
                     [--ingress-read-timeout]
                     [--ingress-send-timeout]
                     [--instance-count]
                     [--jvm-options]
                     [--liveness-probe-config]
                     [--loaded-public-certificate-file]
                     [--max-replicas]
                     [--memory]
                     [--min-replicas]
                     [--persistent-storage]
                     [--readiness-probe-config]
                     [--runtime-version {Java_11, Java_17, Java_21, Java_8, NetCore_31}]
                     [--scale-rule-auth]
                     [--scale-rule-http-concurrency]
                     [--scale-rule-metadata]
                     [--scale-rule-name]
                     [--scale-rule-type]
                     [--secrets]
                     [--session-affinity {Cookie, None}]
                     [--session-max-age]
                     [--startup-probe-config]
                     [--system-assigned {false, true}]
                     [--user-assigned]
                     [--workload-profile]

예제

기본 구성을 사용하여 앱을 만듭니다.

az spring app create -n MyApp -s MyCluster -g MyResourceGroup

인스턴스 3개와 CPU 코어 2개, 인스턴스당 3GB 메모리를 사용하여 공용 액세스 가능 앱을 만듭니다.

az spring app create -n MyApp -s MyCluster -g MyResourceGroup --assign-endpoint true --cpu 2 --memory 3 --instance-count 3

기본 서비스 레지스트리, 애플리케이션 구성 서비스 및 Spring Cloud 구성 서버에 대한 앱 바인딩을 만듭니다.

az spring app create -n MyApp -s MyCluster -g MyResourceGroup --bind-service-registry --bind-application-configuration-service --bind-config-server

필수 매개 변수

--name -n

지정된 Azure Spring Apps 인스턴스에서 실행되는 앱의 이름입니다.

--resource-group -g

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

--service -s

Azure Spring Apps 인스턴스의 이름으로, az configure --defaults spring=를 사용하여 기본 서비스를 구성할 수 있습니다.

선택적 매개 변수

--assign-endpoint

true이면 직접 액세스를 위해 엔드포인트 URL을 할당합니다.

허용되는 값: false, true

Default value: False

--assign-public-endpoint

true이면 vnet 삽입 인스턴스 앱에 대한 가상 네트워크에서 액세스할 수 있는 엔드포인트 URL을 할당합니다.

허용되는 값: false, true

--backend-protocol

앱의 수신 백 엔드 프로토콜입니다. 기본값은 HTTP/HTTPS/WebSocket을 의미합니다.

허용되는 값: Default, GRPC

--bind-acs --bind-application-configuration-service

앱을 기본 Application Configuration Service에 자동으로 바인딩합니다.

--bind-config-server --bind-cs

자동으로 기본 구성 서버에 앱을 바인딩합니다.

--bind-service-registry --bind-sr

자동으로 기본 서비스 레지스트리에 앱을 바인딩합니다.

--client-auth-certs

클라이언트 인증을 위한 인증서의 리소스 ID를 포함하는 공백으로 구분된 문자열입니다. 예: --client_auth_certs='id0 id1'. ''를 사용하여 기존 인증서를 지웁니다.

--cpu

CPU 리소스 수량입니다. 250m, 500m, 750m, 1250m 또는 CPU 코어 수여야 합니다.

--deployment-name

기본 배포의 이름입니다.

Default value: default

--disable-probe

true이면 활동성 및 준비 상태 프로브를 사용하지 않도록 설정합니다.

허용되는 값: false, true

--disable-tea --disable-test-endpoint-auth

true이면 앱의 테스트 엔드포인트 인증을 사용하지 않도록 설정합니다.

허용되는 값: false, true

Default value: False

--enable-liveness-probe

미리 보기

false이면 앱 인스턴스의 활동성 프로브를 사용하지 않도록 설정합니다.

허용되는 값: false, true

--enable-persistent-storage --enable-ps

true이면 기본 경로를 사용하여 50G(표준 가격 책정 계층) 또는 1G(기본 가격 책정 계층) 디스크를 탑재합니다.

허용되는 값: false, true

--enable-readiness-probe

미리 보기

false이면 앱 인스턴스의 준비 프로브를 사용하지 않도록 설정합니다.

허용되는 값: false, true

--enable-startup-probe

미리 보기

false이면 앱 인스턴스의 시작 프로브를 사용하지 않도록 설정합니다.

허용되는 값: false, true

--env

'key[=value]' 형식의 공백으로 구분된 환경 변수입니다.

--grace-period --termination-grace-period-seconds

미리 보기

선택적 기간(초)은 앱 인스턴스가 정상적으로 종료되어야 합니다.

--ingress-read-timeout

수신 읽기 제한 시간 값(초)입니다. 기본값 300, 최소값은 1, 최대값은 1800입니다.

--ingress-send-timeout

수신 송신 시간 제한 값(초)입니다. 기본값 60, 최소값은 1, 최대값은 1800입니다.

--instance-count

인스턴스 수입니다.

Default value: 1

--jvm-options

jvm 옵션을 포함하는 문자열은 bash 구문 분석 오류를 방지하기 위해 '' 대신 '='를 사용합니다(예: --jvm-options='-Xms1024m -Xmx2048m').

--liveness-probe-config

미리 보기

json 파일 경로는 활동성 프로브 구성을 나타냅니다.

--loaded-public-certificate-file -f

json 파일 경로는 앱에 로드될 인증서를 나타냅니다.

--max-replicas

최대 복제본 수입니다.

Default value: 10

--memory

메모리 리소스 수량입니다. 512Mi, 1536Mi, 2560Mi, 3584Mi 또는 #Gi(예: 1Gi, 3Gi)이어야 합니다.

--min-replicas

최소 복제본 수입니다.

Default value: 1

--persistent-storage

앱에 탑재할 영구 스토리지에 대한 json 파일 경로입니다.

--readiness-probe-config

미리 보기

json 파일 경로는 준비 프로브 구성을 나타냅니다.

--runtime-version

사용된 언어의 런타임 버전입니다.

허용되는 값: Java_11, Java_17, Java_21, Java_8, NetCore_31

--scale-rule-auth --sra

크기 조정 규칙 인증 매개 변수입니다. "=" 형식을 지정하고 공백으로 구분합니다.

--scale-rule-http-concurrency --scale-rule-tcp-concurrency --srhc --srtc

스케일 아웃 전의 최대 동시 요청 수입니다. http 및 tcp 크기 조정 규칙에 대해서만 지원됩니다.

--scale-rule-metadata --srm

규칙 메타데이터 크기 조정 "key[=value]" 형식을 지정하고 공백으로 구분합니다.

--scale-rule-name --srn

크기 조정 규칙의 이름입니다.

--scale-rule-type --srt

배율 규칙의 형식입니다. 기본값: http.

--secrets

앱에 대한 비밀 목록입니다. "key[=value]" 형식을 지정하고 공백으로 구분합니다.

--session-affinity

앱의 수신 세션 선호도입니다.

허용되는 값: Cookie, None

--session-max-age

쿠키가 만료될 때까지의 시간입니다. 최소값은 1초, 최대값은 7일입니다. 0으로 설정하면 만료 기간이 브라우저 세션 기간과 같습니다.

--startup-probe-config

미리 보기

json 파일 경로는 시작 프로브 구성을 나타냅니다.

--system-assigned

시스템이 할당한 관리 ID를 사용하도록 설정합니다.

허용되는 값: false, true

--user-assigned

미리 보기

공백으로 구분된 사용자 할당 관리 ID 리소스 ID를 앱에 분석합니다.

--workload-profile

관리되는 환경에서 사용되는 워크로드 프로필입니다. 기본값은 "Consumption"입니다.

전역 매개 변수

--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 spring app delete

Azure Spring Apps에서 앱을 삭제합니다.

az spring app delete --name
                     --resource-group
                     --service

필수 매개 변수

--name -n

지정된 Azure Spring Apps 인스턴스에서 실행되는 앱의 이름입니다.

--resource-group -g

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

--service -s

Azure Spring Apps 인스턴스의 이름으로, az configure --defaults spring=를 사용하여 기본 서비스를 구성할 수 있습니다.

전역 매개 변수

--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 spring app deploy

소스 코드 또는 미리 빌드된 이진 파일을 앱에 배포하고 관련 구성을 업데이트합니다.

az spring app deploy --name
                     --resource-group
                     --service
                     [--apms]
                     [--artifact-path]
                     [--build-certificates]
                     [--build-cpu]
                     [--build-env]
                     [--build-memory]
                     [--builder]
                     [--config-file-patterns]
                     [--container-args]
                     [--container-command]
                     [--container-image]
                     [--container-registry]
                     [--custom-actuator-path]
                     [--custom-actuator-port]
                     [--deployment]
                     [--disable-app-log]
                     [--disable-probe {false, true}]
                     [--disable-validation {false, true}]
                     [--enable-liveness-probe {false, true}]
                     [--enable-readiness-probe {false, true}]
                     [--enable-startup-probe {false, true}]
                     [--env]
                     [--grace-period]
                     [--jvm-options]
                     [--language-framework]
                     [--liveness-probe-config]
                     [--main-entry]
                     [--no-wait]
                     [--readiness-probe-config]
                     [--registry-password]
                     [--registry-username]
                     [--runtime-version {Java_11, Java_17, Java_21, Java_8, NetCore_31}]
                     [--server-version]
                     [--source-path]
                     [--startup-probe-config]
                     [--target-module]
                     [--version]

예제

앱에 소스 코드를 배포합니다. 이렇게 하면 현재 디렉터리가 압축되고, Pivotal Build Service를 사용하여 이진 파일을 빌드한 다음, 앱에 배포됩니다.

az spring app deploy -n MyApp -s MyCluster -g MyResourceGroup --source-path

jvm 옵션 및 환경 변수를 사용하여 미리 빌드된 jar을 앱에 배포합니다.

az spring app deploy -n MyApp -s MyCluster -g MyResourceGroup --artifact-path app.jar --jvm-options="-XX:+UseG1GC -XX:+UseStringDeduplication" --env foo=bar

서버 버전, jvm 옵션 및 환경 변수(표준 및 기본 계층만 해당)를 사용하여 미리 빌드된 전쟁을 앱에 배포합니다.

az spring app deploy -n MyApp -s MyCluster -g MyResourceGroup --artifact-path app.war --server-version Tomcat_10 --jvm-options="-XX:+UseG1GC -XX:+UseStringDeduplication" --env foo=bar

앱의 특정 배포에 소스 코드를 배포합니다.

az spring app deploy -n MyApp -s MyCluster -g MyResourceGroup -d green-deployment --source-path

Docker 허브의 컨테이너 이미지를 앱에 배포합니다.

az spring app deploy -n MyApp -s MyCluster -g MyResourceGroup --container-image contoso/your-app:v1

프라이빗 레지스트리의 컨테이너 이미지를 앱에 배포합니다.

az spring app deploy -n MyApp -s MyCluster -g MyResourceGroup --container-image contoso/your-app:v1 --container-registry myacr.azurecr.io --registry-username <username> --registry-password <password>

Application Configuration Service 구성 파일 패턴을 사용하여 앱에 배포합니다.

az spring app deploy -n MyApp -s MyCluster -g MyResourceGroup --config-file-patterns MyPatterns --artifact-path app.jar

빌드 env를 사용하여 미리 빌드된 jar을 앱에 배포합니다(엔터프라이즈 계층에만 해당).

az spring app deploy -n MyApp -s MyCluster -g MyResourceGroup --artifact-path app.jar --build-env BP_JVM_VERSION=11.*

필수 매개 변수

--name -n

지정된 Azure Spring Apps 인스턴스에서 실행되는 앱의 이름입니다.

--resource-group -g

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

--service -s

Azure Spring Apps 인스턴스의 이름으로, az configure --defaults spring=를 사용하여 기본 서비스를 구성할 수 있습니다.

선택적 매개 변수

--apms

(엔터프라이즈 계층에만 해당) 공백으로 구분된 APM 이름입니다.

--artifact-path

지정된 미리 빌드된 아티팩트를 배포합니다(jar, war 또는 netcore zip, war는 공개 미리 보기 상태임).

--build-certificates

(엔터프라이즈 계층에만 해당) 공간으로 구분된 인증서 이름, 인증서는 빌드 시간 동안 사용됩니다.

--build-cpu

CPU 리소스 수량입니다. 500m 또는 CPU 코어 수여야 합니다.

Default value: 1

--build-env

'key[=value]' 형식의 공백으로 구분된 환경 변수입니다.

--build-memory

메모리 리소스 수량입니다. 512Mi 또는 #Gi(예: 1Gi, 3Gi)이어야 합니다.

Default value: 2Gi

--builder

(엔터프라이즈 계층에만 해당) 실행 파일을 빌드하는 데 사용되는 빌드 서비스 작성기입니다.

Default value: default

--config-file-patterns

(엔터프라이즈 계층에만 해당) 사용할 애플리케이션 구성 서비스의 패턴을 결정하기 위해 ','로 구분된 구성 파일 패턴입니다. '""를 사용하여 기존 구성을 지웁니다.

--container-args

컨테이너 이미지의 인수입니다.

--container-command

컨테이너 이미지의 명령입니다.

--container-image

컨테이너 이미지 태그입니다.

--container-registry

컨테이너 이미지의 레지스트리입니다.

Default value: docker.io

--custom-actuator-path

(엔터프라이즈 계층에만 해당) 앱에 대한 사용자 지정 액추에이터 경로입니다. 기본값은 "/actuator"입니다.

--custom-actuator-port

(엔터프라이즈 계층에만 해당) 앱에 대한 사용자 지정 액추에이터 포트입니다. 기본값은 8080입니다.

--deployment -d

앱의 기존 배포 이름입니다. 지정하지 않은 경우 프로덕션 배포의 기본값입니다.

--disable-app-log

애플리케이션을 배포할 때 애플리케이션 로그를 인쇄하지 마세요.

Default value: False

--disable-probe

true이면 활동성 및 준비 상태 프로브를 사용하지 않도록 설정합니다.

허용되는 값: false, true

--disable-validation

true이면 jar 유효성 검사를 사용하지 않도록 설정합니다.

허용되는 값: false, true

--enable-liveness-probe

미리 보기

false이면 앱 인스턴스의 활동성 프로브를 사용하지 않도록 설정합니다.

허용되는 값: false, true

--enable-readiness-probe

미리 보기

false이면 앱 인스턴스의 준비 프로브를 사용하지 않도록 설정합니다.

허용되는 값: false, true

--enable-startup-probe

미리 보기

false이면 앱 인스턴스의 시작 프로브를 사용하지 않도록 설정합니다.

허용되는 값: false, true

--env

'key[=value]' 형식의 공백으로 구분된 환경 변수입니다.

--grace-period --termination-grace-period-seconds

미리 보기

선택적 기간(초)은 앱 인스턴스가 정상적으로 종료되어야 합니다.

--jvm-options

jvm 옵션을 포함하는 문자열은 bash 구문 분석 오류를 방지하기 위해 '' 대신 '='를 사용합니다(예: --jvm-options='-Xms1024m -Xmx2048m').

--language-framework

업로드된 컨테이너 이미지의 언어 프레임워크입니다. 지원되는 값: "springboot", "".

--liveness-probe-config

미리 보기

json 파일 경로는 활동성 프로브 구성을 나타냅니다.

--main-entry -m

zip 루트를 기준으로 .NET 실행 파일의 경로를 포함하는 문자열입니다.

--no-wait

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

Default value: False

--readiness-probe-config

미리 보기

json 파일 경로는 준비 프로브 구성을 나타냅니다.

--registry-password

컨테이너 레지스트리의 암호입니다.

--registry-username

컨테이너 레지스트리의 사용자 이름입니다.

--runtime-version

사용된 언어의 런타임 버전입니다.

허용되는 값: Java_11, Java_17, Java_21, Java_8, NetCore_31

--server-version

(표준 및 기본 계층만 해당) Tomcat 서버 버전입니다. 를 실행 az spring list-support-server-versions -o table하여 지원되는 모든 서버 버전을 나열합니다. 이 기능은 공개 미리 보기로 제공됩니다.

--source-path

지정된 원본 폴더를 배포합니다. 폴더는 tar로 압축되고, 업로드되고, kpack을 사용하여 빌드됩니다. 값이 제공되지 않은 경우 기본적으로 현재 폴더로 설정됩니다.

--startup-probe-config

미리 보기

json 파일 경로는 시작 프로브 구성을 나타냅니다.

--target-module

배포할 자식 모듈로, 소스 코드에서 빌드된 여러 jar 패키지에 필요합니다.

--version

배포 버전, 설정되지 않은 경우 변경되지 않은 상태로 유지합니다.

전역 매개 변수

--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 spring app disable-remote-debugging

배포에 대한 원격 디버깅을 사용하지 않도록 설정합니다.

az spring app disable-remote-debugging --name
                                       --resource-group
                                       --service
                                       [--deployment]
                                       [--no-wait]

필수 매개 변수

--name -n

지정된 Azure Spring Apps 인스턴스에서 실행되는 앱의 이름입니다.

--resource-group -g

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

--service -s

Azure Spring Apps 인스턴스의 이름으로, az configure --defaults spring=를 사용하여 기본 서비스를 구성할 수 있습니다.

선택적 매개 변수

--deployment -d

앱의 기존 배포 이름입니다. 지정하지 않은 경우 프로덕션 배포의 기본값입니다.

--no-wait

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

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 spring app enable-remote-debugging

배포에 대해 원격 디버깅을 사용하도록 설정합니다.

az spring app enable-remote-debugging --name
                                      --resource-group
                                      --service
                                      [--deployment]
                                      [--no-wait]
                                      [--port]

필수 매개 변수

--name -n

지정된 Azure Spring Apps 인스턴스에서 실행되는 앱의 이름입니다.

--resource-group -g

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

--service -s

Azure Spring Apps 인스턴스의 이름으로, az configure --defaults spring=를 사용하여 기본 서비스를 구성할 수 있습니다.

선택적 매개 변수

--deployment -d

앱의 기존 배포 이름입니다. 지정하지 않은 경우 프로덕션 배포의 기본값입니다.

--no-wait

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

Default value: False

--port -p

원격 디버깅 포트 값은 1024에서 65536, 기본값은 5005여야 합니다.

Default value: 5005

전역 매개 변수

--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 spring app get-remote-debugging-config

배포의 원격 디버깅 구성을 가져옵니다.

az spring app get-remote-debugging-config --name
                                          --resource-group
                                          --service
                                          [--deployment]

필수 매개 변수

--name -n

지정된 Azure Spring Apps 인스턴스에서 실행되는 앱의 이름입니다.

--resource-group -g

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

--service -s

Azure Spring Apps 인스턴스의 이름으로, az configure --defaults spring=를 사용하여 기본 서비스를 구성할 수 있습니다.

선택적 매개 변수

--deployment -d

앱의 기존 배포 이름입니다. 지정하지 않은 경우 프로덕션 배포의 기본값입니다.

전역 매개 변수

--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 spring app list

Azure Spring Apps의 모든 앱을 나열합니다.

az spring app list --resource-group
                   --service

예제

모든 앱의 영구 스토리지 상태 쿼리

az spring app list -s MyCluster -g MyResourceGroup -o json --query '[].{Name:name, PersistentStorage:properties.persistentDisk}'

필수 매개 변수

--resource-group -g

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

--service -s

Azure Spring Apps 인스턴스의 이름으로, az configure --defaults spring=를 사용하여 기본 서비스를 구성할 수 있습니다.

전역 매개 변수

--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 spring app logs

앱 인스턴스의 로그를 표시하면 '-f/--follow'를 설정할 때 로그가 스트리밍됩니다.

az spring app logs --name
                   --resource-group
                   --service
                   [--deployment]
                   [--follow]
                   [--format-json]
                   [--instance]
                   [--limit]
                   [--lines]
                   [--since]

필수 매개 변수

--name -n

지정된 Azure Spring Apps 인스턴스에서 실행되는 앱의 이름입니다.

--resource-group -g

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

--service -s

Azure Spring Apps 인스턴스의 이름으로, az configure --defaults spring=를 사용하여 기본 서비스를 구성할 수 있습니다.

선택적 매개 변수

--deployment -d

앱의 기존 배포 이름입니다. 지정하지 않은 경우 프로덕션 배포의 기본값입니다.

--follow -f

로그를 스트리밍해야 하는지 지정합니다.

Default value: False

--format-json

구조적 로그를 사용하는 경우 JSON 로그의 서식을 지정합니다.

--instance -i

배포의 기존 인스턴스 이름입니다.

--limit

반환할 로그의 최대 킬로바이트입니다. 최대값은 2048입니다.

Default value: 2048

--lines

표시할 줄 수입니다. 최대값은 10000입니다.

Default value: 50

--since

5s, 2m 또는 1h와 같은 상대 기간보다 최신 로그만 반환합니다. 최대값은 1시간입니다.

전역 매개 변수

--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 spring app restart

앱 인스턴스를 다시 시작하며, 기본적으로 프로덕션 배포로 설정됩니다.

az spring app restart --name
                      --resource-group
                      --service
                      [--deployment]
                      [--no-wait]

필수 매개 변수

--name -n

지정된 Azure Spring Apps 인스턴스에서 실행되는 앱의 이름입니다.

--resource-group -g

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

--service -s

Azure Spring Apps 인스턴스의 이름으로, az configure --defaults spring=를 사용하여 기본 서비스를 구성할 수 있습니다.

선택적 매개 변수

--deployment -d

앱의 기존 배포 이름입니다. 지정하지 않은 경우 프로덕션 배포의 기본값입니다.

--no-wait

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

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 spring app scale

앱 또는 해당 배포의 크기를 수동으로 조정합니다.

az spring app scale --name
                    --resource-group
                    --service
                    [--cpu]
                    [--deployment]
                    [--instance-count]
                    [--max-replicas]
                    [--memory]
                    [--min-replicas]
                    [--no-wait]
                    [--scale-rule-auth]
                    [--scale-rule-http-concurrency]
                    [--scale-rule-metadata]
                    [--scale-rule-name]
                    [--scale-rule-type]

예제

인스턴스당 4개의 cpu 코어와 8Gb의 메모리로 앱을 확장합니다.

az spring app scale -n MyApp -s MyCluster -g MyResourceGroup --cpu 3 --memory 8

앱 배포를 5개의 인스턴스로 확장합니다.

az spring app scale -n MyApp -s MyCluster -g MyResourceGroup -d green-deployment --instance-count 5

필수 매개 변수

--name -n

지정된 Azure Spring Apps 인스턴스에서 실행되는 앱의 이름입니다.

--resource-group -g

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

--service -s

Azure Spring Apps 인스턴스의 이름으로, az configure --defaults spring=를 사용하여 기본 서비스를 구성할 수 있습니다.

선택적 매개 변수

--cpu

CPU 리소스 수량입니다. 250m, 500m, 750m, 1250m 또는 CPU 코어 수여야 합니다.

--deployment -d

앱의 기존 배포 이름입니다. 지정하지 않은 경우 프로덕션 배포의 기본값입니다.

--instance-count

인스턴스 수입니다.

--max-replicas

최대 복제본 수입니다.

Default value: 10

--memory

메모리 리소스 수량입니다. 512Mi, 1536Mi, 2560Mi, 3584Mi 또는 #Gi(예: 1Gi, 3Gi)이어야 합니다.

--min-replicas

최소 복제본 수입니다.

Default value: 1

--no-wait

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

Default value: False

--scale-rule-auth --sra

크기 조정 규칙 인증 매개 변수입니다. "=" 형식을 지정하고 공백으로 구분합니다.

--scale-rule-http-concurrency --scale-rule-tcp-concurrency --srhc --srtc

스케일 아웃 전의 최대 동시 요청 수입니다. http 및 tcp 크기 조정 규칙에 대해서만 지원됩니다.

--scale-rule-metadata --srm

규칙 메타데이터 크기 조정 "key[=value]" 형식을 지정하고 공백으로 구분합니다.

--scale-rule-name --srn

크기 조정 규칙의 이름입니다.

--scale-rule-type --srt

배율 규칙의 형식입니다. 기본값: http.

전역 매개 변수

--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 spring app set-deployment

앱의 프로덕션 배포를 설정합니다.

az spring app set-deployment --deployment
                             --name
                             --resource-group
                             --service
                             [--no-wait]

예제

앱의 스테이징 배포를 프로덕션으로 교환합니다.

az spring app set-deployment -d green-deployment -n MyApp -s MyCluster -g MyResourceGroup

필수 매개 변수

--deployment -d

앱의 기존 배포 이름입니다.

--name -n

지정된 Azure Spring Apps 인스턴스에서 실행되는 앱의 이름입니다.

--resource-group -g

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

--service -s

Azure Spring Apps 인스턴스의 이름으로, az configure --defaults spring=를 사용하여 기본 서비스를 구성할 수 있습니다.

선택적 매개 변수

--no-wait

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

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 spring app show

Azure Spring Apps에서 앱의 세부 정보를 표시합니다.

az spring app show --name
                   --resource-group
                   --service

필수 매개 변수

--name -n

지정된 Azure Spring Apps 인스턴스에서 실행되는 앱의 이름입니다.

--resource-group -g

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

--service -s

Azure Spring Apps 인스턴스의 이름으로, az configure --defaults spring=를 사용하여 기본 서비스를 구성할 수 있습니다.

전역 매개 변수

--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 spring app show-deploy-log

마지막 배포의 빌드 로그를 표시하고 소스 코드 배포에만 적용되며, 기본적으로 프로덕션 배포에 적용됩니다.

az spring app show-deploy-log --name
                              --resource-group
                              --service
                              [--deployment]

필수 매개 변수

--name -n

지정된 Azure Spring Apps 인스턴스에서 실행되는 앱의 이름입니다.

--resource-group -g

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

--service -s

Azure Spring Apps 인스턴스의 이름으로, az configure --defaults spring=를 사용하여 기본 서비스를 구성할 수 있습니다.

선택적 매개 변수

--deployment -d

앱의 기존 배포 이름입니다. 지정하지 않은 경우 프로덕션 배포의 기본값입니다.

전역 매개 변수

--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 spring app start

앱의 인스턴스를 시작하며, 기본적으로 프로덕션 배포로 설정됩니다.

az spring app start --name
                    --resource-group
                    --service
                    [--deployment]
                    [--no-wait]

필수 매개 변수

--name -n

지정된 Azure Spring Apps 인스턴스에서 실행되는 앱의 이름입니다.

--resource-group -g

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

--service -s

Azure Spring Apps 인스턴스의 이름으로, az configure --defaults spring=를 사용하여 기본 서비스를 구성할 수 있습니다.

선택적 매개 변수

--deployment -d

앱의 기존 배포 이름입니다. 지정하지 않은 경우 프로덕션 배포의 기본값입니다.

--no-wait

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

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 spring app stop

앱 인스턴스를 중지하고, 기본적으로 프로덕션 배포를 중지합니다.

az spring app stop --name
                   --resource-group
                   --service
                   [--deployment]
                   [--no-wait]

필수 매개 변수

--name -n

지정된 Azure Spring Apps 인스턴스에서 실행되는 앱의 이름입니다.

--resource-group -g

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

--service -s

Azure Spring Apps 인스턴스의 이름으로, az configure --defaults spring=를 사용하여 기본 서비스를 구성할 수 있습니다.

선택적 매개 변수

--deployment -d

앱의 기존 배포 이름입니다. 지정하지 않은 경우 프로덕션 배포의 기본값입니다.

--no-wait

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

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 spring app unset-deployment

앱의 설정되지 않은 프로덕션 배포입니다.

az spring app unset-deployment --name
                               --resource-group
                               --service
                               [--no-wait]

예제

앱에 프로덕션 배포가 있는 경우 앱의 프로덕션 배포를 스테이징으로 교환합니다.

az spring app unset-deployment -n MyApp -s MyCluster -g MyResourceGroup

필수 매개 변수

--name -n

지정된 Azure Spring Apps 인스턴스에서 실행되는 앱의 이름입니다.

--resource-group -g

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

--service -s

Azure Spring Apps 인스턴스의 이름으로, az configure --defaults spring=를 사용하여 기본 서비스를 구성할 수 있습니다.

선택적 매개 변수

--no-wait

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

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 spring app update

앱의 구성을 업데이트합니다.

az spring app update --name
                     --resource-group
                     --service
                     [--assign-endpoint {false, true}]
                     [--assign-public-endpoint {false, true}]
                     [--backend-protocol {Default, GRPC}]
                     [--client-auth-certs]
                     [--config-file-patterns]
                     [--custom-actuator-path]
                     [--custom-actuator-port]
                     [--deployment]
                     [--disable-probe {false, true}]
                     [--disable-tea {false, true}]
                     [--enable-ingress-to-app-tls {false, true}]
                     [--enable-liveness-probe {false, true}]
                     [--enable-persistent-storage {false, true}]
                     [--enable-readiness-probe {false, true}]
                     [--enable-startup-probe {false, true}]
                     [--env]
                     [--grace-period]
                     [--https-only {false, true}]
                     [--ingress-read-timeout]
                     [--ingress-send-timeout]
                     [--jvm-options]
                     [--liveness-probe-config]
                     [--loaded-public-certificate-file]
                     [--main-entry]
                     [--no-wait]
                     [--persistent-storage]
                     [--readiness-probe-config]
                     [--runtime-version {Java_11, Java_17, Java_21, Java_8, NetCore_31}]
                     [--secrets]
                     [--session-affinity {Cookie, None}]
                     [--session-max-age]
                     [--startup-probe-config]
                     [--workload-profile]

예제

앱에 대한 환경 변수를 추가합니다.

az spring app update -n MyApp -s MyCluster -g MyResourceGroup --env foo=bar

필수 매개 변수

--name -n

지정된 Azure Spring Apps 인스턴스에서 실행되는 앱의 이름입니다.

--resource-group -g

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

--service -s

Azure Spring Apps 인스턴스의 이름으로, az configure --defaults spring=를 사용하여 기본 서비스를 구성할 수 있습니다.

선택적 매개 변수

--assign-endpoint

true이면 직접 액세스를 위해 엔드포인트 URL을 할당합니다.

허용되는 값: false, true

--assign-public-endpoint

true이면 vnet 삽입 인스턴스 앱에 대한 가상 네트워크에서 액세스할 수 있는 엔드포인트 URL을 할당합니다.

허용되는 값: false, true

--backend-protocol

앱의 수신 백 엔드 프로토콜입니다. 기본값은 HTTP/HTTPS/WebSocket을 의미합니다.

허용되는 값: Default, GRPC

--client-auth-certs

클라이언트 인증을 위한 인증서의 리소스 ID를 포함하는 공백으로 구분된 문자열입니다. 예: --client_auth_certs='id0 id1'. ''를 사용하여 기존 인증서를 지웁니다.

--config-file-patterns

(엔터프라이즈 계층에만 해당) 사용할 애플리케이션 구성 서비스의 패턴을 결정하기 위해 ','로 구분된 구성 파일 패턴입니다. '""를 사용하여 기존 구성을 지웁니다.

--custom-actuator-path

(엔터프라이즈 계층에만 해당) 앱에 대한 사용자 지정 액추에이터 경로입니다. 기본값은 "/actuator"입니다.

--custom-actuator-port

(엔터프라이즈 계층에만 해당) 앱에 대한 사용자 지정 액추에이터 포트입니다. 기본값은 8080입니다.

--deployment -d

앱의 기존 배포 이름입니다. 지정하지 않은 경우 프로덕션 배포의 기본값입니다.

--disable-probe

true이면 활동성 및 준비 상태 프로브를 사용하지 않도록 설정합니다.

허용되는 값: false, true

--disable-tea --disable-test-endpoint-auth

true이면 앱의 테스트 엔드포인트 인증을 사용하지 않도록 설정합니다.

허용되는 값: false, true

--enable-ingress-to-app-tls

true이면 앱 tls에 대한 수신을 사용하도록 설정합니다.

허용되는 값: false, true

--enable-liveness-probe

미리 보기

false이면 앱 인스턴스의 활동성 프로브를 사용하지 않도록 설정합니다.

허용되는 값: false, true

--enable-persistent-storage --enable-ps

true이면 기본 경로를 사용하여 50G(표준 가격 책정 계층) 또는 1G(기본 가격 책정 계층) 디스크를 탑재합니다.

허용되는 값: false, true

--enable-readiness-probe

미리 보기

false이면 앱 인스턴스의 준비 프로브를 사용하지 않도록 설정합니다.

허용되는 값: false, true

--enable-startup-probe

미리 보기

false이면 앱 인스턴스의 시작 프로브를 사용하지 않도록 설정합니다.

허용되는 값: false, true

--env

'key[=value]' 형식의 공백으로 구분된 환경 변수입니다.

--grace-period --termination-grace-period-seconds

미리 보기

선택적 기간(초)은 앱 인스턴스가 정상적으로 종료되어야 합니다.

--https-only

true이면 https를 통해 앱에 액세스합니다.

허용되는 값: false, true

--ingress-read-timeout

수신 읽기 제한 시간 값(초)입니다. 기본값 300, 최소값은 1, 최대값은 1800입니다.

--ingress-send-timeout

수신 송신 시간 제한 값(초)입니다. 기본값 60, 최소값은 1, 최대값은 1800입니다.

--jvm-options

jvm 옵션을 포함하는 문자열은 bash 구문 분석 오류를 방지하기 위해 '' 대신 '='를 사용합니다(예: --jvm-options='-Xms1024m -Xmx2048m').

--liveness-probe-config

미리 보기

json 파일 경로는 활동성 프로브 구성을 나타냅니다.

--loaded-public-certificate-file -f

json 파일 경로는 앱에 로드될 인증서를 나타냅니다.

--main-entry -m

zip 루트를 기준으로 하는 .NET 실행 파일의 경로입니다.

--no-wait

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

Default value: False

--persistent-storage

앱에 탑재할 영구 스토리지에 대한 json 파일 경로입니다.

--readiness-probe-config

미리 보기

json 파일 경로는 준비 프로브 구성을 나타냅니다.

--runtime-version

사용된 언어의 런타임 버전입니다.

허용되는 값: Java_11, Java_17, Java_21, Java_8, NetCore_31

--secrets

앱에 대한 비밀 목록입니다. "key[=value]" 형식을 지정하고 공백으로 구분합니다.

--session-affinity

앱의 수신 세션 선호도입니다.

허용되는 값: Cookie, None

--session-max-age

쿠키가 만료될 때까지의 시간입니다. 최소값은 1초, 최대값은 7일입니다. 0으로 설정하면 만료 기간이 브라우저 세션 기간과 같습니다.

--startup-probe-config

미리 보기

json 파일 경로는 시작 프로브 구성을 나타냅니다.

--workload-profile

관리되는 환경에서 사용되는 워크로드 프로필입니다. 기본값은 "Consumption"입니다.

전역 매개 변수

--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를 사용합니다.