Acesse um aplicativo nos Aplicativos Spring do Azure em uma rede virtual

Artigo
02/01/2024

Observação

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

Este artigo se aplica ao: ✔️ nível Básico/Standard ✔️ nível Enterprise

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

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ó pode ser acessado na rede particular. 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 depreparo nos Aplicativos Spring do Azure. O Streaming de log, descrito em Transmitir logs de aplicativo do Azure Spring Apps em tempo real, também funciona apenas dentro da rede privada.

Pré-requisitos

Uma assinatura do Azure. Caso não tenha uma assinatura, crie uma conta gratuita antes de começar.
(Opcional) CLI do Azure 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, confira Implantar o Azure Spring Apps em uma rede virtual.

Use as etapas a seguir para localizar 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 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. Substitua os espaços reservados pelos 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 uma solução DNS própria para a sua rede virtual, como o Controlador de Domínio do Active Directory, o Infoblox ou outro, será necessário 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.

Observação

Se você estiver usando o Microsoft Azure operado pela 21Vianet, certifique-se de substituir private.azuremicroservices.ioprivate.microservices.azure.cn por 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 de DNS privado, selecione Adicionar.
Preencha o formulário na página Criar zona de DNS privado. Insira private.azuremicroservices.io como o Nome da zona.
Selecione Examinar + 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.

Vincular a rede virtual

Para vincular a zona de DNS privada à rede virtual, é necessário 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.
Em Nome do link, digite 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 manté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 registro de 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 DNS.

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

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

Configuração	Valor
Nome	Digite *.
Tipo	Selecione A.
TTL	Insira 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 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 os Aplicativos Spring do Azure em uma rede virtual. Para obter mais informações, confira Implantar o Azure Spring Apps 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 aplicativo. A atribuição de um FQDN pode levar alguns minutos.
Agora, o FQDN privado atribuído (rotulado como URL) 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.

Limpar os recursos

Se planejar continuar trabalhando nos próximos artigos, deixe esses recursos onde estão. Quando você não precisar mais deles, exclua o grupo de recursos, que exclui os recursos no grupo de recursos. Para excluir o grupo de recursos usando a CLI do Azure, use o seguinte comando:

az group delete --name $RESOURCE_GROUP