Cluster Manager: Administración de Cluster Manager en Operator Nexus

Artículo
10/26/2023

Cluster Manager se implementa en la suscripción de Azure del operador para administrar el ciclo de vida de los clústeres de infraestructura de Operator Nexus.

Antes de empezar

Necesitará:

Identificador de suscripción de Azure: el identificador de suscripción de Azure donde se debe crear cluster Manager (debe ser el mismo identificador de suscripción de Network Fabric Controller).
Identificador de controladora de tejido de red: controlador de tejido de red y administrador de clústeres tienen una asociación 1:1. Necesitará el identificador de recurso de la controladora de tejido de red asociada al Administrador de clústeres.
Identificador del área de trabajo de Log Analytics: el identificador de recurso del área de trabajo de Log Analytics que se usa para la colección de registros.
Región de Azure: el Administrador de clústeres debe crearse en la misma región de Azure que network Fabric Controller. Esta región de Azure debe usarse en el Location campo del Administrador de clústeres y en todas las instancias de Operator Nexus asociadas.

Argumentos globales

Algunos argumentos disponibles para cada comando de la CLI de Azure

--debug : imprime aún más información sobre las operaciones de la CLI, que se usan con fines de depuración. Si encuentra un error, proporcione la salida que se genera con la marca --debug activada al enviar un informe de errores.
--help -h : imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors : solo muestra errores, supresión de advertencias.
--output -o : especifica el formato de salida. Los formatos de salida disponibles son Json, Jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera json.
--query : usa el lenguaje de consulta JMESPath para filtrar la salida devuelta de los servicios de Azure.
--verbose : imprime información sobre los recursos creados en Azure durante una operación y otra información útil.

Elementos del Administrador de clústeres

Elementos	Descripción
Name, ID, location, tags, type	Nombre: nombre descriptivo Identificador: < id. de recurso > Ubicación: región de Azure donde se crea el Administrador de clústeres. Los valores de: `az account list -locations`. Etiquetas: etiquetas de recursos Tipo: Microsoft.NetworkCloud/clusterManagers
managerExtendedLocation	ExtendedLocation asociado al Administrador de clústeres
managedResourceGroupConfiguration	Información sobre el grupo de recursos administrados
fabricControllerId	Referencia a network Fabric Controller que es 1:1 con este Administrador de clústeres
analyticsWorkspaceId	Esta área de trabajo será donde se retransmitirán los registros pertinentes para el cliente.
clusterVersions[]	Lista de objetos ClusterAvailableVersions. Versiones de clúster que admite el administrador. Se usará como entrada en la propiedad cluster clusterVersion.
provisioningState	Correcto, Erróneo, Cancelado, Aprovisionamiento, Aceptado, Actualización
detailedStatus	Estados detallados que proporcionan información adicional sobre el estado del Administrador de clústeres.
detailedStatusMessage	Mensaje descriptivo sobre el elemento detailedStatus actual.

Creación de un administrador de clústeres

Use el az networkcloud clustermanager create comando para crear un Administrador de clústeres. Este comando crea un nuevo Administrador de clústeres o actualiza las propiedades del Administrador de clústeres si existe. Si tiene varias suscripciones de Azure, seleccione el identificador de suscripción adecuado mediante el comando az account set .

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>

Argumentos
- --name -n [Obligatorio] : el nombre del Administrador de clústeres.
- --fabric-controller-id [Obligatorio] : el identificador de recurso de la controladora de tejido de red que está asociada al Administrador de clústeres.
- --resource-group -g [Obligatorio] : nombre del grupo de recursos. Puede configurar el grupo de recursos predeterminado mediante az configure --defaults group=<name>.
- --analytics-workspace-id : el identificador de recurso del área de trabajo de Log Analytics que se usa para la colección de registros.
- --location -l - Location. Región de Azure donde se crea el Administrador de clústeres. Los valores de: az account list -locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.
- --managed-resource-group-configuration : la configuración del grupo de recursos administrado asociado al recurso.
  - Uso: --managed-resource-group-configuration location=XX name=XX
  - location: la región del grupo de recursos administrado. Si no se especifica, se elige la región del recurso primario.
  - name: nombre del grupo de recursos administrado. Si no se especifica, se genera automáticamente un nombre único.
- wait/--no-wait : espere a que el comando se complete o no espere a que finalice la operación de ejecución prolongada.
- --tags - Etiquetas separadas por espacios: key[=value] [key[=value]...]. Usar '' para borrar las etiquetas existentes
- --subscription : nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Mostrar o enumerar los administradores de clústeres

Los comandos list y show se usan para obtener una lista de administradores de clústeres existentes o las propiedades de un administrador de clústeres específico.

Enumerar administradores de clústeres en el grupo de recursos

Este comando enumera los administradores de clúster en el grupo de recursos especificado.

az networkcloud clustermanager list --resource-group <Azure Resource group>

Enumerar administradores de clústeres en la suscripción

Este comando enumera los administradores de clúster de la suscripción especificada.

az networkcloud clustermanager list  --subscription <subscription ID>

Mostrar propiedades del Administrador de clústeres

Este comando enumera las propiedades del Administrador de clústeres especificado.

az networkcloud clustermanager show \
    --name <Cluster Manager name> \
    --resource-group <Resource group Name>
    --subscription <subscription ID>

Argumentos de comando List/show

--name -n : el nombre del Administrador de clústeres.
--IDs : uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource ID".
--resource-group -g : nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
--subscription : nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Actualización del Administrador de clústeres

Este comando se usa para aplicar revisiones a las propiedades del Administrador de clústeres proporcionado o actualizar las etiquetas asignadas al Administrador de clústeres. Las propiedades y las actualizaciones de etiquetas se pueden realizar de forma independiente.

az networkcloud clustermanager update \
    --name <Cluster Manager name> \
    --tags < <key1=value1> <key2=value2>>
    --resource-group <Resource group Name>
    --subscription <subscription ID>

Argumentos
- --tags - Etiquetas separadas por TSpace: key[=value] [key[=value] ...]. Use '' para borrar las etiquetas existentes.
- --name -n : el nombre del Administrador de clústeres.
- --IDs : uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource ID".
- --resource-group -g : nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
- --subscription : nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Eliminación del Administrador de clústeres

Este comando se usa para eliminar el Administrador de clústeres proporcionado.

Advertencia

Es posible que no se elimine un administrador de clústeres que tenga un controlador de tejido de red asociado existente o cualquier clúster que haga referencia a este administrador de clústeres.

az networkcloud clustermanager delete \
    --name <Cluster Manager name> \
    --resource-group <Resource Group Name>
    --subscription <subscription ID>

Argumentos
- --no-wait : no espere a que se complete la operación de ejecución prolongada.
- --sí -y - No solicitar confirmación.
- --name -n : el nombre del Administrador de clústeres.
- --IDs : uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource ID".
- --resource-group -g : nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
- --subscription : nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Share via