az spring app deployment

메모

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

Azure Spring Apps에서 앱 배포의 수명 주기를 관리하는 명령입니다. --deployment 매개 변수를 사용하여 앱 수준에서 배포에 대한 추가 작업을 수행할 수 있습니다. 예: az spring app deploy --deployment <staging deployment>.

명령

Name	Description	형식	상태
az spring app deployment create	앱에 대한 스테이징 배포를 만듭니다. 기존 배포에 코드 또는 업데이트 설정을 배포하려면 az spring app deploy/update --deployment <staging deployment>사용합니다.	확장	조지아
az spring app deployment delete	앱 배포를 삭제합니다.	확장	조지아
az spring app deployment generate-heap-dump	지정된 파일 경로에 대한 대상 앱 인스턴스의 힙 덤프를 생성합니다.	확장	조지아
az spring app deployment generate-thread-dump	지정된 파일 경로에 대한 대상 앱 인스턴스의 스레드 덤프를 생성합니다.	확장	조지아
az spring app deployment list	앱의 모든 배포를 나열합니다.	확장	조지아
az spring app deployment show	배포의 세부 정보를 표시합니다.	확장	조지아
az spring app deployment start-jfr	지정된 파일 경로에 대한 대상 앱 인스턴스에서 JFR을 시작합니다.	확장	조지아

az spring app deployment create

앱에 대한 스테이징 배포를 만듭니다. 기존 배포에 코드 또는 업데이트 설정을 배포하려면 az spring app deploy/update --deployment <staging deployment>사용합니다.

az spring app deployment create --app
                                --name
                                --resource-group
                                --service
                                [--apms]
                                [--artifact-path]
                                [--build-certificates]
                                [--build-env]
                                [--builder]
                                [--config-file-patterns]
                                [--container-args]
                                [--container-command]
                                [--container-image]
                                [--container-registry]
                                [--cpu]
                                [--custom-actuator-path]
                                [--custom-actuator-port]
                                [--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]
                                [--instance-count]
                                [--jvm-options]
                                [--language-framework]
                                [--liveness-probe-config]
                                [--main-entry]
                                [--max-replicas]
                                [--memory]
                                [--min-replicas]
                                [--no-wait]
                                [--readiness-probe-config]
                                [--registry-password]
                                [--registry-username]
                                [--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]
                                [--server-version]
                                [--skip-clone-settings]
                                [--source-path]
                                [--startup-probe-config]
                                [--target-module]
                                [--version]

예제

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

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

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

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

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

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

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

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

필수 매개 변수

--app

앱의 이름입니다.

--name -n

배포의 이름입니다.

--resource-group -g

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

--service -s

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

선택적 매개 변수

--apms

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

--artifact-path

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

--build-certificates

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

--build-env

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

--builder

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

Default value: default

--config-file-patterns

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

--container-args

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

--container-command

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

--container-image

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

--container-registry

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

Default value: docker.io

--cpu

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

--custom-actuator-path

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

--custom-actuator-port

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

--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

미리 보기

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

--instance-count

인스턴스 수입니다.

--jvm-options

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

--language-framework

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

--liveness-probe-config

미리 보기

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

--main-entry -m

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

--max-replicas

최대 복제본 수입니다.

Default value: 10

--memory

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

--min-replicas

최소 복제본 수입니다.

Default value: 1

--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

--scale-rule-auth --sra

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

--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.

--server-version

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

--skip-clone-settings

스테이징 배포를 만들면 프로덕션 배포에서 설정이 자동으로 복사됩니다.

Default value: False

--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 deployment delete

앱 배포를 삭제합니다.

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

필수 매개 변수

--app

앱의 이름입니다.

--name -n

배포의 이름입니다.

--resource-group -g

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

--service -s

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

선택적 매개 변수

--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 deployment generate-heap-dump

지정된 파일 경로에 대한 대상 앱 인스턴스의 힙 덤프를 생성합니다.

az spring app deployment generate-heap-dump --app
                                            --app-instance
                                            --file-path
                                            --resource-group
                                            --service
                                            [--deployment]

필수 매개 변수

--app

앱의 이름입니다.

--app-instance

덤프하려는 대상 앱 인스턴스입니다.

--file-path

덤프 파일의 탑재 파일 경로입니다.

--resource-group -g

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

--service -s

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

선택적 매개 변수

--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 deployment generate-thread-dump

지정된 파일 경로에 대한 대상 앱 인스턴스의 스레드 덤프를 생성합니다.

az spring app deployment generate-thread-dump --app
                                              --app-instance
                                              --file-path
                                              --resource-group
                                              --service
                                              [--deployment]

필수 매개 변수

--app

앱의 이름입니다.

--app-instance

덤프하려는 대상 앱 인스턴스입니다.

--file-path

덤프 파일의 탑재 파일 경로입니다.

--resource-group -g

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

--service -s

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

선택적 매개 변수

--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 deployment list

앱의 모든 배포를 나열합니다.

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

필수 매개 변수

--app

앱의 이름입니다.

--resource-group -g

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

--service -s

Azure Spring Apps 인스턴스의 이름으로, az configure --defaults spring=<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 spring app deployment show

배포의 세부 정보를 표시합니다.

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

필수 매개 변수

--app

앱의 이름입니다.

--name -n

배포의 이름입니다.

--resource-group -g

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

--service -s

Azure Spring Apps 인스턴스의 이름으로, az configure --defaults spring=<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 spring app deployment start-jfr

지정된 파일 경로에 대한 대상 앱 인스턴스에서 JFR을 시작합니다.

az spring app deployment start-jfr --app
                                   --app-instance
                                   --file-path
                                   --resource-group
                                   --service
                                   [--deployment]
                                   [--duration]

필수 매개 변수

--app

앱의 이름입니다.

--app-instance

덤프하려는 대상 앱 인스턴스입니다.

--file-path

덤프 파일의 탑재 파일 경로입니다.

--resource-group -g

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

--service -s

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

선택적 매개 변수

--deployment -d

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

--duration

JFR의 기간입니다.

Default value: 60s

전역 매개 변수

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