次の方法で共有

az sf managed-application

  • リファレンス

Azure Service Fabric マネージド クラスターで実行されているアプリケーションを管理します。 ARM でデプロイされたアプリケーションのみをサポートします。

コマンド

名前 説明 型 Status
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

監視対象のアップグレードに使用する既定のサービスの種類に対して、正常性ポリシーによって許可されるサービスあたりの不十分なレプリカの最大割合を指定します。 使用できる値は 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 Fabric がサービスを安全な状態に再構成するのを待機する最大時間 (秒単位) を指定します。その後、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 が 1 回のアップグレードに要する最大時間 (秒単位) を指定メイン。 この期間が経過すると、アップグレードは失敗します。

--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 を使います。