Share via

クラスター マネージャー: 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 を使用して、既定のサブスクリプションを構成できます。