Share via

az sf managed-application

  • 참조

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

명령

Name Description 형식 상태
az sf managed-application create

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

 핵심 GA
az sf managed-application delete

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

 핵심 GA
az sf managed-application list

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

 핵심 GA
az sf managed-application show

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

 핵심 GA
az sf managed-application update

Azure Service Fabric 관리형 애플리케이션을 업데이트합니다.

 핵심 GA

az sf managed-application create

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

az sf managed-application create --application-name
                                 --application-type-name
                                 --application-type-version
                                 --cluster-name
                                 --resource-group
                                 [--application-parameters]
                                 [--package-url]
                                 [--tags]

예제

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

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

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

az sf managed-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.

--package-url

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

--tags

공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.

전역 매개 변수
--debug

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

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

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

az sf managed-application delete

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

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

예제

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

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

필수 매개 변수

--application-name --name

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

--cluster-name -c

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

--resource-group -g

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

전역 매개 변수
--debug

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

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

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

az sf managed-application list

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

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

예제

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

az sf managed-application list -g testRG -c testCluster

필수 매개 변수

--cluster-name -c

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

--resource-group -g

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

전역 매개 변수
--debug

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

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

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

az sf managed-application show

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

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

예제

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

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

필수 매개 변수

--application-name --name

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

--cluster-name -c

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

--resource-group -g

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

전역 매개 변수
--debug

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

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

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

az sf managed-application update

Azure Service Fabric 관리형 애플리케이션을 업데이트합니다.

이렇게 하면 태그, 애플리케이션 매개 변수, 값이 애플리케이션 UpgradePolicy 및/또는 애플리케이션 업그레이드를 트리거하는 애플리케이션 유형 버전을 업그레이드할 수 있습니다.

az sf managed-application update --application-name
                                 --cluster-name
                                 --resource-group
                                 [--application-parameters]
                                 [--application-type-version]
                                 [--close-duration]
                                 [--consider-warning-as-error {false, true}]
                                 [--failure-action {Manual, Rollback}]
                                 [--force-restart {false, true}]
                                 [--hc-retry-timeout]
                                 [--hc-stable-duration]
                                 [--hc-wait-duration]
                                 [--max-percent-unhealthy-apps]
                                 [--max-percent-unhealthy-partitions]
                                 [--max-percent-unhealthy-replicas]
                                 [--max-percent-unhealthy-services]
                                 [--recreate-application {false, true}]
                                 [--rep-check-timeout]
                                 [--service-type-health-policy-map]
                                 [--tags]
                                 [--ud-timeout]
                                 [--upgrade-mode {Monitored, UnmonitoredAuto}]
                                 [--upgrade-timeout]

예제

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

az sf managed-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 --upgrade-replica-set-check-timeout 300 --force-restart

관리되는 애플리케이션 서비스 유형 상태 정책 맵을 업데이트합니다.

az sf managed-application update -g testRG -c testCluster --application-name testApp --service-type-health-policy-map  "ServiceTypeName01"="5,10,5" "ServiceTypeName02"="5,5,5"

필수 매개 변수

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

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

--close-duration --instance-close-delay-duration --instance-close-duration

활성 요청이 정상적으로 드레이닝되도록 상태를 사용하지 않는 인스턴스가 닫히기 전에 대기할 기간을 초 단위로 지정합니다. 이는 애플리케이션/클러스터 업그레이드 중에 인스턴스가 닫히는 경우, 서비스 설명에 0이 아닌 지연 기간이 구성된 인스턴스에 대해서만 적용됩니다.

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

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

허용되는 값: false, true
기본값: False
--failure-action

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

허용되는 값: Manual, Rollback
--force-restart

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

허용되는 값: false, true
기본값: False
--hc-retry-timeout --health-check-retry-timeout

이전 상태 검사 실패할 경우 Service Fabric이 상태 검사 다시 시도한 기간(초)을 지정합니다.

--hc-stable-duration --health-check-stable-duration

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

--hc-wait-duration --health-check-wait-duration

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

--max-percent-unhealthy-apps --max-percent-unhealthy-deployed-applications --max-unhealthy-apps

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

--max-percent-unhealthy-partitions --max-unhealthy-parts

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

--max-percent-unhealthy-replicas --max-unhealthy-reps

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

--max-percent-unhealthy-services --max-unhealthy-servs

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

--recreate-application

업데이트할 때 애플리케이션을 다시 만들어야 하는지 여부를 결정합니다. value=true이면 나머지 업그레이드 정책 매개 변수는 허용되지 않습니다.

허용되는 값: false, true
기본값: False
--rep-check-timeout --replica-check-timeout --upgrade-replica-set-check-timeout

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

--service-type-health-policy-map --service-type-policy

다양한 서비스 유형에 사용할 상태 정책의 맵을 "ServiceTypeName"="MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices" 형식으로 키/값 쌍으로 지정합니다. 예: --service-type-health-policy-map "ServiceTypeName01"="5,10,5" "ServiceTypeName02"="5,5,5".

--tags

공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.

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

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

--upgrade-mode

롤링 업그레이드 중에 상태를 모니터링하는 데 사용되는 모드를 지정합니다. 값은 Monitored 및 UnmonitoredAuto입니다.

허용되는 값: Monitored, UnmonitoredAuto
--upgrade-timeout

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

전역 매개 변수
--debug

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

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

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