クラスター マネージャー: 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
フィールドで使う必要があります。
制限事項
- 名前付け - 名前付けルールについては、こちらを参照してください。
クラスター マネージャーのプロパティ
プロパティ名 | 説明 |
---|---|
名前、ID、場所、タグ、種類 | 名前: ユーザー フレンドリ名 ID: リソース ID 場所: クラスター マネージャーが作成される Azure リージョン。 値のソース: az account list -locations タグ: リソース タグ 種類: Microsoft.NetworkCloud/clusterManagers |
managerExtendedLocation | クラスター マネージャーに関連付けられている ExtendedLocation |
managedResourceGroupConfiguration | 内部で使用されるリソースをホストするためにクラスター マネージャー用に作成される管理対象リソース グループの詳細。 |
fabricControllerId | このクラスター マネージャーと 1 対 1 の関係があるネットワーク ファブリック コントローラーへの参照 |
analyticsWorkspaceId | 顧客に関連するログが見つかる Log Analytics ワークスペース。 |
clusterVersions[] | クラスター マネージャーがサポートするクラスター バージョンの一覧。 これは、クラスターの clusterVersion プロパティへの入力として使用されます。 |
provisioningState | クラスター マネージャーでの最新の操作のプロビジョニング状態。 成功、失敗、取り消し、プロビジョニング、承認済み、更新のいずれか |
detailedStatus | クラスター マネージャーの状態に関する追加情報を提供する詳細な状態。 |
detailedStatusMessage | 現在の詳細な状態に関する説明メッセージ。 |
クラスター マネージャー ID
顧客がクラスター マネージャーにマネージド ID を割り当てることができます。
2024-07-01
API バージョンから、システム割り当てとユーザー割り当ての両方のマネージド ID がサポートされています。
ユーザー割り当てマネージド ID を使用してクラスター マネージャーを作成する場合、顧客はその ID へのアクセスを Nexus プラットフォーム用にプロビジョニングする必要があります。
具体的には、Microsoft.ManagedIdentity/userAssignedIdentities/assign/action
アクセス許可を AFOI-NC-MGMT-PME-PROD
Microsoft Entra ID のユーザー割り当て ID に追加する必要があります。 これは、このプラットフォームの既知の制限事項であり、今後対処されます。
ロールの割り当ては、Azure portal から実行できます。
- Azure portal を開き、対象のユーザー割り当て ID を見つけます。
- 複数のマネージド ID がプロビジョニングされることが予想される場合は、代わりにリソース グループまたはサブスクリプション レベルでロールを追加できます。
-
Access control (IAM)
で [新しいロールの割り当てを追加する] をクリック - ロールの選択:
Managed Identity Operator
。 ロールが提供するアクセス許可を確認します。 - アクセス権の割り当て先: ユーザー、グループ、サービス プリンシパル
- メンバーの選択:
AFOI-NC-MGMT-PME-PROD
アプリケーション - 確認して割り当てる
クラスター マネージャーを作成する
以下のコマンドを使用して、クラスター マネージャーを作成します。
az networkcloud clustermanager create \
--name "$CLUSTER_MANAGER_NAME" \
--location "$LOCATION" \
--analytics-workspace-id "$LAW_NAME" \
--fabric-controller-id "$NFC_ID" \
--managed-resource-group-configuration name="$MRG_NAME" location="$MRG_LOCATION" \
--tags $TAG_KEY1="$TAG_VALUE1" $TAG_KEY2="$TAG_VALUE2"
--resource-group "$CLUSTER_MANAGER_RG"
--subscription "$SUB_ID"
引数:
-
--name
または-n
[必須] - クラスター マネージャーの名前。 -
--resource-group
または-g
[必須] - リソース グループの名前。az configure --defaults group=<name>
を使って、既定のリソース グループを構成できます。 -
--fabric-controller-id
[必須] - クラスター マネージャーに関連付けられているネットワーク ファブリック コントローラーのリソース ID。 -
--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
を使用して、既定のサブスクリプションを構成できます。 -
--mi-system-assigned
- システム割り当てマネージド ID を有効に設定。 -
--mi-user-assigned
- 追加するユーザー割り当てマネージド ID のスペース区切りのリソース ID。 -
--if-match
/if-none-match
- 同時に発生する変更が誤って上書きされないようにするための、最後に表示された ETag 値の指定。 ETag は、リソースが作成されるとリソース プロパティとして返され、更新操作で使用できます。
すべての Azure CLI コマンドで使用できる共通の引数:
-
--debug
- デバッグ目的で使用される CLI の実行に関する詳細情報を出力します。 バグを見つけた場合は、バグ レポートを送信するときに、--debug
フラグをオンにして生成した出力を提供してください。 -
--output
または-o
- 出力形式を指定します。 使用できる出力形式は、Json、Jsonc (色付けされた JSON)、tsv (タブ区切り値)、table (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は Json を出力します。 -
--query
- JMESPath クエリ言語を使用して、Azure サービスから返される出力をフィルター処理します。
クラスター マネージャーを一覧表示または表示する
list と show コマンドは、既存のクラスター マネージャーの一覧または特定のクラスター マネージャーのプロパティを取得するために使われます。
このコマンドは、指定したリソース グループ内のクラスター マネージャーの一覧を表示します。
az networkcloud clustermanager list --resource-group "$CLUSTER_MANAGER_RG"
このコマンドは、指定したサブスクリプション内のクラスター マネージャーの一覧を表示します。
az networkcloud clustermanager list --subscription "$SUB_ID"
このコマンドは、指定したクラスター マネージャーのプロパティを表示します。
az networkcloud clustermanager show \
--name "$CLUSTER_MANAGER_NAME" \
--resource-group "$CLUSTER_MANAGER_RG" \
--subscription "$SUB_ID"
クラスター マネージャーを更新する
このコマンドは、指定したクラスター マネージャーのプロパティにパッチを適用したり、クラスター マネージャーに割り当てられたタグを更新したりするために使います。 プロパティとタグの更新を、個別に実行できます。
このコマンドは、指定したリソース グループ内のクラスター マネージャーを更新します。
az networkcloud clustermanager update \
--name "$CLUSTER_MANAGER_NAME" \
--tags $TAG_KEY1="$TAG_VALUE1" $TAG_KEY2="$TAG_VALUE2" \
--resource-group "$CLUSTER_MANAGER_RG" \
--subscription "$SUB_ID"
クラスター マネージャー ID は、az networkcloud clustermanager identity
サブ コマンドを使用して CLI 経由で管理できます。
このコマンドは、現在割り当てられている ID を表示します。
az networkcloud clustermanager identity show \
--name "$CLUSTER_MANAGER_NAME" \
--resource-group "$CLUSTER_MANAGER_RG" \
--subscription "$SUB_ID"
このコマンドは、新しいユーザー割り当て ID を追加します。
az networkcloud clustermanager identity assign \
--name "$CLUSTER_MANAGER_NAME" \
--resource-group "$CLUSTER_MANAGER_RG" \
--subscription "$SUB_ID"
--mi-user-assigned "$UAI_RESOURCE_ID"
このコマンドは、システム割り当て ID を追加します。
az networkcloud clustermanager identity assign \
--name "$CLUSTER_MANAGER_NAME" \
--resource-group "$CLUSTER_MANAGER_RG" \
--subscription "$SUB_ID"
--mi-system-assigned
このコマンドは、既存のユーザー割り当て ID を削除します。
az networkcloud clustermanager identity remove \
--name "$CLUSTER_MANAGER_NAME" \
--resource-group "$CLUSTER_MANAGER_RG" \
--subscription "$SUB_ID"
--mi-user-assigned "$UAI_RESOURCE_ID"
このコマンドは、既存のシステム割り当て ID を削除します。
az networkcloud clustermanager identity remove \
--name "$CLUSTER_MANAGER_NAME" \
--resource-group "$CLUSTER_MANAGER_RG" \
--subscription "$SUB_ID"
--mi-system-assigned
クラスター マネージャーを削除する
このコマンドは、指定したクラスター マネージャーを削除するために使います。
警告
既存のネットワーク ファブリック コントローラーが関連付けられているクラスター マネージャー、またはこのクラスター マネージャーを参照しているクラスターは削除できません。
az networkcloud clustermanager delete \
--name "$CLUSTER_MANAGER_NAME" \
--resource-group "$CLUSTER_MANAGER_RG" \
--subscription "$SUB_ID"
Note
clustermanager の削除後、同じ名前の新しい clustermanager を作成する前に、20 分間待つことをお勧めします。
次のステップ
ネットワーク ファブリック コントローラーとクラスター マネージャーを正常に作成したら、次のステップはネットワーク ファブリックの作成です。