Gestor de Cluster: Como gerir o Gestor de Cluster no Operator Nexus

Artigo
10/26/2023

O Gerenciador de Cluster é implantado na assinatura do Azure do operador para gerenciar o ciclo de vida dos Clusters de Infraestrutura do Operator Nexus.

Antes de começar

Precisará:

ID de Assinatura do Azure - A ID de assinatura do Azure onde o Gerenciador de Cluster precisa ser criado (deve ser a mesma ID de assinatura do Controlador de Malha de Rede).
ID do controlador de malha de rede - O controlador de malha de rede e o Gerenciador de cluster têm uma associação 1:1. Você precisará da ID do recurso do Controlador de Malha de Rede associado ao Gerenciador de Cluster.
ID do Espaço de Trabalho do Log Analytics - O ID do recurso do Espaço de Trabalho do Log Analytics usado para a coleta de logs.
Região do Azure - O Gerenciador de Cluster deve ser criado na mesma região do Azure que o Controlador de Malha de Rede. Essa região do Azure deve ser usada no campo do Location Gerenciador de Cluster e em todas as instâncias do Nexus do Operador associadas.

Argumentos globais

Alguns argumentos que estão disponíveis para cada comando da CLI do Azure

--debug - imprime ainda mais informações sobre as operações da CLI, usadas para fins de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
--help -h - imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors - Mostrar apenas erros, suprimindo avisos.
--output -o - especifica o formato de saída. Os formatos de saída disponíveis são Json, Jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera saídas Json.
--query - usa a linguagem de consulta JMESPath para filtrar a saída retornada dos serviços do Azure.
--verbose - imprime informações sobre recursos criados no Azure durante uma operação e outras informações úteis

Elementos do Gerenciador de Cluster

Elementos	Descrição
Nome, ID, localização, tags, tipo	Nome: Nome amigável ID: < ID do recurso > Local: região do Azure onde o Gerenciador de Cluster é criado. Valores de: `az account list -locations`. Tags: Tags de recursos Tipo: Microsoft.NetworkCloud/clusterManagers
managerExtendedLocation	O ExtendedLocation associado ao Gerenciador de Cluster
managedResourceGroupConfiguration	Informações sobre o Grupo de Recursos Gerenciados
fabricControllerId	Uma referência ao controlador de malha de rede que é 1:1 com este Gerenciador de Cluster
analyticsWorkspaceId	Este espaço de trabalho será onde todos os logs relevantes para o cliente serão retransmitidos.
clusterVersões[]	Lista de objetos ClusterAvailableVersions. Versões de cluster suportadas pelo gestor. Será usado como uma entrada na propriedade clusterVersion do cluster.
provisionamentoEstado	Êxito, Falha, Cancelado, Provisionamento, Aceito, Atualização
detailedStatus	Status detalhado que fornece informações adicionais sobre o status do Gerenciador de Cluster.
detailedStatusMessage	Mensagem descritiva sobre o atual detailedStatus.

Criar um Gestor de Cluster

Use o az networkcloud clustermanager create comando para criar um Gerenciador de Cluster. Este comando cria um novo Gestor de Cluster ou atualiza as propriedades do Gestor de Cluster, se existir. Se você tiver várias assinaturas do Azure, selecione a ID de assinatura apropriada usando o 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 [Required] - O nome do Gerenciador de Cluster.
- --fabric-controller-id [Required] - A ID do recurso do Controlador de Malha de Rede associado ao Gerenciador de Cluster.
- --resource-group -g [Obrigatório] - Nome do grupo de recursos. Você pode configurar o grupo de recursos padrão usando az configure --defaults group=<name>o .
- --analytics-workspace-id - O ID do recurso do espaço de trabalho do Log Analytics usado para a coleção de logs
- --localização -l - Localização. Região do Azure onde o Gerenciador de Cluster é criado. Valores de: az account list -locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.
- --managed-resource-group-configuration - A configuração do grupo de recursos gerenciado associado ao recurso.
  - Uso: --managed-resource-group-configuration location=XX name=XX
  - location: A região do grupo de recursos gerenciados. Se não for especificado, a região do recurso pai será escolhida.
  - name: O nome do grupo de recursos gerenciados. Se não for especificado, um nome exclusivo será gerado automaticamente.
- wait/--no-wait - Aguarde a conclusão do comando ou não espere a conclusão da operação de longa duração.
- --tags - Tags separadas por espaço: key[=value] [key[=value]...]. Use '' para limpar tags existentes
- --subscription - Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

Listar/mostrar Gestor(es) de Cluster

Os comandos list e show são usados para obter uma lista de Gerentes de Cluster existentes ou as propriedades de um Gerenciador de Cluster específico.

Listar Gerentes de Cluster no grupo de recursos

Este comando lista os Gestores de Cluster no grupo de Recursos especificado.

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

Listar Gerentes de Cluster na assinatura

Este comando lista os Gestores de Cluster na subscrição especificada.

az networkcloud clustermanager list  --subscription <subscription ID>

Mostrar propriedades do Cluster Manager

Este comando lista as propriedades do Gerenciador de Cluster especificado.

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

Argumentos do comando List/show

--name -n - O nome do Gerenciador de Cluster.
--IDs - Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'.
--resource-group -g - Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
--subscription - Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

Atualizar o Gerenciador de Cluster

Este comando é usado para corrigir propriedades do Gerenciador de Cluster fornecido ou atualizar as tags atribuídas ao Gerenciador de Cluster. As atualizações de propriedades e tags podem ser feitas de forma independente.

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

Argumentos
- --tags - Tags separadas por TSpace: key[=value] [key[=value] ...]. Use '' para limpar tags existentes.
- --name -n - O nome do Gerenciador de Cluster.
- --IDs - Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'.
- --resource-group -g - Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
- --subscription - Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

Excluir o Gerenciador de Cluster

Este comando é usado para Excluir o Gerenciador de Cluster fornecido.

Aviso

Um Gerenciador de Cluster que tenha um Controlador de Malha de Rede associado existente ou quaisquer Clusters que façam referência a esse Gerenciador de Cluster não podem ser excluídos.

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

Argumentos
- --no-wait - Não espere que a operação de longa duração seja concluída.
- --yes -y - Não solicite confirmação.
- --name -n - O nome do Gerenciador de Cluster.
- --IDs - Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'.
- --resource-group -g - Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
- --subscription - Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

Share via