クラスター マネージャー: 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 CLI を使用してクラスター マネージャーを作成します。

クラスター マネージャーを作成するには、az networkcloud clustermanager create コマンドを使います。 このコマンドは、新しいクラスター マネージャーを作成するか、クラスター マネージャーが存在する場合はそのプロパティを更新します。 Azure サブスクリプションが複数ある場合は、az account set コマンドを使って適切なサブスクリプション ID を選びます。

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

Azure Resource Manager テンプレート エディターを使用してクラスター マネージャーを作成します。

クラスター マネージャーを作成する別の方法は、ARM テンプレート エディターを使用することです。

この方法でクラスターを作成するには、テンプレート ファイル (clusterManager.jsonc) とパラメーター ファイル (clusterManager.parameters.jsonc) を指定する必要があります。

次の 2 つのファイルの例を次に示します。

clusterManager.jsonc、clusterManager.parameters.jsonc

Note

正しい書式を取得するには、未加工のコード ファイルをコピーします。 clusterManager.parameters.jsonc ファイル内の値は顧客固有であり、完全なリストではない可能性があります。 使用している特定の環境に合わせて値フィールドを更新してください。

  1. Web ブラウザーで、Azure portal に移動してサインインします。
  2. Azure portal の検索バーで、"カスタム テンプレートのデプロイ" を検索し、使用可能なサービスから選択します。
  3. [エディターで独自のテンプレートをビルド] をクリックします。
  4. [ファイルの読み込み] をクリックします。 clusterManager.jsonc テンプレート ファイルを見つけてアップロードします。
  5. [保存] をクリックします。
  6. [パラメーターの編集] をクリックします。
  7. [ファイルの読み込み] をクリックします。 clusterManager.parameters.jsonc パラメーター ファイルを見つけてアップロードします。
  8. [保存] をクリックします。
  9. 適切なサブスクリプションを選択します。
  10. リソース グループが既に存在する場合は検索し、そうでない場合は新規作成します。
  11. すべてのインスタンス詳細が正しいことを確認します。
  12. [Review + create](レビュー + 作成) をクリックします。

クラスター マネージャーを一覧表示または表示する

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"

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 $TAG_KEY1="$TAG_VALUE1" $TAG_KEY2="$TAG_VALUE2" \
    --resource-group "$CLUSTER_MANAGER_RG" \
    --subscription "$SUB_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 "$CLUSTER_MANAGER_RG" \
    --subscription "$SUB_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 を使用して、既定のサブスクリプションを構成できます。

次のステップ

NFC とクラスター マネージャーを正常に作成できたら、次のステップは Network Fabric の作成です。