Mapeie nomes DNS para aplicativos em várias instâncias de serviço do Azure Spring Apps na mesma rede virtual

Nota

Os planos Basic, Standard e Enterprise serão preteridos a partir de meados de março de 2025, com um período de aposentadoria de 3 anos. Recomendamos a transição para os Aplicativos de Contêiner do Azure. Para obter mais informações, consulte o anúncio de aposentadoria do Azure Spring Apps.

O plano de consumo padrão e dedicado será preterido a partir de 30 de setembro de 2024, com um desligamento completo após seis meses. Recomendamos a transição para os Aplicativos de Contêiner do Azure. Para obter mais informações, consulte Migrar consumo padrão e plano dedicado do Azure Spring Apps para Aplicativos de Contêiner do Azure.

Este artigo aplica-se a:✅ Basic/Standard ✅ Enterprise

Este artigo mostra como mapear nomes DNS (Sistema de Nomes de Domínio) para aplicativos para acessar várias instâncias de serviço do Azure Spring Apps na mesma rede virtual.

Pré-requisitos

• Uma subscrição do Azure. Se você não tiver uma assinatura, crie uma conta gratuita antes de começar.
• Azure CLI versão 2.45.0 ou superior. Use o seguinte comando para instalar a extensão Azure Spring Apps: az extension add --name spring
• Uma rede virtual implantada em uma instância do Azure Spring Apps. Para obter mais informações, consulte Implantar aplicativos Azure Spring em sua rede virtual do Azure (injeção de VNet).

Descrição geral

Este artigo descreve as duas abordagens a seguir para mapear nomes DNS para aplicativos:

• Usando o FQDN (nome de domínio totalmente qualificado) fornecido pela Microsoft.

  Essa abordagem é uma maneira relativamente simples e leve de mapear nomes DNS em comparação com a abordagem de domínio personalizado. Essa abordagem é recomendada se você não precisar de uma abordagem curinga em sua zona DNS.

  Essa abordagem requer um registro DNS para cada aplicativo.

• Usando um domínio personalizado.

  Se você já tiver um domínio personalizado ou quiser que uma abordagem curinga funcione em um cenário de várias instâncias, use essa abordagem.

  Essa abordagem requer um registro DNS para cada instância de serviço do Azure Spring Apps e um domínio personalizado configurado para cada aplicativo.

Como exemplo, este artigo usa azure-spring-apps-1 e azure-spring-apps-2 como os nomes de duas instâncias do Azure Spring Apps na mesma rede virtual.

Comece com a seção Etapas preliminares para mapeamento de DNS e, em seguida, prossiga com sua abordagem preferida:

• Mapeamento de DNS com FQDN fornecido pela Microsoft
• Mapeamento de DNS com um domínio personalizado

Termine testando o mapeamento conforme descrito na seção Acessar URLs FQDN privadas para aplicativos privados.

Etapas preliminares para mapeamento de DNS

Conclua as etapas nesta seção para o FQDN e as abordagens de domínio personalizado para mapear nomes DNS.

Encontrar endereços IP de aplicativos

Ambas as abordagens exigem o endereço IP de cada aplicativo na instância do Azure Spring Apps que você deseja mapear. Use as seguintes etapas para localizar os endereços IP:

Portal do Azure

1. Navegue até a rede virtual que você criou para uma instância do Azure Spring Apps e selecione Dispositivos conectados no painel de navegação.

2. Na página Dispositivos conectados, procure por kubernetes-internal.

3. Nos resultados da pesquisa, localize cada Dispositivo conectado a uma Sub-rede de tempo de execução de serviço de uma instância de serviço do Azure Spring Apps e copie seu Endereço IP. No exemplo de captura de tela a seguir, o endereço IP de azure-spring-apps-1 is 10.1.0.6, e o endereço IP de azure-spring-apps-2 is 10.1.2.6.

   

CLI do Azure

1. Use os comandos a seguir para definir variáveis para sua assinatura, grupo de recursos, instância do Azure Spring Apps e rede virtual. Personalize os valores com base no seu ambiente.

   export SUBSCRIPTION='<subscription-ID>'
   export RESOURCE_GROUP='<resource-group-name>'
   export AZURE_SPRING_APPS_NAME='<Azure-Spring-Apps-instance-name>'
   export VIRTUAL_NETWORK_NAME='<Azure-Spring-Apps-VNET-name>'
   

2. Use os seguintes comandos para definir as variáveis para o tempo de execução do serviço, grupo de recursos de rede e o endereço IP:

   export SERVICE_RUNTIME_RG=$(az spring show \
       --resource-group $RESOURCE_GROUP \
       --name $AZURE_SPRING_APPS_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)
   

Criar uma zona DNS privada

Use as etapas a seguir para criar uma zona DNS privada para um aplicativo na rede privada.

Nota

Se você estiver usando o Microsoft Azure operado pela 21Vianet, substitua private.azuremicroservices.io por private.microservices.azure.cn neste artigo. Para obter mais informações, consulte Verificar pontos de extremidade no Azure.

Portal do Azure

1. Na Home page do Azure, procure zonas DNS privadas.

2. Na página Zonas DNS privadas, selecione Criar.

3. Preencha o formulário na página Criar zona DNS privada. Em Detalhes da instância para Nome, especifique private.azuremicroservices.io como o nome da zona DNS privada.

4. Selecione Rever criar.

5. Selecione Criar.

CLI do Azure

1. Use os seguintes comandos para entrar na CLI do Azure e definir sua assinatura ativa:

   az login
   az account set --subscription ${SUBSCRIPTION}
   

2. Use o seguinte comando para criar a zona DNS privada.

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

A criação da zona pode demorar alguns minutos.

Ligar a rede virtual

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

Portal do Azure

Use as seguintes etapas para criar este link:

1. Navegue até a zona DNS privada que você criou chamada private.azuremicroservices.io. Pode haver vários com esse nome, portanto, determine o correto por seu grupo de recursos e assinatura.

2. No painel de navegação, selecione Ligações de rede virtual e, em seguida, selecione Adicionar.

3. Para o Nome do link, insira azure-spring-apps-dns-link.

4. Em Rede virtual, selecione a rede virtual criada para Pré-requisitos.

   

5. Selecione OK.

CLI do Azure

Use o seguinte comando para criar este link:

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

Atribuir um FQDN privado para seus aplicativos

Atribua um FQDN privado para seu aplicativo.

Portal do Azure

Use as seguintes etapas para atualizar seu aplicativo com um ponto de extremidade atribuído:

1. Navegue até a instância do Azure Spring Apps implantada em sua rede virtual e selecione Aplicativos no painel de navegação.

2. Selecione um aplicativo.

3. Selecione Atribuir ponto de extremidade para atribuir um FQDN privado ao seu aplicativo. A atribuição de um FQDN pode levar alguns minutos.

   

4. Repita estas etapas para cada aplicativo que você deseja mapear.

CLI do Azure

Use o comando a seguir para atualizar seu aplicativo com um ponto de extremidade atribuído. Personalize o valor do nome do seu aplicativo com base no seu ambiente real.

export SPRING_CLOUD_APP='<app-name>'
az spring app update \
    --resource-group $RESOURCE_GROUP \
    --name $SPRING_CLOUD_APP \
    --service $SPRING_CLOUD_NAME \
    --assign-endpoint true

Mapeamento de DNS com um FQDN fornecido pela Microsoft

Usando essa abordagem, você deve criar um registro DNS para cada aplicativo como um requisito ao usar o FQDN (nome de domínio totalmente qualificado) fornecido pela Microsoft. Para obter uma compreensão básica desse processo, consulte Acessar seu aplicativo em uma rede privada.

Quando um aplicativo em uma instância de serviço do Azure Spring Apps com ponto de extremidade atribuído é implantado na rede virtual, o ponto de extremidade é um FQDN privado. Por padrão, o nome de domínio totalmente qualificado é exclusivo para cada aplicativo em instâncias de serviço. O formato FQDN é <service-name>-<app-name>.private.azuremicroservices.io.

Criar registos DNS para todas as aplicações

Para usar a zona DNS privada para traduzir e resolver nomes DNS, você deve criar um registro do tipo "A" na zona para cada um dos seus aplicativos. Neste exemplo, o nome do aplicativo é hello-vnet e o nome da instância de serviço do Azure Springs Apps é azure-spring-apps-1.

Você precisa do endereço IP para cada aplicativo. Copie-o conforme descrito na seção Localizar o endereço IP do seu aplicativo de Acessar seu aplicativo em uma rede privada. Neste exemplo, o endereço IP é 10.1.0.6.

Portal do Azure

Use as seguintes etapas para criar um registro DNS:

1. Navegue até a zona DNS privada criada anteriormente: private.azuremicroservices.io

2. Selecione Conjunto de registos.

3. No painel Adicionar conjunto de registros, insira os valores da tabela a seguir.

   Definição	Valor
   Nome	azure-spring-apps-1-hello-vnet
   Type	A
   TTL	1
   Unidade de TTL	Horário
   Endereço IP	(colar da área de transferência)

4. Selecione OK.

   

CLI do Azure

Use o seguinte comando para criar um registro DNS:

az network private-dns record-set a add-record \
    --resource-group $RESOURCE_GROUP \
    --zone-name private.azuremicroservices.io \
    --record-set-name 'azure-spring-apps-1-hello-vnet' \
    --ipv4-address $IP_ADDRESS

Repita estas etapas conforme necessário para adicionar um registro DNS para outros aplicativos.

Mapeamento de DNS com um domínio personalizado

Usando essa abordagem, você só precisa adicionar um registro DNS para cada instância do Azure Spring Apps, mas deve configurar o domínio personalizado para cada aplicativo. Para obter uma compreensão básica desse processo, consulte Mapear um domínio personalizado existente para o Azure Spring Apps.

Este exemplo reutiliza a zona private.azuremicroservices.io DNS privada para adicionar um registro DNS personalizado relacionado ao domínio. O FQDN privado tem o formato <app-name>.<service-name>.private.azuremicroservices.io.

Tecnicamente, você pode usar qualquer nome de domínio privado totalmente qualificado que desejar. Nesse caso, tem de criar uma nova zona DNS privada correspondente ao nome de domínio totalmente qualificado que escolher.

Mapeie seu domínio personalizado para um aplicativo em uma instância do Azure Spring Apps

Use as seguintes etapas para mapear seu domínio personalizado para cada um dos aplicativos na instância do Azure Spring Apps:

Portal do Azure

1. Abra a instância do Azure Spring Apps e selecione Aplicativos no painel de navegação.

2. Na página Aplicativos, selecione um aplicativo.

3. Selecione Domínio personalizado no painel de navegação.

4. Selecione Adicionar domínio personalizado.

5. No painel Adicionar domínio personalizado, insira o FQDN que você deseja usar e verifique se ele corresponde ao certificado a ser usado para vinculação TLS/SSL mais tarde. Este exemplo utiliza hello-vnet.azure-spring-apps-1.private.azuremicroservices.io. Você pode ignorar a parte CNAME.

6. Selecione Validar.

7. Se validado, selecione Adicionar.

   

Quando o domínio personalizado é mapeado com êxito para o aplicativo, ele aparece na tabela de domínio personalizado.

CLI do Azure

1. Use o seguinte comando para vincular um domínio personalizado a um aplicativo:

   az spring app custom-domain bind \
       --resource-group <resource-group-name> \
       --service <Azure-Spring-Apps-instance-name> \
       --domain-name <fqdn-domain-name> \
       --app <app-name>
   

2. Use o seguinte comando para listar todos os domínios personalizados de um aplicativo:

   az spring app custom-domain list \
       --resource-group <resource-group-name> \
       --service <Azure-Spring-Apps-instance-name> \
       --app <app-name> \
   

Nota

Um valor de estado TLS/SSL de Não Seguro para seu domínio personalizado significa que ele ainda não está vinculado a um certificado TLS/SSL. Qualquer solicitação HTTPS de um navegador para seu domínio personalizado receberá um erro ou aviso.

Adicionar ligação TLS/SSL

Antes de executar esta etapa, verifique se você preparou seus certificados e os importou para o Azure Spring Apps. Para obter mais informações, consulte Mapear um domínio personalizado existente para o Azure Spring Apps.

Portal do Azure

Use as seguintes etapas para atualizar o domínio personalizado de um aplicativo com um certificado:

1. Abra a instância do Azure Spring Apps e selecione Aplicativos no painel de navegação.

2. Na página Aplicativos, selecione um aplicativo.

3. Selecione Domínio personalizado no painel de navegação.

4. Selecione o botão de reticências (...) para um domínio personalizado e, em seguida, selecione Vincular TLS/SSL.

5. No painel de vinculação TLS/SSL, selecione Certificado e, em seguida, selecione ou importe o certificado.

6. Selecione Guardar.

   

Depois de adicionar com êxito a ligação TLS/SSL, o estado do domínio será seguro, conforme mostrado por um valor de estado TLS/SSL íntegro.

CLI do Azure

Use o seguinte comando para atualizar o domínio personalizado de um aplicativo com um certificado:

az spring app custom-domain update \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --domain-name <domain-name> \
    --certificate <cert-name> \
    --app <app-name> 

Configurar o domínio personalizado para todos os aplicativos

Para usar a zona DNS privada para traduzir e resolver nomes DNS, você deve criar um registro do tipo "A" na zona para cada uma das suas instâncias de serviço do Azure Spring Apps. Neste exemplo, o nome do aplicativo é hello-vnet e o nome da instância de serviço do Azure Springs Apps é azure-spring-apps-1.

Você precisa do endereço IP para cada aplicativo. Copie-o conforme descrito na seção Localizar o endereço IP do seu aplicativo de Acessar seu aplicativo em uma rede privada. Neste exemplo, o endereço IP é 10.1.0.6.

Portal do Azure

Use as seguintes etapas para criar o registro A em sua zona DNS:

1. Navegue até a zona DNS privada criada anteriormente: private.azuremicroservices.io

2. Selecione Conjunto de registos.

3. No painel Adicionar conjunto de registros, insira os valores da tabela a seguir.

   Definição	Valor
   Nome	*.azure-spring-apps-1
   Type	A
   TTL	1
   Unidade de TTL	Horário
   Endereço IP	(colar da área de transferência)

4. Selecione OK.

   

CLI do Azure

Use o seguinte comando 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 '*.azure-spring-apps-1' \
    --ipv4-address $IP_ADDRESS

Repita conforme necessário para configurar o domínio personalizado para outros aplicativos.

Acessar FQDN privado para aplicativos

Após as atribuições de FQDN e mapeamentos de DNS para ambas as abordagens, você pode acessar o FQDN privado de todos os aplicativos na rede privada. Por exemplo, você pode criar uma jumpbox ou máquina virtual na mesma rede virtual ou em uma rede virtual emparelhada e ter acesso a todos os FQDNs privados dos aplicativos.

Os exemplos a seguir mostram a abordagem FQDN:

• https://hello-vnet.azure-spring-apps-1.private.azuremicroservices.io
• https://hello-vnet.azure-spring-apps-2.private.azuremicroservices.io

Os exemplos a seguir mostram a abordagem de domínio personalizado:

• https://azure-spring-apps-1-hello-vnet.private.azuremicroservices.io
• https://azure-spring-apps-2-hello-vnet.private.azuremicroservices.io

A captura de tela a seguir mostra a URL de um aplicativo Spring usando um FQDN:

A captura de tela a seguir mostra a URL de um aplicativo Spring usando um domínio personalizado:

Clean up resources (Limpar recursos)

Se você planeja continuar trabalhando com artigos subsequentes, convém deixar esses recursos no lugar. Quando não for mais necessário, 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

Próximos passos

• Implantar o Azure Spring Apps em sua rede virtual do Azure (injeção de VNet)
• Aceda à sua aplicação numa rede privada