クラスター マネージャー: Operator Nexus でクラスター マネージャーを管理する方法

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 サービスから返される出力をフィルター処理します。

$TAGS_HASH = @{
  tag1 = "true"
  tag2 = "false"
}

New-AzNetworkCloudClusterManager -Name "$CLUSTER_MANAGER_NAME -Location $LOCATION -ResourceGroupName $CLUSTER_MANAGER_RG -SubscriptionId $SUB_ID -AnalyticsWorkspaceId $LAW_NAME -ManagedResourceGroupConfigurationName $MRG_NAME -ManagedResourceGroupConfigurationLocation $MRG_LOCATION -FabricControllerId $NFC_ID -Tag $TAGS_HASH

パラメーター:

• -Name - クラスター マネージャーの名前。
• -ResourceGroupName - リソース グループの名前。
• -SubscriptionId - ターゲット サブスクリプションの ID。
• -FabricControllerId - クラスター マネージャーとの間に 1 対 1 のマッピングがあるファブリック コントローラーのリソース ID。
• -Location - リソースが存在する地理的な場所。
• -AnalyticsWorkspaceId - ログ収集に使われる Log Analytics ワークスペースのリソース ID。
• -ManagedResourceGroupConfigurationLocation - 管理対象リソース グループの場所。 指定しないと、親リソースの場所が選択されます。
• -ManagedResourceGroupConfigurationName - 管理対象リソース グループの名前。 指定しないと、一意の名前が自動的に生成されます。
• -Tag - リソース タグのハッシュ テーブル。

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

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

• clusterManager.jsonc
• 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](レビュー + 作成) をクリックします。

このコマンドは、指定したリソース グループ内のクラスター マネージャーの一覧を表示します。

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"

このコマンドは、指定したリソース グループ内のクラスター マネージャーの一覧を表示します。

 Get-AzNetworkCloudClusterManager -ResourceGroupName "$CLUSTER_MANAGER_RG"

このコマンドは、指定したサブスクリプション内のクラスター マネージャーの一覧を表示します。

 Get-AzNetworkCloudClusterManager -SubscriptionId "$SUB_ID"

このコマンドは、指定したクラスター マネージャーのプロパティを JSON 形式で表示します。

 Get-AzNetworkCloudClusterManager -Name "$CLUSTER_MANAGER_NAME" -ResourceGroupName "$CLUSTER_MANAGER_RG" -SubscriptionId "$SUB_ID" | ConvertTo-Json

クラスター マネージャーを表示するには、ポータル、CLI、または PowerShell を使用します。

このコマンドは、指定したリソース グループ内のクラスター マネージャーを更新します。

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

$TAGS_HASH = @{
  tag1 = "true"
  tag2 = "false"
}

Update-AzNetworkCloudClusterManager -Name "$CLUSTER_MANAGER_NAME -ResourceGroupName $CLUSTER_MANAGER_RG -SubscriptionId $SUB_ID -Tag $TAGS_HASH

作成に使用されるテンプレートは、クラスター マネージャーの更新にも使用できます。

az networkcloud clustermanager delete \
    --name "$CLUSTER_MANAGER_NAME" \
    --resource-group "$CLUSTER_MANAGER_RG" \
    --subscription "$SUB_ID"

Remove-AzNetworkCloudClusterManager -Name "$CLUSTER_MANAGER_NAME -ResourceGroupName $CLUSTER_MANAGER_RG -SubscriptionId $SUB_ID

クラスター マネージャーを削除するには、ポータル、CLI、または PowerShell を使用します。