次の方法で共有

az sf application

  • リファレンス

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

コマンド

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

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

--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 --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 --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 --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-porcent-unhealthy-apps --max-unhealthy-apps]
                         [--max-porcent-unhealthy-partitions --max-unhealthy-parts]
                         [--max-porcent-unhealthy-replicas --max-unhealthy-reps]
                         [--max-porcent-unhealthy-services --max-unhealthy-servs]
                         [--min-nodes --minimum-nodes]
                         [--rep-check-timeout --replica-check-timeout --upgrade-replica-set-check-timeout]
                         [--service-type-health-policy-map --service-type-policy]
                         [--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 --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

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

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