sfctl sa-cluster
スタンドアロンの Service Fabric クラスターを管理します。
コマンド
| command | 説明 |
|---|---|
| config | Service Fabric スタンドアロン クラスターの構成を取得します。 |
| config-upgrade | Service Fabric スタンドアロン クラスターの構成のアップグレードを開始します。 |
| upgrade-status | Service Fabric スタンドアロン クラスターのクラスター構成アップグレードの状態を取得します。 |
sfctl sa-cluster config
Service Fabric スタンドアロン クラスターの構成を取得します。
クラスター構成には、クラスターでのさまざまなノードの種類、セキュリティの構成、障害、アップグレード ドメイン トポロジなどを含む、クラスターのプロパティが含まれています。
引数
| Argument | 説明 |
|---|---|
| --configuration-api-version [必須] | スタンドアロン クラスター json 構成の API バージョン。 |
| --timeout -t | 操作を実行するためのサーバー タイムアウト (秒単位)。 このタイムアウトは、要求した操作が完了するまでクライアントが待機できる期間を指定します。 このパラメーターの既定値は 60 秒です。 既定値は60 です。 |
グローバル引数
| 引数 | 説明 |
|---|---|
| --debug | すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。 |
| --help -h | このヘルプ メッセージを表示して終了します。 |
| --output -o | 出力形式。 使用できる値: json、jsonc、table、tsv。 既定値: json。 |
| --query | JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。 |
| --verbose | ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。 |
sfctl sa-cluster config-upgrade
Service Fabric スタンドアロン クラスターの構成のアップグレードを開始します。
指定された構成アップグレード パラメーターを検証し、パラメーターが有効であれば、クラスター構成のアップグレードを開始します。
引数
| Argument | 説明 |
|---|---|
| --cluster-config [必須] | クラスター構成。 |
| --application-health-policies | アプリケーションの種類名と異常の最大パーセンテージのペアの JSON でエンコードされたディクショナリ。このパーセンテージを超えるとエラーが発生します。 |
| --delta-unhealthy-nodes | アップグレードの間のデルタ正常性低下の最大許容パーセンテージ。 使用可能な値は 0 から 100 までの整数値です。 |
| --health-check-retry | アプリケーションまたはクラスターが正常ではない場合に正常性チェックを実行する間隔。 既定値: PT0H0M0S。 |
| --health-check-stable | アプリケーションまたはクラスターが正常な状態である必要がある時間。この時間を超えると、アップグレードが次のアップグレード ドメインに進みます。 既定値: PT0H0M0S。 最初に、ISO 8601 の期間を表す文字列として解釈されます。 それが失敗した場合、ミリ秒単位の合計数を表す数値として解釈されます。 |
| --health-check-wait | アップグレード ドメインの完了後、正常性チェック プロセスを開始するまでの、待機時間の長さ。 既定値: PT0H0M0S。 |
| --timeout -t | 既定値は60 です。 |
| --unhealthy-applications | アップグレードの間の異常なアプリケーションの最大許容パーセンテージ。 使用可能な値は 0 から 100 までの整数値です。 |
| --unhealthy-nodes | アップグレードの間の異常なノードの最大許容パーセンテージ。 使用可能な値は 0 から 100 までの整数値です。 |
| --upgrade-domain-delta-unhealthy-nodes | アップグレードの間のアップグレード ドメイン デルタ正常性低下の最大許容パーセンテージ。 使用可能な値は 0 から 100 までの整数値です。 |
| --upgrade-domain-timeout | 各ドメインがアップグレードを完了する必要がある時間。この時間を超えると、FailureAction が実行されます。 既定値: PT0H0M0S。 最初に、ISO 8601 の期間を表す文字列として解釈されます。 それが失敗した場合、ミリ秒単位の合計数を表す数値として解釈されます。 |
| --upgrade-timeout | アップグレード全体を完了する必要がある時間。この時間を超えると、FailureAction が実行されます。 既定値: PT0H0M0S。 最初に、ISO 8601 の期間を表す文字列として解釈されます。 それが失敗した場合、ミリ秒単位の合計数を表す数値として解釈されます。 |
グローバル引数
| 引数 | 説明 |
|---|---|
| --debug | すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。 |
| --help -h | このヘルプ メッセージを表示して終了します。 |
| --output -o | 出力形式。 使用できる値: json、jsonc、table、tsv。 既定値: json。 |
| --query | JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。 |
| --verbose | ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。 |
例
クラスター構成の更新を開始します
sfctl sa-cluster config-upgrade --cluster-config <YOUR CLUSTER CONFIG> --application-health-
policies "{"fabric:/System":{"ConsiderWarningAsError":true}}"
sfctl sa-cluster upgrade-status
Service Fabric スタンドアロン クラスターのクラスター構成アップグレードの状態を取得します。
Service Fabric スタンドアロン クラスターのクラスター構成アップグレードの状態の詳細を取得します。
引数
| Argument | 説明 |
|---|---|
| --timeout -t | 操作を実行するためのサーバー タイムアウト (秒単位)。 このタイムアウトは、要求した操作が完了するまでクライアントが待機できる期間を指定します。 このパラメーターの既定値は 60 秒です。 既定値は60 です。 |
グローバル引数
| 引数 | 説明 |
|---|---|
| --debug | すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。 |
| --help -h | このヘルプ メッセージを表示して終了します。 |
| --output -o | 出力形式。 使用できる値: json、jsonc、table、tsv。 既定値: json。 |
| --query | JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。 |
| --verbose | ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。 |
次のステップ
- Service Fabric CLI をセットアップします。
- サンプル スクリプトを使用して、Service Fabric CLI の使用方法を学習します。