Gerenciador de Cluster: como gerenciar o Gerenciador de Cluster no Operator Nexus

Criar o Gerenciador de Cluster com a Identidade Gerenciada Atribuída ao Sistema:

az networkcloud clustermanager create \
    --name "<CLUSTER_MANAGER_NAME>" \
    --___location "<LOCATION>" \
    --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>" \
    --mi-system-assigned \
    --subscription "<SUB_ID>"

Criar o Gerenciador de Cluster com a Identidade Gerenciada Atribuída pelo Usuário:

az networkcloud clustermanager create \
    --name "<CLUSTER_MANAGER_NAME>" \
    --___location "<LOCATION>" \
    --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>" \
    --mi-user-assigned "<UAMI_RID>" \
    --subscription "<SUB_ID>"

Argumentos:

• --name ou -n [Obrigatório] – O nome do Gerenciador de Cluster.
• --resource-group ou -g [Obrigatório] – O nome do grupo de recursos. Você pode configurar o grupo de recursos padrão usando az configure --defaults group=<name>.
• --fabric-controller-id [Obrigatório] – A ID do recurso do Controlador de Malha de Rede associado ao Gerenciador de Cluster.
• --___location ou -l – A região do Azure em que 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
  • local: a região do grupo de recursos gerenciado. Se não for especificado, a região do recurso pai será escolhida.
  • nome: o nome do grupo de recursos gerenciado. Se não for especificado, um nome exclusivo será gerado automaticamente.
• wait/--no-wait - Aguarde a conclusão do comando ou não aguarde a conclusão da operação de execução prolongada.
• --tags - Marcas separadas por espaço: key[=value] [key[=value]...]. Use '' para limpar marcas existentes.
• --subscription – Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
• --mi-system-assigned – Habilitar identidade gerenciada atribuída pelo sistema. Um de --mi-user-assigned ou --mi-system-assigned pode ser usado por vez.
• --mi-user-assigned - A ID do recurso da identidade gerenciada atribuída pelo usuário a ser adicionada. Um de --mi-user-assigned ou --mi-system-assigned pode ser usado por vez. Os Gerenciadores de Cluster dão suporte apenas a uma identidade gerenciada atribuída pelo usuário.
• --if-match/if-none-match – Especifique o valor de ETag visto pela última vez para impedir a substituição de alterações simultâneas. A ETag é retornada como a propriedade de recurso depois que o recurso é criado e pode ser usado nas operações de atualização.

Argumentos comuns disponíveis para cada comando da CLI do Azure:

• --debug – imprime informações detalhadas sobre a execução da CLI que são usadas para fins de depuração. Se você encontrar um erro, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
• --output ou -o – especifica o formato de saída. Os formatos de saída disponíveis são Json, Jsonc (JSON colorido), tsv (Valores Separados por Tabulação), tabela (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera JSON.
• --query – usa a linguagem de consulta JMESPath para filtrar a saída retornada dos serviços do Azure.

Criar o Gerenciador de Cluster com a Identidade Gerenciada Atribuída ao Sistema:

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

New-AzNetworkCloudClusterManager -Name "<CLUSTER_MANAGER_NAME>" -Location "<LOCATION>" -ResourceGroupName "<CLUSTER_MANAGER_RG>" -SubscriptionId "<SUB_ID>" -ManagedResourceGroupConfigurationName "<MRG_NAME>" -ManagedResourceGroupConfigurationLocation "<MRG_LOCATION>" -FabricControllerId "<NFC_ID>" -IdentityType "SystemAssigned" -Tag $TAGS_HASH

Criar o Gerenciador de Cluster com a Identidade Gerenciada Atribuída pelo Usuário:

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

New-AzNetworkCloudClusterManager -Name "<CLUSTER_MANAGER_NAME>" -Location "<LOCATION>" -ResourceGroupName "<CLUSTER_MANAGER_RG>" -SubscriptionId "<SUB_ID>" -ManagedResourceGroupConfigurationName "<MRG_NAME>" -ManagedResourceGroupConfigurationLocation "<MRG_LOCATION>" -FabricControllerId "<NFC_ID>" -IdentityType "UserAssigned" -IdentityUserAssignedIdentity <UAMI_RESOURCE_ID> -Tag $TAGS_HASH

Parâmetros:

• -Name – O nome do gerenciador de cluster.
• -ResourceGroupName – O nome do grupo de recursos.
• -SubscriptionId – O ID da assinatura de destino.
• -FabricControllerId –-A ID do recurso do controlador de malha que tem mapeamento um para um com o gerenciador de cluster.
• -Location – A localização geográfica em que o recurso reside.
• -ManagedResourceGroupConfigurationLocation – A localização do grupo de recursos gerenciado. Se não for especificado, o local do recurso pai será escolhido.
• -ManagedResourceGroupConfigurationName – O nome do grupo de recursos gerenciado. Se não for especificado, um nome exclusivo será gerado automaticamente.
• -IdentityType - O tipo de identidade gerenciada a ser usada para este Gerenciador de Cluster (UserAssignedou SystemAssigned). Se não for especificado, as Identidades Gerenciadas não serão usadas.
• -IdentityUserAssignedIdentity - A ResourceID da Identidade Gerenciada Atribuída pelo Usuário se estiver usando UserAssigned para IdentityType.
• -Tag – Tabela hash de rótulos de recurso.

Para criar um Gerenciador de Cluster por meio do modelo do ARM, você precisará fornecer um arquivo de modelo (clusterManager.jsonc) e um arquivo de parâmetro (clusterManager.parameters.jsonc).

Você pode encontrar exemplos desses dois arquivos aqui:

• clusterManager.jsonc
• clusterManager.parameters.jsonc

1. Abra um navegador da web, vá para o portal do Azure e entre.
2. Use a barra de pesquisa do portal do Azure e digite “Implantar um modelo personalizado”. Selecione-o entre os serviços disponíveis.
3. Clique em Criar seu próprio modelo no editor.
4. Clique em Carregar arquivo. Localize o arquivo de modelo clusterManager.jsonc e carregue-o.
5. Clique em Save (Salvar).
6. Clique em Editar parâmetros.
7. Clique em Carregar arquivo. Localize o arquivo de parâmetros clusterManager.parameters.jsonc e carregue-o.
8. Clique em Save (Salvar).
9. Selecione a Assinatura correta.
10. Pesquise o grupo de recursos se ele já existir ou crie um novo.
11. Verifique se todos os detalhes da instância estão corretos.
12. Clique em Revisar + Criar.

Este comando lista os Gerenciadores de Cluster no grupo de recursos especificado.

az networkcloud clustermanager list --resource-group "<CLUSTER_MANAGER_RG>" --subscription "<SUB_ID>"

Este comando lista os Gerenciador de Cluster na assinatura especificada.

az networkcloud clustermanager list  --subscription "<SUB_ID>"

Esse comando mostra as propriedades do Gerenciador de Cluster especificado.

az networkcloud clustermanager show \
    --name "<CLUSTER_MANAGER_NAME>" \
    --resource-group "<CLUSTER_MANAGER_RG>" \
    --subscription "<SUB_ID>"

Este comando lista os Gerenciadores de Cluster no grupo de recursos especificado.

 Get-AzNetworkCloudClusterManager -ResourceGroupName "<CLUSTER_MANAGER_RG>" -SubscriptionId "<SUB_ID>"

Este comando lista os Gerenciador de Cluster na assinatura especificada.

 Get-AzNetworkCloudClusterManager -SubscriptionId "<SUB_ID>"

Este comando mostra as propriedades do Gerenciador de Cluster especificado no formato JSON.

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

Para exibir Gerenciadores de Cluster, use o Portal, a CLI ou o PowerShell.

Esse comando atualiza os Gerenciadores de Cluster no grupo de recursos especificado.

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>"

A identidade do Gerenciador de Cluster pode ser gerenciada por meio da CLI usando az networkcloud clustermanager identity subcomandos.

Esse comando mostra as identidades atribuídas no momento.

az networkcloud clustermanager identity show \
    --name "<CLUSTER_MANAGER_NAME>" \
    --resource-group "<CLUSTER_MANAGER_RG>" \
    --subscription "<SUB_ID>"

Esse comando adiciona uma identidade atribuída pelo usuário.

az networkcloud clustermanager identity assign \
    --name "<CLUSTER_MANAGER_NAME>" \
    --resource-group "<CLUSTER_MANAGER_RG>" \
    --subscription "<SUB_ID>" \
    --mi-user-assigned "<UAMI_RESOURCE_ID>"

Esse comando adiciona uma identidade atribuída pelo sistema.

az networkcloud clustermanager identity assign \
    --name "<CLUSTER_MANAGER_NAME>" \
    --resource-group "<CLUSTER_MANAGER_RG>" \
    --subscription "<SUB_ID>" \
    --mi-system-assigned

Esse comando remove a identidade atribuída pelo usuário.

az networkcloud clustermanager identity remove \
    --name "<CLUSTER_MANAGER_NAME>" \
    --resource-group "<CLUSTER_MANAGER_RG>" \
    --subscription "<SUB_ID>" \
    --mi-user-assigned "<UAMI_RESOURCE_ID>"

Esse comando remove a identidade atribuída pelo sistema.

az networkcloud clustermanager identity remove \
    --name "<CLUSTER_MANAGER_NAME>" \
    --resource-group "<CLUSTER_MANAGER_RG>" \
    --subscription "<SUB_ID>" \
    --mi-system-assigned

Esse comando atualiza o Gerenciador de Clusters no grupo de recursos especificado.

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

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

Este comando atualiza o Gerenciador de Cluster para SystemAssigned Identidade Gerenciada:

Update-AzNetworkCloudClusterManager -Name "<CLUSTER_MANAGER_NAME>" -ResourceGroupName "<CLUSTER_MANAGER_RG>" -SubscriptionId "<SUB_ID>" -IdentityType "SystemAssigned"

Este comando atualiza o Gerenciador de Cluster para UserAssigned Identidade Gerenciada:

Update-AzNetworkCloudClusterManager -Name "<CLUSTER_MANAGER_NAME>" -ResourceGroupName "<CLUSTER_MANAGER_RG>" -SubscriptionId "<SUB_ID>" -IdentityType "UserAssigned" -IdentityUserAssignedIdentity <UAMI_RESOURCE_ID>

O modelo usado para criação também pode ser usado para atualizar o Gerenciador de Cluster.

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>"

Para excluir o Gerenciador de Cluster, use o Portal, a CLI ou o PowerShell.