다음을 통해 공유

az sf application

Azure Service Fabric 클러스터에서 실행되는 애플리케이션을 관리합니다. ARM 배포 애플리케이션만 지원합니다.

명령

Name Description 형식 상태
az sf application certificate

애플리케이션의 인증서를 관리합니다.

 Core GA
az sf application certificate add

호스트된 애플리케이션에서 사용할 클러스터를 구성하는 Virtual Machine Scale Sets에 새 인증서를 추가합니다.

 Core GA
az sf application create

Azure Service Fabric 클러스터에서 새 애플리케이션을 만듭니다.

 Core GA
az sf application delete

애플리케이션을 삭제합니다.

 Core GA
az sf application list

지정된 클러스터의 애플리케이션을 나열합니다.

 Core GA
az sf application show

Azure Service Fabric 클러스터에서 애플리케이션의 속성을 표시합니다.

 Core GA
az sf application update

Azure Service Fabric 애플리케이션을 업데이트합니다. 이렇게 하면 애플리케이션 매개 변수를 업데이트하거나 애플리케이션 업그레이드를 트리거하는 애플리케이션 유형 버전을 업그레이드할 수 있습니다.

 Core GA

az sf application create

Azure Service Fabric 클러스터에서 새 애플리케이션을 만듭니다.

az sf application create --application-name --name
                         --application-type-name --type-name
                         --application-type-version --version
                         --cluster-name
                         --resource-group
                         [--application-parameters --parameters]
                         [--max-nodes --maximum-nodes]
                         [--min-nodes --minimum-nodes]
                         [--package-url]

예제

매개 변수를 사용하여 애플리케이션 "testApp"을 만듭니다. 애플리케이션 유형 "TestAppType" 버전 "v1"이 클러스터에 이미 있어야 하며 애플리케이션 매개 변수는 애플리케이션 매니페스트에 정의되어야 합니다.

az sf application create -g testRG -c testCluster --application-name testApp --application-type-name TestAppType \
  --application-type-version v1 --application-parameters key0=value0

제공된 패키지 URL을 사용하여 애플리케이션 "testApp" 및 앱 유형 버전을 만듭니다.

az sf application create -g testRG -c testCluster --application-name testApp --application-type-name TestAppType \
  --application-type-version v1 --package-url "https://sftestapp.blob.core.windows.net/sftestapp/testApp_1.0.sfpkg" \
    --application-parameters key0=value0

필수 매개 변수

--application-name --name

애플리케이션 이름을 지정합니다.

--application-type-name --type-name

애플리케이션 유형 이름을 지정합니다.

--application-type-version --version

애플리케이션 유형 버전을 지정합니다.

--cluster-name -c

클러스터 이름을 지정합니다. 지정하지 않으면 리소스 그룹 이름과 동일합니다.

--resource-group -g

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

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--application-parameters --parameters

애플리케이션 매개 변수를 키/값 쌍으로 지정합니다. 이러한 매개 변수는 애플리케이션 매니페스트에 있어야 합니다. 예: --application-parameters param1=value1 param2=value2.

--max-nodes --maximum-nodes

애플리케이션을 배치할 최대 노드 수를 지정합니다. 이 매개 변수의 값은 음수가 아닌 정수여야 합니다. 기본값은 0으로, 클러스터의 노드 수에 애플리케이션을 배치할 수 있음을 나타냅니다.

--min-nodes --minimum-nodes

Service Fabric이 이 애플리케이션에 대한 용량을 예약하는 노드의 최소 수를 지정합니다. 그렇다고 해서 애플리케이션이 모든 노드에 복제본을 보유하도록 보장되는 것은 아닙니다. 이 매개 변수의 값은 음수가 아닌 정수여야 합니다. 기본값은 0입니다. 즉, 애플리케이션에 예약된 용량이 없습니다.

--package-url

애플리케이션 패키지 sfpkg 파일의 URL을 지정합니다.

전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성 값
Default value: False
--help -h

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

--only-show-errors

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

속성 값
Default value: False
--output -o

출력 형식

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

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

--subscription

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False

az sf application delete

애플리케이션을 삭제합니다.

az sf application delete --application-name --name
                         --cluster-name
                         --resource-group

예제

애플리케이션을 삭제합니다.

az sf application delete -g testRG -c testCluster --application-name testApp

필수 매개 변수

--application-name --name

애플리케이션 이름을 지정합니다.

--cluster-name -c

클러스터 이름을 지정합니다. 지정하지 않으면 리소스 그룹 이름과 동일합니다.

--resource-group -g

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

전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성 값
Default value: False
--help -h

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

--only-show-errors

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

속성 값
Default value: False
--output -o

출력 형식

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

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

--subscription

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False

az sf application list

지정된 클러스터의 애플리케이션을 나열합니다.

az sf application list --cluster-name
                       --resource-group

예제

지정된 클러스터에 대한 애플리케이션을 나열합니다.

az sf application list -g testRG -c testCluster

필수 매개 변수

--cluster-name -c

클러스터 이름을 지정합니다. 지정하지 않으면 리소스 그룹 이름과 동일합니다.

--resource-group -g

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

전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성 값
Default value: False
--help -h

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

--only-show-errors

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

속성 값
Default value: False
--output -o

출력 형식

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

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

--subscription

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False

az sf application show

Azure Service Fabric 클러스터에서 애플리케이션의 속성을 표시합니다.

az sf application show --application-name --name
                       --cluster-name
                       --resource-group

예제

애플리케이션을 가져옵니다.

az sf application show -g testRG -c testCluster --application-name testApp

필수 매개 변수

--application-name --name

애플리케이션 이름을 지정합니다.

--cluster-name -c

클러스터 이름을 지정합니다. 지정하지 않으면 리소스 그룹 이름과 동일합니다.

--resource-group -g

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

전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성 값
Default value: False
--help -h

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

--only-show-errors

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

속성 값
Default value: False
--output -o

출력 형식

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

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

--subscription

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False

az sf application update

Azure Service Fabric 애플리케이션을 업데이트합니다. 이렇게 하면 애플리케이션 매개 변수를 업데이트하거나 애플리케이션 업그레이드를 트리거하는 애플리케이션 유형 버전을 업그레이드할 수 있습니다.

az sf application update --application-name --name
                         --cluster-name
                         --resource-group
                         [--application-parameters --parameters]
                         [--application-type-version --version]
                         [--consider-warning-as-error --warning-as-error {false, true}]
                         [--failure-action {Manual, Rollback}]
                         [--force-restart {false, true}]
                         [--hc-retry-timeout --health-check-retry-timeout]
                         [--hc-stable-duration --health-check-stable-duration]
                         [--hc-wait-duration --health-check-wait-duration]
                         [--max-nodes --maximum-nodes]
                         [--max-unhealthy-apps]
                         [--max-unhealthy-parts]
                         [--max-unhealthy-reps]
                         [--max-unhealthy-servs]
                         [--min-nodes --minimum-nodes]
                         [--rep-check-timeout --replica-check-timeout]
                         [--service-type-health-policy-map]
                         [--ud-timeout --upgrade-domain-timeout]
                         [--upgrade-timeout]

예제

애플리케이션 매개 변수를 업데이트하고 정책 값 및 앱 유형 버전을 v2로 업그레이드합니다.

az sf application update -g testRG -c testCluster --application-name testApp --application-type-version v2 \
  --application-parameters key0=value0 --health-check-stable-duration 0 --health-check-wait-duration 0 --health-check-retry-timeout 0 \
    --upgrade-domain-timeout 5000 --upgrade-timeout 7000 --failure-action Rollback --replica-check-timeout 300 --force-restart

애플리케이션 최소 및 최대 노드를 업데이트합니다.

az sf application update -g testRG -c testCluster --application-name testApp --minimum-nodes 1 --maximum-nodes 3

필수 매개 변수

--application-name --name

애플리케이션 이름을 지정합니다.

--cluster-name -c

클러스터 이름을 지정합니다. 지정하지 않으면 리소스 그룹 이름과 동일합니다.

--resource-group -g

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

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--application-parameters --parameters

애플리케이션 매개 변수를 키/값 쌍으로 지정합니다. 이러한 매개 변수는 애플리케이션 매니페스트에 있어야 합니다. 예: --application-parameters param1=value1 param2=value2.

--application-type-version --version

애플리케이션 유형 버전을 지정합니다.

--consider-warning-as-error --warning-as-error

상태 평가 중에 경고 상태 이벤트를 오류 이벤트로 처리할지 여부를 나타냅니다.

속성 값
매개 변수 그룹: Upgrade description Arguments
Default value: False
허용되는 값: false, true
--failure-action

모니터링되는 업그레이드가 실패할 경우 수행할 작업을 지정합니다. 이 매개 변수에 허용되는 값은 Rollback 또는 Manual입니다.

속성 값
매개 변수 그룹: Upgrade description Arguments
허용되는 값: Manual, Rollback
--force-restart

업그레이드가 구성 전용 변경인 경우에도 서비스 호스트가 다시 시작되었음을 나타냅니다.

속성 값
Default value: False
허용되는 값: false, true
--hc-retry-timeout --health-check-retry-timeout

이전 상태 검사가 실패하면 Service Fabric이 상태 검사를 다시 시도한 기간(초)을 지정합니다.

속성 값
매개 변수 그룹: Upgrade description Arguments
--hc-stable-duration --health-check-stable-duration

다음 업그레이드 도메인으로 이동하거나 업그레이드를 완료하기 전에 애플리케이션이 안정적인지 확인하기 위해 Service Fabric이 대기하는 기간(초)을 지정합니다. 이 대기 기간은 상태 검사가 수행된 직후에 감지되지 않은 상태 변경을 방지합니다.

속성 값
매개 변수 그룹: Upgrade description Arguments
--hc-wait-duration --health-check-wait-duration

Service Fabric이 업그레이드 도메인에서 업그레이드를 완료한 후 초기 상태 검사를 수행하기 전에 대기하는 기간(초)을 지정합니다.

속성 값
매개 변수 그룹: Upgrade description Arguments
--max-nodes --maximum-nodes

애플리케이션을 배치할 최대 노드 수를 지정합니다. 이 매개 변수의 값은 음수가 아닌 정수여야 합니다. 기본값은 0으로, 클러스터의 노드 수에 애플리케이션을 배치할 수 있음을 나타냅니다.

--max-unhealthy-apps

클러스터의 애플리케이션 상태가 오류로 표시되기 전에 상태 오류가 있는 클러스터의 노드에 배포된 애플리케이션 인스턴스의 최대 비율을 지정합니다. 허용되는 값은 0에서 100까지입니다.

속성 값
매개 변수 그룹: Upgrade description Arguments
--max-unhealthy-parts

모니터링되는 업그레이드에 사용할 기본 서비스 유형에 대한 상태 정책에서 허용하는 서비스당 비정상 파티션의 최대 비율을 지정합니다. 허용되는 값은 0에서 100까지입니다.

속성 값
매개 변수 그룹: Upgrade description Arguments
--max-unhealthy-reps

모니터링되는 업그레이드에 사용할 기본 서비스 유형에 대한 상태 정책에서 허용하는 서비스당 비정상 복제본의 최대 비율을 지정합니다. 허용되는 값은 0에서 100까지입니다.

속성 값
매개 변수 그룹: Upgrade description Arguments
--max-unhealthy-servs

모니터링되는 업그레이드에 사용할 기본 서비스 유형에 대해 상태 정책에서 허용하는 비정상 서비스의 최대 비율을 지정합니다. 허용되는 값은 0에서 100까지의 형식입니다.

속성 값
매개 변수 그룹: Upgrade description Arguments
--min-nodes --minimum-nodes

Service Fabric이 이 애플리케이션에 대한 용량을 예약하는 노드의 최소 수를 지정합니다. 그렇다고 해서 애플리케이션이 모든 노드에 복제본을 보유하도록 보장되는 것은 아닙니다. 이 매개 변수의 값은 음수가 아닌 정수여야 합니다. 기본값은 0입니다. 즉, 애플리케이션에 예약된 용량이 없습니다.

--rep-check-timeout --replica-check-timeout

Service Fabric이 업그레이드를 진행하기 전에 서비스 패브릭이 안전한 상태로 다시 구성되기를 기다리는 최대 시간(초)을 지정합니다.

속성 값
매개 변수 그룹: Upgrade description Arguments
--service-type-health-policy-map

다양한 서비스 유형에 사용할 상태 정책의 맵을 해시 테이블로 지정합니다. {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"}. 예: @{ "ServiceTypeName01" = "5,10,5"; "ServiceTypeName02" = "5,5,5" }.

--ud-timeout --upgrade-domain-timeout

Service Fabric이 단일 업그레이드 도메인을 업그레이드하는 데 걸리는 최대 시간(초)을 지정합니다. 이 기간이 지나면 업그레이드가 실패합니다.

속성 값
매개 변수 그룹: Upgrade description Arguments
--upgrade-timeout

Service Fabric이 전체 업그레이드에 걸리는 최대 시간(초)을 지정합니다. 이 기간이 지나면 업그레이드가 실패합니다.

속성 값
매개 변수 그룹: Upgrade description Arguments
전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성 값
Default value: False
--help -h

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

--only-show-errors

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

속성 값
Default value: False
--output -o

출력 형식

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

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

--subscription

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False