Conectar o RDP ao nós de cluster do Serviço de Kubernetes do Azure (AKS) para manutenção ou solução de problemas

Este artigo pressupõe que você já tenha um cluster AKS existente com um nó compatível com Windows Server. Se você precisar de um cluster AKS, consulte o artigo sobre como criar um cluster AKS com um contêiner do Windows usando o CLI do Azure. Você precisa do nome de usuário e senha do administrador do Windows do nó no Windows Server que você deseja solucionar problemas. Você também precisa de um computador cliente de RDP, como área de trabalho remota da Microsoft.

Se você precisar redefinir a senha, use az aks update para alterar a senha.

az aks update --resource-group myResourceGroup --name myAKSCluster --windows-admin-password $WINDOWS_ADMIN_PASSWORD

Se você precisar redefinir o nome de usuário e a senha, confira Redefinir Serviços da Área de Trabalho Remota ou senha do administrador em uma VM do Windows.

A versão 2.0.61 ou posterior do CLI do Azure também precisa estar instalada e configurada. Execute az --version para encontrar a versão. Se você precisa instalar ou atualizar, consulte Instalar a CLI do Azure.

Este artigo pressupõe que você já tenha um cluster AKS existente com um nó compatível com Windows Server. Se você precisar de um cluster AKS, consulte o artigo sobre como criar um cluster AKS com um contêiner do Windows usando o Azure PowerShell. Você precisa do nome de usuário e senha do administrador do Windows do nó no Windows Server que você deseja solucionar problemas. Você também precisa de um computador cliente de RDP, como área de trabalho remota da Microsoft.

Se você precisar redefinir a senha, use Set-AzAksCluster para alterar a senha.

$cluster = Get-AzAksCluster -ResourceGroupName myResourceGroup -Name myAKSCluster
$cluster.WindowsProfile.AdminPassword = $WINDOWS_ADMIN_PASSWORD
$cluster | Set-AzAksCluster

Se você precisar redefinir o nome de usuário e a senha, confira Redefinir Serviços da Área de Trabalho Remota ou senha do administrador em uma VM do Windows.

Também será necessária a versão 7.5.0 ou posterior do Azure PowerShell instalada e configurada. Execute Get-InstalledModule -Name Az para encontrar a versão. Se precisar instalar ou atualizar, consulte Instalar o Azure PowerShell.

Você precisa obter a ID da sub-rede usada pelo seu pool de nós do Windows Server e consultar por:

• O grupo de recursos do nó de cluster
• A rede virtual
• O nome da sub-rede
• A ID da sub-rede

CLUSTER_RG=$(az aks show --resource-group myResourceGroup --name myAKSCluster --query nodeResourceGroup -o tsv)
VNET_NAME=$(az network vnet list --resource-group $CLUSTER_RG --query [0].name -o tsv)
SUBNET_NAME=$(az network vnet subnet list --resource-group $CLUSTER_RG --vnet-name $VNET_NAME --query [0].name -o tsv)
SUBNET_ID=$(az network vnet subnet show --resource-group $CLUSTER_RG --vnet-name $VNET_NAME --name $SUBNET_NAME --query id -o tsv)

Agora que você tem o ID de sub-rede, execute o seguinte comando na mesma janela Azure Cloud Shell para criar a máquina virtual:

PUBLIC_IP_ADDRESS="myVMPublicIP"

az vm create \
    --resource-group myResourceGroup \
    --name myVM \
    --image win2019datacenter \
    --admin-username azureuser \
    --admin-password {admin-password} \
    --subnet $SUBNET_ID \
    --nic-delete-option delete \
    --os-disk-delete-option delete \
    --nsg "" \
    --public-ip-address $PUBLIC_IP_ADDRESS \
    --query publicIpAddress -o tsv

O exemplo de saída seguinte mostra que a máquina virtual foi criada com êxito e exibe o endereço IP aberto da máquina virtual.

13.62.204.18

Registre o endereço IP público da máquina virtual. Você usará este endereço numa etapa mais tarde.

Você precisará de obter a ID da sub-rede usada pelo seu pool de nós do Windows Server e consultar por:

• O grupo de recursos do nó de cluster
• A rede virtual
• O prefixo de nome e endereço da sub-rede
• A ID da sub-rede

$CLUSTER_RG = (Get-AzAksCluster -ResourceGroupName myResourceGroup -Name myAKSCluster).nodeResourceGroup
$VNET_NAME = (Get-AzVirtualNetwork -ResourceGroupName $CLUSTER_RG).Name
$ADDRESS_PREFIX = (Get-AzVirtualNetwork -ResourceGroupName $CLUSTER_RG).AddressSpace | Select-Object -ExpandProperty AddressPrefixes
$SUBNET_NAME = (Get-AzVirtualNetwork -ResourceGroupName $CLUSTER_RG).Subnets[0].Name
$SUBNET_ADDRESS_PREFIX = (Get-AzVirtualNetwork -ResourceGroupName $CLUSTER_RG).Subnets[0] | Select-Object -ExpandProperty AddressPrefix

Agora que você tem os detalhes da VNet e da sub-rede, execute os seguintes comandos na mesma janela do Azure Cloud Shell para criar o endereço IP público e a VM:

$ipParams = @{
    Name              = 'myPublicIP'
    ResourceGroupName = 'myResourceGroup'
    Location          = 'eastus'
    AllocationMethod  = 'Dynamic'
    IpAddressVersion  = 'IPv4'
}
New-AzPublicIpAddress @ipParams

$vmParams = @{
    ResourceGroupName            = 'myResourceGroup'
    Name                         = 'myVM'
    Image                        = 'win2019datacenter'
    Credential                   = Get-Credential azureuser
    VirtualNetworkName           = $VNET_NAME
    AddressPrefix                = $ADDRESS_PREFIX
    SubnetName                   = $SUBNET_NAME
    SubnetAddressPrefix          = $SUBNET_ADDRESS_PREFIX
    PublicIpAddressName          = 'myPublicIP'
    OSDiskDeleteOption           = 'Delete'
    NetworkInterfaceDeleteOption = 'Delete'
    DataDiskDeleteOption         = 'Delete'
}
New-AzVM @vmParams

(Get-AzPublicIpAddress -ResourceGroupName myResourceGroup -Name myPublicIP).IpAddress

O exemplo de saída seguinte mostra que a máquina virtual foi criada com êxito e exibe o endereço IP aberto da máquina virtual.

13.62.204.18

Registre o IP da máquina virtual e use o endereço em uma etapa posterior.

Primeiro, obtenha o grupo de recursos e o nome do grupo de segurança de rede do NSG para adicionar a regra:

CLUSTER_RG=$(az aks show --resource-group myResourceGroup --name myAKSCluster --query nodeResourceGroup -o tsv)
NSG_NAME=$(az network nsg list --resource-group $CLUSTER_RG --query [].name -o tsv)

Em seguida, crie a regra do NSG:

az network nsg rule create \
 --name tempRDPAccess \
 --resource-group $CLUSTER_RG \
 --nsg-name $NSG_NAME \
 --priority 100 \
 --destination-port-range 3389 \
 --protocol Tcp \
 --description "Temporary RDP access to Windows nodes"

Primeiro, obtenha o grupo de recursos e o nome do grupo de segurança de rede do NSG para adicionar a regra:

$CLUSTER_RG = (Get-AzAksCluster -ResourceGroupName myResourceGroup -Name myAKSCluster).nodeResourceGroup
$NSG_NAME = (Get-AzNetworkSecurityGroup -ResourceGroupName $CLUSTER_RG).Name

Em seguida, crie a regra do NSG:

$nsgRuleParams = @{
    Name                     = 'tempRDPAccess'
    Access                   = 'Allow'
    Direction                = 'Inbound'
    Priority                 = 100
    SourceAddressPrefix      = 'Internet'
    SourcePortRange          = '*'
    DestinationAddressPrefix = '*'
    DestinationPortRange     = '3389'
    Protocol                 = 'Tcp'
    Description              = 'Temporary RDP access to Windows nodes'
}
Get-AzNetworkSecurityGroup -Name $NSG_NAME -ResourceGroupName $CLUSTER_RG | Add-AzNetworkSecurityRuleConfig @nsgRuleParams | Set-AzNetworkSecurityGroup

Para gerenciar um cluster do Kubernetes, use kubectl, o cliente de linha de comando do Kubernetes. Se você usar o Azure Cloud Shell, o kubectl já estará instalado. Para instalar o kubectl localmente, use o comando az aks install-cli:

az aks install-cli

Para configurar o kubectl para se conectar ao cluster do Kubernetes, use o comando az aks get-credentials. Este comando baixa as credenciais e configura a CLI do Kubernetes para usá-las.

az aks get-credentials --resource-group myResourceGroup --name myAKSCluster

Para gerenciar um cluster do Kubernetes, use kubectl, o cliente de linha de comando do Kubernetes. Se você usar o Azure Cloud Shell, o kubectl já estará instalado. Para instalar kubectl localmente, use o cmdlet Install-AzAksKubectl:

Install-AzAksKubectl

Para configurar o kubectl para se conectar ao cluster do Kubernetes, use o cmdlet Import-AzAksCredential. Este comando baixa as credenciais e configura a CLI do Kubernetes para usá-las.

Import-AzAksCredential -ResourceGroupName myResourceGroup -Name myAKSCluster

Quando terminar, saia da conexão RDP de acordo como o nó do Windows Server e saia da sessão RDP segundo à máquina virtual. Após sair de ambas sessões RDP, exclua a máquina virtual com o comandoExcluir AZ da VM:

# Delete the virtual machine
az vm delete \
 --resource-group myResourceGroup \
 --name myVM

Exclua o IP público associado à máquina virtual:

az network public-ip delete \
 --resource-group myResourceGroup \
 --name $PUBLIC_IP_ADDRESS

Exclua a regra NSG:

CLUSTER_RG=$(az aks show --resource-group myResourceGroup --name myAKSCluster --query nodeResourceGroup -o tsv)
NSG_NAME=$(az network nsg list --resource-group $CLUSTER_RG --query [].name -o tsv)
az network nsg rule delete \
 --resource-group $CLUSTER_RG \
 --nsg-name $NSG_NAME \
 --name tempRDPAccess

Quando terminar, saia da conexão RDP de acordo como o nó do Windows Server e saia da sessão RDP segundo à máquina virtual. Após sair de ambas sessões RDP, exclua a máquina virtual com o comandoRemove-AzVM:

Remove-AzVM -ResourceGroupName myResourceGroup -Name myVM

Exclua o IP público associado à máquina virtual:

Remove-AzPublicIpAddress -ResourceGroupName myResourceGroup -Name myPublicIP

Exclua a regra NSG:

$CLUSTER_RG = (Get-AzAksCluster -ResourceGroupName myResourceGroup -Name myAKSCluster).nodeResourceGroup
$NSG_NAME = (Get-AzNetworkSecurityGroup -ResourceGroupName $CLUSTER_RG).Name

Get-AzNetworkSecurityGroup -Name $NSG_NAME -ResourceGroupName $CLUSTER_RG | Remove-AzNetworkSecurityRuleConfig -Name tempRDPAccess | Set-AzNetworkSecurityGroup

Exclua o NSG criado por padrão no New-AzVM:

Remove-AzNetworkSecurityGroup -ResourceGroupName myResourceGroup -Name myVM

az aks show --name myAKSCluster --resource-group myResourceGroup --query 'nodeResourceGroup' -o tsv

(Get-AzAksCluster -ResourceGroupName myResourceGroup -Name myAKSCluster).nodeResourceGroup