Aceder a uma aplicação nas Aplicações Azure Spring numa rede virtual

Artigo
02/03/2024

Nota

Azure Spring Apps é o novo nome para o serviço Azure Spring Cloud. Embora o serviço tenha um novo nome, você verá o nome antigo em alguns lugares por um tempo enquanto trabalhamos para atualizar ativos, como capturas de tela, vídeos e diagramas.

Este artigo aplica-se a: ✔️ Basic/Standard ✔️ Enterprise

Este artigo explica como acessar um ponto de extremidade para seu aplicativo em uma rede privada.

Quando você atribui um ponto de extremidade em um aplicativo em uma instância de serviço do Azure Spring Apps implantada em sua rede virtual, o ponto de extremidade usa um FQDN (nome de domínio totalmente qualificado) privado. O domínio só é acessível na rede privada. Os aplicativos e serviços usam o ponto de extremidade do aplicativo. Eles incluem o Ponto de Extremidade de Teste descrito na seção Exibir aplicativos e implantações de Configurar um ambiente de preparono Azure Spring Apps. O streaming de logs, descrito em Transmitir logs do aplicativo Azure Spring Apps em tempo real, também funciona apenas na rede privada.

Pré-requisitos

Uma subscrição do Azure. Se você não tiver uma assinatura, crie uma conta gratuita antes de começar.
(Opcional) Azure CLI versão 2.45.0 ou superior.
Um aplicativo existente em uma instância de serviço do Azure Spring Apps implantado em uma rede virtual. Para obter mais informações, consulte Implantar aplicativos Azure Spring em uma rede virtual.

Use as etapas a seguir para encontrar o endereço IP do seu aplicativo.

Vá para a página Rede do serviço Azure Spring Apps.
Selecione a guia Injeção de Vnet.
Na seção Informações gerais, localize Ponto de extremidade e copie o valor do endereço IP. O exemplo na captura de tela a seguir usa o endereço 10.0.1.6IP :

Use as etapas a seguir para inicializar o ambiente local e localizar o endereço IP do seu aplicativo.

Use os comandos a seguir para definir várias variáveis de ambiente. Certifique-se de substituir os espaços reservados pelos seus valores reais.

export SUBSCRIPTION='<subscription-ID>'
export RESOURCE_GROUP='<resource-group-name>'
export AZURE_SPRING_APPS_INSTANCE_NAME='<Azure-Spring-Apps-instance-name>'
export VIRTUAL_NETWORK_NAME='<Azure-Spring-Apps-virtual-network-name>'
export APP_NAME='<application-name>'

Use os seguintes comandos para entrar na CLI do Azure e escolher sua assinatura ativa:
```
az login
az account set --subscription ${SUBSCRIPTION}
```

Use os comandos a seguir para localizar o endereço IP do seu aplicativo.

export SERVICE_RUNTIME_RG=$(az spring show \
    --resource-group $RESOURCE_GROUP \
    --name $AZURE_SPRING_APPS_INSTANCE_NAME \
    --query "properties.networkProfile.serviceRuntimeNetworkResourceGroup" \
    --output tsv)
export IP_ADDRESS=$(az network lb frontend-ip list \
    --lb-name kubernetes-internal \
    --resource-group $SERVICE_RUNTIME_RG \
    --query "[0].privateIPAddress" \
    --output tsv)
echo $IP_ADDRESS

Adicionar um DNS para o IP

Se você tiver sua própria solução de DNS para sua rede virtual, como o Controlador de Domínio Ative Directory, Infoblox ou outro, precisará apontar o domínio *.private.azuremicroservices.io para o endereço IP. Caso contrário, use as instruções a seguir para criar uma Zona DNS Privada do Azure em sua assinatura para traduzir/resolver o FQDN (nome de domínio totalmente qualificado) privado para seu endereço IP.

Nota

Se você estiver usando o Microsoft Azure operado pela 21Vianet, certifique-se de substituir private.azuremicroservices.io por private.microservices.azure.cn neste artigo. Para obter mais informações, consulte a seção Verificar pontos de extremidade no Azure do guia do desenvolvedor do Azure China.

Criar uma zona DNS privada

Portal do Azure
CLI do Azure

Use as seguintes etapas para criar uma zona DNS privada para um aplicativo na rede privada:

Abra o portal do Azure. Usando a caixa de pesquisa, procure zonas DNS privadas. Selecione Zonas DNS privadas nos resultados da pesquisa.
Na página Zonas DNS privadas, selecione Adicionar.
Preencha o formulário na página Criar zona DNS privada. Digite private.azuremicroservices.io como o Nome da zona.
Selecione Rever + Criar.
Selecione Criar.

Use o seguinte comando para criar a zona DNS privada:

az network private-dns zone create \
    --resource-group $RESOURCE_GROUP \
    --name private.azuremicroservices.io

Pode levar alguns minutos para criar a zona.

Ligar a rede virtual

Para vincular a zona DNS privada à rede virtual, você precisa criar um link de rede virtual.

Portal do Azure
CLI do Azure

Use as etapas a seguir para vincular a zona DNS privada que você criou à rede virtual que mantém seu serviço Azure Spring Apps:

Selecione o recurso de zona DNS privada que você criou - por exemplo, private.azuremicroservices.io.
Selecione Links de rede virtual e, em seguida, selecione Adicionar.
Para Nome do link, insira azure-spring-apps-dns-link.
Em Rede virtual, selecione a rede virtual criada anteriormente.
Selecione OK.

Use o comando a seguir para vincular a zona DNS privada que você criou à rede virtual que contém seu serviço Azure Spring Apps:

az network private-dns link vnet create \
    --resource-group $RESOURCE_GROUP \
    --name azure-spring-apps-dns-link \
    --zone-name private.azuremicroservices.io \
    --virtual-network $VIRTUAL_NETWORK_NAME \
    --registration-enabled false

Criar registo DNS

Você deve criar um registro do tipo "A" na zona DNS privada.

Portal do Azure
CLI do Azure

Use as etapas a seguir para usar a zona DNS privada para traduzir/resolver o DNS.

Selecione o recurso de zona DNS privada que você criou - por exemplo, private.azuremicroservices.io.
Selecione Conjunto de registos.

Em Adicionar conjunto de registros, insira ou selecione as seguintes informações:

Definição	valor
Nome	Introduzir *.
Type	Selecione A.
TTL	Digite 1.
Unidade de TTL	Selecione Horas.
Endereço IP	Digite o endereço IP. A captura de tela a seguir usa o endereço IP 10.1.0.7.

Selecione OK.

Use os seguintes comandos para criar o registro A na sua zona DNS:

az network private-dns record-set a add-record \
    --resource-group $RESOURCE_GROUP \
    --zone-name private.azuremicroservices.io \
    --record-set-name '*' \
    --ipv4-address $IP_ADDRESS

Atribuir um FQDN privado para seu aplicativo

Você pode atribuir um FQDN privado para seu aplicativo depois de implantar o Azure Spring Apps em uma rede virtual. Para obter mais informações, consulte Implantar aplicativos Azure Spring em uma rede virtual.

Portal do Azure
CLI do Azure

Use as seguintes etapas para atribuir um FQDN privado:

Selecione a instância de serviço do Azure Spring Apps implantada em sua rede virtual e abra a guia Aplicativos .
Selecione o aplicativo para abrir a página Visão geral .
Selecione Atribuir ponto de extremidade para atribuir um FQDN privado ao seu aplicativo. A atribuição de um FQDN pode levar alguns minutos.
O FQDN privado atribuído (URL rotulado) já está disponível. Você só pode acessar a URL dentro da rede privada, mas não na internet.

Use o seguinte comando para atribuir um ponto de extremidade ao seu aplicativo:

az spring app update \
    --resource-group $RESOURCE_GROUP \
    --name $APP_NAME \
    --service $AZURE_SPRING_APPS_INSTANCE_NAME \
    --assign-endpoint true

Acessar o FQDN privado do aplicativo

Após a atribuição, você pode acessar o FQDN privado do aplicativo na rede privada. Por exemplo, você pode criar uma máquina jumpbox na mesma rede virtual ou em uma rede virtual emparelhada. Em seguida, nessa jumpbox ou máquina virtual, você pode acessar o FQDN privado.

Clean up resources (Limpar recursos)

Se você planeja continuar trabalhando com artigos subsequentes, convém deixar esses recursos no lugar. Quando não precisar mais deles, exclua o grupo de recursos, que exclui os recursos do grupo de recursos. Para excluir o grupo de recursos usando a CLI do Azure, use o seguinte comando:

az group delete --name $RESOURCE_GROUP