你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
群集管理器:如何在 Operator Nexus 中管理群集管理器
群集管理器部署在操作员的 Azure 订阅中,用于管理操作员 Nexus 基础结构群集的生命周期。
开始之前
需要:
- Azure 订阅 ID - 需要在其中创建群集管理器的 Azure 订阅 ID(应为网络结构控制器的相同订阅 ID)。
- 网络结构控制器 ID - Network Fabric 控制器和群集管理器具有 1:1 关联。 需要与群集管理器关联的网络结构控制器的资源 ID。
- Log Analytics 工作区 ID - 用于日志收集的 Log Analytics 工作区的资源 ID。
- Azure 区域 - 应在网络结构控制器所在的同一 Azure 区域中创建群集管理器。
此 Azure 区域应在群集管理器和所有关联的操作员 Nexus 实例的字段中使用
Location
。
全局参数
可用于每个 Azure CLI 命令的一些参数
- --debug - 打印有关 CLI 操作的详细信息,用于调试目的。 如果发现了 bug,在提交 bug 报告时,请提供启用
--debug
标志生成的输出。 - --help -h - 打印有关命令及其参数的 CLI 参考信息,并列出可用的子组和命令。
- --only-show-errors - 仅显示错误,禁止显示警告。
- --output -o - 指定输出格式。 可用的输出格式为 Json、Jsonc(彩色 JSON)、tsv(制表分隔值)、表(人可读 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 对象的列表。 管理器支持的群集版本。 将用作 cluster clusterVersion 属性中的输入。 |
provisioningState | 成功、失败、已取消、预配、接受、更新 |
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
- 位置:托管资源组的区域。 如果未指定,则选择父资源的区域。
- 名称:托管资源组的名称。 如果未指定,则自动生成唯一名称。
- wait/--no-wait - 等待命令完成或等待长时间运行的操作完成。
- --tags - 空格分隔标记:key[=value] [key[=value]...]。使用“”清除现有标记
- --subscription - 订阅 的名称或 ID。 可以使用
az account set -s NAME_OR_ID
配置默认订阅。
列出/显示群集管理器(s)
列出和显示命令用于获取现有群集管理器的列表或特定群集管理器的属性。
列出资源组中的群集管理器
此命令列出指定资源组中的群集管理器。
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>
列出/显示命令参数
- --name -n - 群集管理器的名称。
- --ID - 一个或多个资源 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 - TSpace 分隔标记:key[=value] [key[=value] ...]。使用“”清除现有标记。
- --name -n - 群集管理器的名称。
- --ID - 一个或多个资源 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 - 群集管理器的名称。
- --ID - 一个或多个资源 ID(空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。
- --resource-group -g - 资源组的名称。 可以使用
az configure --defaults group=<name>
配置默认组。 - --subscription - 订阅 的名称或 ID。 可以使用
az account set -s NAME_OR_ID
配置默认订阅。