az sf service

Azure Service Fabric クラスターで実行されているサービスを管理します。 ARM デプロイ済みサービスのみをサポートします。

コマンド

名前	説明	型	状態
az sf service create	Azure Service Fabric クラスターに新しいサービスを作成します。	コア	GA
az sf service delete	サービスを削除します。	コア	GA
az sf service list	特定のアプリケーションのサービスを一覧表示します。	コア	GA
az sf service show	サービスを取得します。	コア	GA

az sf service create

Azure Service Fabric クラスターに新しいサービスを作成します。

az sf service create --application
                     --cluster-name
                     --name
                     --resource-group
                     --service-type
                     --state {stateful, stateless}
                     [--default-move-cost {High, Low, Medium, Zero}]
                     [--instance-count]
                     [--min-replica]
                     [--partition-scheme {named, singleton, uniformInt64}]
                     [--target-replica]

例

インスタンス数 -1 (すべてのノード) を使用して、新しいステートレス サービス "testApp~testService1" を作成します。

az sf service create -g testRG -c testCluster --application-name testApp --state stateless --service-name testApp~testService \
  --service-type testStateless --instance-count -1 --partition-scheme singleton

ターゲットが 5 ノードの新しいステートフル サービス "testApp~testService2" を作成します。

az sf service create -g testRG -c testCluster --application-name testApp --state stateful --service-name testApp~testService2 \
  --service-type testStatefulType --min-replica-set-size 3 --target-replica-set-size 5

必須のパラメーター

--application --application-name

サービスの名前を指定します。 アプリケーション名は、サービス名のプレフィックスである必要があります (例: appName~serviceName)。

--cluster-name -c

指定しない場合は、クラスターの名前をリソース グループ名と同じにします。

--name --service-name

サービスの名前を指定します。 アプリケーション名は、サービス名のプレフィックスである必要があります (例: appName~serviceName)。

--resource-group -g

リソース グループ名を指定します。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--service-type

アプリケーションのサービスの種類名を指定します。アプリケーション マニフェストに存在する必要があります。

--state

サービスがステートレスかステートフルか指定します。

指定可能な値: stateful, stateless

省略可能のパラメーター

--default-move-cost

移動の既定のコストを指定します。 コストが高いほど、クラスターリソースマネージャーがクラスターのバランスを取ろうとするときにレプリカを移動する可能性が低くなります。

指定可能な値: High, Low, Medium, Zero

--instance-count

ステートレス サービスのインスタンス数を指定します。 -1 が使用されている場合は、すべてのノードで実行されることを意味します。

--min-replica --min-replica-set-size

ステートフル サービスの最小レプリカ セット サイズを指定します。

--partition-scheme

使用するパーティション構成を指定します。 通常、単一パーティションは、サービスに追加のルーティングが必要ない場合に使用されます。 UniformInt64 は、各パーティションが int64 キーの範囲を所有していることを意味します。 通常、名前付きは、境界セット内でバケット化できるデータを含むサービス用です。 名前付きパーティション分割キーとして使用されるデータ フィールドの一般的な例として、地域、郵便番号、顧客グループ、その他のビジネスの境界などがあります。

指定可能な値: named, singleton, uniformInt64

規定値: singleton

--target-replica --target-replica-set-size

ステートフル サービスのターゲット レプリカ セットサイズを指定します。

グローバル パラメーター

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

サービスを削除します。

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

例

サービスを削除します。

az sf service delete -g testRG -c testCluster --application-name testApp --service-name testApp~testService

必須のパラメーター

--application-name

アプリケーション リソースの名前。 必須。

--cluster-name -c

指定しない場合は、クラスターの名前をリソース グループ名と同じにします。

--name --service-name

サービスの名前を指定します。 アプリケーション名は、サービス名のプレフィックスである必要があります (例: appName~serviceName)。

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

特定のアプリケーションのサービスを一覧表示します。

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

例

サービスを一覧表示します。

az sf service list -g testRG -c testCluster --application-name testApp

必須のパラメーター

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

サービスを取得します。

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

例

Azure Service Fabric クラスター上のサービスのプロパティを表示します。

az sf service show -g testRG -c testCluster --application-name testApp --service-name testApp~testService

必須のパラメーター

--application-name

アプリケーション リソースの名前。 必須。

--cluster-name -c

指定しない場合は、クラスターの名前をリソース グループ名と同じにします。

--name --service-name

サービスの名前を指定します。 アプリケーション名は、サービス名のプレフィックスである必要があります (例: appName~serviceName)。

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