クラスター マネージャー: Operator Nexus でクラスター マネージャーを管理する方法
Operator Nexus インフラストラクチャ クラスターのライフサイクルを管理するため、クラスター マネージャーはオペレーターの Azure サブスクリプションにデプロイされます。
開始する前に
次が必要です。
- Azure サブスクリプション ID - クラスター マネージャーを作成する必要がある Azure サブスクリプション ID (ネットワーク ファブリック コントローラーと同じサブスクリプション ID である必要があります)。
- ネットワーク ファブリック コントローラー ID - ネットワーク ファブリック コントローラーとクラスター マネージャーには、1 対 1 の関連付けがあります。 クラスター マネージャーに関連付けられているネットワーク ファブリック コントローラーのリソース ID が必要です。
- Log Analytics ワークスペース ID - ログ収集に使われる Log Analytics ワークスペースのリソース ID。
- Azure リージョン - クラスター マネージャーは、ネットワーク ファブリック コントローラーと同じ Azure リージョンに作成する必要があります。
この Azure リージョンを、クラスター マネージャーおよび関連するすべての Operator Nexus インスタンスの
Location
フィールドで使う必要があります。
グローバル引数
すべての Azure CLI コマンドで使用できるいくつかの引数
- --debug - デバッグのために使われる、CLI 操作に関する詳細情報を出力します。 バグを見つけた場合は、バグ レポートを送信するときに、
--debug
フラグをオンにして生成した出力を提供してください。 - --help -h - コマンドとその引数に関する CLI 参照情報を出力し、利用できるサブグループとコマンドの一覧を表示します。
- --only-show-errors - エラーのみを表示し、警告は抑制します。
- --output -o - 出力形式を指定します。 使用できる出力形式は、Json、Jsonc (色付けされた JSON)、tsv (タブ区切り値)、table (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は Json を出力します。
- --query - JMESPath クエリ言語を使って、Azure サービスから返された出力をフィルター処理します。
- --verbose - 操作中に Azure で作成されたリソースに関する情報と、その他の有用な情報を出力します
クラスター マネージャーの要素
要素 | 説明 |
---|---|
名前、ID、場所、タグ、種類 | 名前: ユーザー フレンドリ名 ID: < リソース ID > 場所: クラスター マネージャーが作成される Azure リージョン。 値のソース: az account list -locations タグ: リソース タグ 種類: Microsoft.NetworkCloud/clusterManagers |
managerExtendedLocation | クラスター マネージャーに関連付けられている ExtendedLocation |
managedResourceGroupConfiguration | 管理対象リソース グループに関する情報 |
fabricControllerId | このクラスター マネージャーと 1 対 1 の関係があるネットワーク ファブリック コントローラーへの参照 |
analyticsWorkspaceId | このワークスペースでは、顧客に関連するログが中継されます。 |
clusterVersions[] | ClusterAvailableVersions オブジェクトの一覧。 マネージャーがサポートするクラスターのバージョン。 クラスターの clusterVersion プロパティへの入力として使われます。 |
provisioningState | Succeeded、Failed、Canceled、Provisioning、Accepted、Updating |
detailedStatus | クラスター マネージャーの状態に関する追加情報を提供する詳細な状態。 |
detailedStatusMessage | 現在の detailedStatus に関する説明メッセージ。 |
クラスター マネージャーを作成する
クラスター マネージャーを作成するには、az networkcloud clustermanager create
コマンドを使います。 このコマンドは、新しいクラスター マネージャーを作成するか、クラスター マネージャーが存在する場合はそのプロパティを更新します。 Azure サブスクリプションが複数ある場合は、az account set コマンドを使って適切なサブスクリプション ID を選びます。
az networkcloud clustermanager create \
--name <Cluster Manager name> \
--location <region> \
--analytics-workspace-id <log analytics workspace ID>
--fabric-controller-id <Fabric controller ID associated with this Cluster Manager>
--managed-resource-group-configuration < name=<Managed Resource group Name> location=<Managed Resource group location> >
--tags <key=value key=value>
--resource-group <Resource Group Name>
--subscription <subscription ID>
- 引数
- --name -n [必須] - クラスター マネージャーの名前。
- --fabric-controller-id [必須] - クラスター マネージャーに関連付けられているネットワーク ファブリック コントローラーのリソース ID。
- --resource-group -g [必須] - リソース グループの名前。
az configure --defaults group=<name>
を使って、既定のリソース グループを構成できます。 - --analytics-workspace-id - ログ収集に使われる Log Analytics ワークスペースのリソース ID
- --location -l - 場所。 クラスター マネージャーが作成される Azure リージョン。 値のソース:
az account list -locations
az configure --defaults location=<location>
を使用して、既定の場所を構成できます。 - --managed-resource-group-configuration - リソースに関連付けられている管理対象リソース グループの構成。
- 使い方: --managed-resource-group-configuration location=XX name=XX
- location: 管理対象リソース グループのリージョン。 指定しないと、親リソースのリージョンが選ばれます。
- name: 管理対象リソース グループの名前。 指定しないと、一意の名前が自動的に生成されます。
- wait/--no-wait - コマンドが完了するまで待つか、実行時間の長い操作が完了するまで待ちません。
- --tags - スペース区切りのタグ: key[=value] [key[=value]...]。既存のタグをクリアするには '' を使います
- --subscription - サブスクリプションの名前または ID。
az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
クラスター マネージャーを一覧表示または表示する
list と show コマンドは、既存のクラスター マネージャーの一覧または特定のクラスター マネージャーのプロパティを取得するために使われます。
リソース グループ内のクラスター マネージャーの一覧を表示する
このコマンドは、指定したリソース グループ内のクラスター マネージャーの一覧を表示します。
az networkcloud clustermanager list --resource-group <Azure Resource group>
サブスクリプション内のクラスター マネージャーの一覧を表示する
このコマンドは、指定したサブスクリプション内のクラスター マネージャーの一覧を表示します。
az networkcloud clustermanager list --subscription <subscription ID>
クラスター マネージャーのプロパティを表示する
このコマンドは、指定したクラスター マネージャーのプロパティの一覧を表示します。
az networkcloud clustermanager show \
--name <Cluster Manager name> \
--resource-group <Resource group Name>
--subscription <subscription ID>
list/show コマンドの引数
- --name -n - クラスター マネージャーの名前。
- --IDs - 1 つ以上のリソース ID (スペース区切り)。 "リソース ID" 引数のすべての情報を含む完全なリソース ID を指定する必要があります。
- --resource-group -g - リソース グループの名前。
az configure --defaults group=<name>
を使用して、既定のグループを構成できます。 - --subscription - サブスクリプションの名前または ID。
az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
クラスター マネージャーを更新する
このコマンドは、指定したクラスター マネージャーのプロパティにパッチを適用したり、クラスター マネージャーに割り当てられたタグを更新したりするために使います。 プロパティとタグの更新を、個別に実行できます。
az networkcloud clustermanager update \
--name <Cluster Manager name> \
--tags < <key1=value1> <key2=value2>>
--resource-group <Resource group Name>
--subscription <subscription ID>
- 引数
- --tags - スペース区切りのタグ: key[=value] [key[=value] ...]。既存のタグをクリアするには '' を使用します。
- --name -n - クラスター マネージャーの名前。
- --IDs - 1 つ以上のリソース ID (スペース区切り)。 "リソース ID" 引数のすべての情報を含む完全なリソース ID を指定する必要があります。
- --resource-group -g - リソース グループの名前。
az configure --defaults group=<name>
を使用して、既定のグループを構成できます。 - --subscription - サブスクリプションの名前または ID。
az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
クラスター マネージャーを削除する
このコマンドは、指定したクラスター マネージャーを削除するために使います。
警告
既存のネットワーク ファブリック コントローラーが関連付けられているクラスター マネージャー、またはこのクラスター マネージャーを参照しているクラスターは削除できません。
az networkcloud clustermanager delete \
--name <Cluster Manager name> \
--resource-group <Resource Group Name>
--subscription <subscription ID>
- 引数
- --no-wait - 実行時間の長い操作が完了するまで待ちません。
- --yes -y - 確認メッセージを表示しません。
- --name -n - クラスター マネージャーの名前。
- --IDs - 1 つ以上のリソース ID (スペース区切り)。 "リソース ID" 引数のすべての情報を含む完全なリソース ID を指定する必要があります。
- --resource-group -g - リソース グループの名前。
az configure --defaults group=<name>
を使用して、既定のグループを構成できます。 - --subscription - サブスクリプションの名前または ID。
az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。