Accedere a un'app in App Spring di Azure in una rete virtuale

Nota

I piani Basic, Standard ed Enterprise saranno deprecati a partire dalla metà di marzo 2025, con un periodo di ritiro di 3 anni. È consigliabile eseguire la transizione ad App Azure Container. Per altre informazioni, vedere l'annuncio di ritiro di Azure Spring Apps.

Il piano Standard a consumo e dedicato sarà deprecato a partire dal 30 settembre 2024, con un arresto completo dopo sei mesi. È consigliabile eseguire la transizione ad App Azure Container. Per altre informazioni, vedere Eseguire la migrazione del consumo di Azure Spring Apps Standard e del piano dedicato alle app Azure Container.

Questo articolo si applica a: ✔️ Basic/Standard ✔️ Enterprise

Questo articolo illustra come accedere a un endpoint per l'applicazione in una rete privata.

Quando si assegna un endpoint in un'applicazione in un'istanza del servizio Azure Spring Apps distribuita nella rete virtuale, l'endpoint usa un nome di dominio completo (FQDN) privato. Il dominio è accessibile solo nella rete privata. Le app e i servizi usano l'endpoint dell'applicazione. Includono l'endpoint di test descritto nella sezione Visualizzare app e distribuzioni di Configurare un ambiente di gestione temporanea in Azure Spring Apps. Lo streaming dei log, descritto in Stream Azure Spring Apps app logs in real-time, funziona anche solo all'interno della rete privata.

Sono disponibili le due opzioni seguenti per rendere accessibile l'endpoint assegnato:

• Creare la propria zona DNS (Domain Name Service) privata e collegarla ad Azure Spring Apps. Questo metodo è altamente consigliato perché Azure Spring Apps collega automaticamente la zona DNS alla rete virtuale e gestisce il record DNS per l'endpoint dell'applicazione.

• Creare la propria zona DNS privata e gestire manualmente il collegamento di rete virtuale e i record DNS, seguendo le istruzioni per individuare l'indirizzo IP di Load Balancer (LB) dell'istanza del servizio Azure Spring Apps.

Prerequisiti

• Una sottoscrizione di Azure. Se non si ha già una sottoscrizione, creare un account gratuito prima di iniziare.
• (Facoltativo) Interfaccia della riga di comando di Azure versione 2.45.0 o successiva.
• Un'applicazione esistente in un'istanza del servizio Azure Spring Apps distribuita in una rete virtuale. Per altre informazioni, vedere Distribuire Azure Spring Apps in una rete virtuale.

Creare una zona DNS privato

Azure portal

Usare la procedura seguente per creare una zona DNS privata per un'applicazione nella rete privata:

1. Apri il portale di Azure. Usando la casella di ricerca, cercare DNS privato zone. Selezionare DNS privato zone nei risultati della ricerca.

2. Nella pagina DNS privato zone selezionare Aggiungi.

3. Compilare il modulo nella pagina Crea area DNS privato. In Nome immettere private.azuremicroservices.io.

4. Selezionare Rivedi e crea.

5. Seleziona Crea.

Interfaccia della riga di comando di Azure

Usare il comando seguente per creare la zona DNS privata:

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

La creazione della zona può richiedere alcuni minuti.

Configurare la zona DNS privata per gestire automaticamente gli endpoint

Dopo aver creato una zona DNS privata, è possibile usare Azure Spring Apps per gestire le zone DNS private. Questo approccio semplifica il processo di gestione dei collegamenti di rete virtuale e dei record DNS. Questo approccio è particolarmente utile negli ambienti con più istanze all'interno di una singola rete virtuale o in ambienti che usano peering di rete virtuale. Azure Spring Apps automatizza la gestione dei collegamenti di rete virtuale e l'aggiunta o la rimozione dinamica dei record DNS "A" man mano che gli endpoint vengono assegnati o non assegnati.

Nota

Azure Spring Apps non gestisce automaticamente gli endpoint assegnati prima dell'aggiunta della zona DNS privata. Per abilitare la gestione dei record DNS per questi endpoint, annullare l'assegnazione e quindi riassegnare gli endpoint.

Concedere l'autorizzazione alla zona DNS privata

Azure portal

Per concedere l'autorizzazione, seguire questa procedura:

1. Selezionare la risorsa zona DNS privata creata, ad esempio private.azuremicroservices.io.

2. Selezionare Controllo di accesso (IAM) e quindi Aggiungi>Aggiungi assegnazione di ruolo.

   

3. Assegnare il Private DNS Zone Contributor ruolo al provider di risorse di Azure Spring Apps. Per ulteriori informazioni, vedi Assegnare ruoli di Azure usando il portale di Azure.

   Nota

   Se non si trova il provider di risorse di Azure Spring Apps, cercare Azure Spring Cloud Resource Provider.

   

Interfaccia della riga di comando di Azure

Usare i comandi seguenti per concedere l'autorizzazione:

export PRIVATE_DNS_ZONE_RESOURCE_ID=$(az network private-dns zone show \
    --resource-group $RESOURCE_GROUP \
    --name $PRIVATE_DNS_ZONE_NAME \
    --query "id" \
    --output tsv)

az role assignment create \
    --role "Private DNS Zone Contributor" \
    --scope ${PRIVATE_DNS_ZONE_RESOURCE_ID} \
    --assignee e8de9221-a19c-4c81-b814-fd37c6caf9d2

L'argomento --assignee rappresenta l'entità servizio usata da Azure Spring Apps per interagire con la zona DNS privata del cliente.

Collegare la zona DNS privata ad Azure Spring Apps

Per collegare la zona DNS privata all'istanza del servizio Azure Spring Apps, usare l'interfaccia della riga di comando di Azure. Questo passaggio prevede la specifica del gruppo di risorse, del nome dell'istanza di Azure Spring Apps e dell'ID risorsa della zona DNS privata.

Usare il comando seguente per configurare la zona DNS privata con Azure Spring Apps. Questa configurazione consente ad Azure Spring Apps di creare automaticamente un collegamento di rete virtuale nella zona DNS privata e gestire l'aggiunta o la rimozione di record DNS "A" come endpoint assegnati o non assegnati.

az spring private-dns-zone add \
    --resource-group $RESOURCE_GROUP \
    --service $AZURE_SPRING_APPS_INSTANCE_NAME \
    --zone-id $PRIVATE_DNS_ZONE_RESOURCE_ID

Se si vuole scollegare l'istanza di Azure Spring Apps dalla zona DNS privata e arrestare la gestione automatica dei record DNS "A", è possibile pulire la configurazione. Usare il comando seguente per pulire la zona DNS privata configurata con Azure Spring Apps:

az spring private-dns-zone clean \
    --resource-group $RESOURCE_GROUP \
    --service $AZURE_SPRING_APPS_INSTANCE_NAME

Configurare manualmente la zona DNS privata

Se si preferisce avere il controllo completo sulla zona DNS privata, le sezioni seguenti illustrano come configurarla manualmente.

Trovare l'indirizzo IP per l'applicazione

Azure portal

Usare la procedura seguente per trovare l'indirizzo IP per l'applicazione:

1. Passare alla pagina Rete del servizio Azure Spring Apps.

2. Selezionare la scheda Inserimento rete virtuale.

3. Nella sezione Informazioni generali trovare Endpoint e copiare il valore dell'indirizzo IP. L'esempio nello screenshot seguente usa l'indirizzo 10.0.1.6IP :

   

Interfaccia della riga di comando di Azure

Seguire questa procedura per inizializzare l'ambiente locale e trovare l'indirizzo IP per l'applicazione.

1. Usare i comandi seguenti per definire varie variabili di ambiente. Assicurarsi di sostituire i segnaposto con i propri valori effettivi.

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

2. Usare i comandi seguenti per accedere all'interfaccia della riga di comando di Azure e scegliere la sottoscrizione attiva:

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

3. Usare i comandi seguenti per trovare l'indirizzo IP per l'applicazione.

   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
   

Aggiungere un DNS per l'indirizzo IP

Se si ha una soluzione DNS personalizzata per la rete virtuale, ad esempio Dominio di Active Directory Controller, Infoblox o un altro, è necessario puntare il dominio *.private.azuremicroservices.io all'indirizzo IP. In caso contrario, usare le istruzioni seguenti per creare un'area di DNS privato di Azure nella sottoscrizione per convertire/risolvere il nome di dominio completo privato nel relativo indirizzo IP.

Nota

Se si usa Microsoft Azure gestito da 21Vianet, assicurarsi di sostituire private.azuremicroservices.io con private.microservices.azure.cn in questo articolo. Per altre informazioni, vedere la sezione Controllare gli endpoint in Azure della guida per sviluppatori di Azure Cina.

Creare il record DNS

È necessario creare un record di tipo "A" nella zona DNS privata.

Azure portal

Usare la procedura seguente per usare la zona DNS privata per tradurre/risolvere IL DNS:

1. Selezionare la risorsa zona DNS privata creata, ad esempio private.azuremicroservices.io.

2. Selezionare Set di record.

3. In Aggiungi set di record immettere o selezionare le informazioni seguenti:

   Impostazione	valore
   Nome	Immetti *.
   Type	selezionare A.
   TTL	Immettere 1.
   Unità TTL	selezionare Ore.
   Indirizzo IP	Immettere l'indirizzo IP. Lo screenshot seguente usa l'indirizzo IP 10.1.0.7.

   

4. Seleziona OK.

Interfaccia della riga di comando di Azure

Usare il comando seguente per creare il record "A" nella 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

Collegare la zona DNS privata a una rete virtuale

Per collegare la zona DNS privata alla rete virtuale, è necessario creare un collegamento di rete virtuale.

Azure portal

Usare la procedura seguente per collegare la zona DNS privata creata alla rete virtuale che contiene il servizio Azure Spring Apps:

1. Selezionare la risorsa zona DNS privata creata, ad esempio private.azuremicroservices.io.

2. Selezionare Collegamenti di rete virtuale e quindi Aggiungi.

3. Per Nome collegamento immettere azure-spring-apps-dns-link.

4. In Rete virtuale selezionare la rete virtuale creata in precedenza.

   

5. Seleziona OK.

Interfaccia della riga di comando di Azure

Usare il comando seguente per collegare la zona DNS privata creata alla rete virtuale che contiene il servizio 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

Assegnare un nome di dominio completo privato per l'applicazione

Dopo aver configurato la zona DNS privato e distribuito Azure Spring Apps in una rete virtuale, è possibile assegnare un nome di dominio completo privato per l'applicazione. Per altre informazioni, vedere Distribuire Azure Spring Apps in una rete virtuale.

Azure portal

Per assegnare un nome di dominio completo privato, seguire questa procedura:

1. Selezionare l'istanza del servizio Azure Spring Apps distribuita nella rete virtuale e aprire la scheda App .

2. Selezionare l'applicazione per aprire la pagina Panoramica .

3. Selezionare Assegna endpoint per assegnare un nome di dominio completo privato all'applicazione. L'assegnazione di un nome di dominio completo può richiedere alcuni minuti.

   

4. L'FQDN privato assegnato (URL etichettato) è ora disponibile. È possibile accedere all'URL solo all'interno della rete privata, ma non in Internet.

Interfaccia della riga di comando di Azure

Usare il comando seguente per assegnare un endpoint all'applicazione:

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

Accedere al nome di dominio completo privato dell'applicazione

Dopo l'assegnazione, è possibile accedere al nome di dominio completo privato dell'applicazione nella rete privata. Ad esempio, è possibile creare una macchina jumpbox nella stessa rete virtuale o in una rete virtuale con peering. Quindi, in tale jumpbox o macchina virtuale, è possibile accedere al nome di dominio completo privato.

Pulire le risorse

Se si prevede di continuare a usare gli articoli successivi, è possibile lasciare queste risorse. Quando non sono più necessari, eliminare il gruppo di risorse, che elimina le risorse nel gruppo di risorse. Per eliminare il gruppo di risorse usando l'interfaccia della riga di comando di Azure, usare il comando seguente:

az group delete --name $RESOURCE_GROUP

Passaggi successivi

• Esporre applicazioni con TLS end-to-end in una rete virtuale
• Risoluzione dei problemi relativi ad Azure Spring Apps nelle reti virtuali
• Responsabilità del cliente per l'esecuzione di Azure Spring Apps in una rete virtuale