az sf application

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

コマンド

名前	説明	型	Status
az sf application certificate	アプリケーションの証明書を管理します。	コア	GA
az sf application certificate add	ホストされているアプリケーションで使用するクラスターを構成する新しい証明書を仮想マシン スケール セットに追加します。	コア	GA
az sf application create	Azure Service Fabric クラスターに新しいアプリケーションを作成します。	コア	GA
az sf application delete	アプリケーションを削除します。	コア	GA
az sf application list	特定のクラスターのアプリケーションを一覧表示します。	コア	GA
az sf application show	Azure Service Fabric クラスター上のアプリケーションのプロパティを表示します。	コア	GA
az sf application update	Azure Service Fabric アプリケーションを更新します。 これにより、アプリケーションのパラメーターを更新したり、アプリケーションのアップグレードをトリガーするアプリケーションの種類のバージョンをアップグレードしたりできます。	コア	GA

az sf application create

Azure Service Fabric クラスターに新しいアプリケーションを作成します。

az sf application create --application-name
                         --application-type-name
                         --application-type-version
                         --cluster-name
                         --resource-group
                         [--application-parameters]
                         [--max-nodes]
                         [--min-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

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

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

アプリケーションを削除します。

az sf application delete --application-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

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

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

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

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

Azure Service Fabric クラスター上のアプリケーションのプロパティを表示します。

az sf application show --application-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

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

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

Azure Service Fabric アプリケーションを更新します。 これにより、アプリケーションのパラメーターを更新したり、アプリケーションのアップグレードをトリガーするアプリケーションの種類のバージョンをアップグレードしたりできます。

az sf application update --application-name
                         --cluster-name
                         --resource-group
                         [--application-parameters]
                         [--application-type-version]
                         [--consider-warning-as-error {false, true}]
                         [--failure-action {Manual, Rollback}]
                         [--force-restart {false, true}]
                         [--hc-retry-timeout]
                         [--hc-stable-duration]
                         [--hc-wait-duration]
                         [--max-nodes]
                         [--max-porcent-unhealthy-apps]
                         [--max-porcent-unhealthy-partitions]
                         [--max-porcent-unhealthy-replicas]
                         [--max-porcent-unhealthy-services]
                         [--min-nodes]
                         [--rep-check-timeout]
                         [--service-type-health-policy-map]
                         [--ud-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 --upgrade-replica-set-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

正常性評価中に警告の正常性イベントをエラー イベントとして扱うかどうかを示します。

承認された値: 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-nodes --maximum-nodes

アプリケーションを配置するノードの最大数を指定します。 このパラメーターの値は、負以外の整数である必要があります。 既定値は 0 で、クラスター内の任意の数のノードにアプリケーションを配置できることを示します。

--max-porcent-unhealthy-apps --max-unhealthy-apps

クラスターのアプリケーションの正常性状態がエラーになるまでに、クラスター内のノードにデプロイされたアプリケーション インスタンスの最大割合を指定します。 使用できる値は、フォーム 0 から 100 です。

--max-porcent-unhealthy-partitions --max-unhealthy-parts

監視対象のアップグレードに使用する既定のサービスの種類に対して、正常性ポリシーによって許可されるサービスあたりの不十分なパーティションの最大割合を指定します。 使用できる値は、フォーム 0 から 100 です。

--max-porcent-unhealthy-replicas --max-unhealthy-reps

監視対象のアップグレードに使用する既定のサービスの種類に対して、正常性ポリシーによって許可されるサービスあたりの不十分なレプリカの最大割合を指定します。 使用できる値は、フォーム 0 から 100 です。

--max-porcent-unhealthy-services --max-unhealthy-servs

監視対象のアップグレードに使用する既定のサービスの種類に対して、正常性ポリシーによって許可される不十分なサービスの最大割合を指定します。 使用できる値は、フォーム 0 から 100 です。

--min-nodes --minimum-nodes

Service Fabric がこのアプリケーションの容量を予約するノードの最小数を指定します。これは、アプリケーションがそれらのすべてのノードにレプリカがあることを保証することを意味するものではありません。 このパラメーターの値は、負以外の整数である必要があります。 既定値は 0 です。つまり、アプリケーション用に容量が予約されていないことを意味します。

--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"} の形式で指定します。 例: @{ "ServiceTypeName01" = "5,10,5";"ServiceTypeName02" = "5,5,5" }。

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

Service Fabric が 1 回のアップグレードに要する最大時間 (秒単位) を指定メイン。 この期間が経過すると、アップグレードは失敗します。

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