Condividi tramite


Opzioni di rete di Funzioni di Azure

Questo articolo descrive le funzionalità di rete disponibili nelle opzioni di hosting per Funzioni di Azure. Le opzioni di rete seguenti possono essere classificate come funzionalità di rete in ingresso e in uscita. Le funzionalità in ingresso consentono di limitare l'accesso all'app, mentre le funzionalità in uscita consentono di connettere l'app alle risorse protette da una rete virtuale e controllare il modo in cui viene instradato il traffico in uscita.

Nei modelli di hosting sono disponibili diversi livelli di isolamento della rete. La scelta dell'opzione corretta consente di soddisfare i requisiti di isolamento della rete.

Funzionalità Piano A consumo Flex Piano a consumo Piano Premium Piano Dedicato/ambiente del servizio app Appcontenitore 1
Restrizioni IP in ingresso
Endpoint privati in ingresso
Integrazione della rete virtuale numero arabo 3
Restrizioni IP in uscita
  1. Per altre informazioni, vedere Reti nell'ambiente App contenitore di Azure.
  2. Quando si lavora con i trigger di rete virtuale, è necessario tenere presenti considerazioni speciali.
  3. Solo il piano dedicato/ambiente del servizio app supporta l'integrazione della rete virtuale richiesta dal gateway.

Risorse di avvio rapido

Usare le risorse seguenti per iniziare rapidamente a usare gli scenari di rete di Funzioni di Azure. Queste risorse vengono a cui si fa riferimento in tutto l'articolo.

Funzionalità di rete in ingresso

Le funzionalità seguenti consentono di filtrare le richieste in ingresso all'app per le funzioni.

Restrizioni di accesso in ingresso

È possibile usare le restrizioni di accesso per definire un elenco in ordine di priorità di indirizzi IP ai quali è consentito o negato l'accesso all'app. L'elenco può includere indirizzi IPv4 e IPv6 o subnet di rete virtuale specifiche usando gli endpoint di servizio. In presenza di una o più voci, alla fine dell'elenco è presente un'istruzione di tipo "rifiuta tutto" implicita. Le restrizioni IP funzionano con tutte le opzioni di hosting di funzioni.

Le restrizioni di accesso sono disponibili nel piano A consumo Flex, Elastico Premium, Consumo e Servizio app.

Nota

Con le restrizioni di rete implementate, è possibile distribuire solo dall'interno della rete virtuale o quando l'indirizzo IP del computer usato per accedere al portale di Azure è stato inserito nell'elenco dei destinatari sicuri. Tuttavia, è comunque possibile gestire la funzione usando il portale.

Per altre informazioni, vedere Restrizioni di accesso al servizio app di Azure.

Endpoint privati

L'endpoint privato di Azure è un'interfaccia di rete che si connette in modo privato e sicuro a un servizio basato sul collegamento privato di Azure. L'endpoint privato usa un indirizzo IP privato della rete virtuale, portando il servizio nella rete virtuale in modo efficace.

È possibile usare endpoint privato per le funzioni ospitate nei piani Flex Consumption, Elastic Premium e Dedicated (servizio app).

Se si desidera effettuare chiamate a endpoint privati, è necessario assicurarsi che le ricerche DNS vengano risolte nell'endpoint privato. È possibile applicare questo comportamento in uno dei modi seguenti:

  • Eseguire l'integrazione con zone private di DNS di Azure. Quando la rete virtuale non ha un server DNS personalizzato, questa operazione viene eseguita automaticamente.
  • Gestire l'endpoint privato nel server DNS usato dall'app. Per gestire un endpoint privato, è necessario conoscere l'indirizzo dell'endpoint e usare un record A per fare riferimento all'endpoint che si sta tentando di raggiungere.
  • Configurare il proprio server DNS per l'inoltro alle zone private DNS di Azure.

Per altre informazioni, vedere Uso di endpoint privati per App Web.

Per chiamare altri servizi che dispongono di una connessione endpoint privato, ad esempio archiviazione o bus di servizio, assicurarsi di configurare l'app per effettuare chiamate in uscita agli endpoint privati. Per altre informazioni sull'uso di endpoint privati con l'account di archiviazione per l'app per le funzioni, vedere Limitare l'account di archiviazione a una rete virtuale.

Endpoint di servizio

Usando gli endpoint di servizio, è possibile limitare molti servizi di Azure alle subnet di rete virtuale selezionate per offrire un livello di sicurezza superiore. L'integrazione della rete virtuale a livello di area consente all'app per le funzioni di raggiungere i servizi di Azure protetti con gli endpoint di servizio. Questa configurazione è supportata in tutti i piani che supportano l'integrazione della rete virtuale. Per accedere a un endpoint di servizio protetto, seguire questa procedura:

  1. Configurare l'integrazione della rete virtuale a livello di area con l'app per le funzioni per connettersi a una subnet specifica.
  2. Passare al servizio di destinazione e configurare gli endpoint servizio nella subnet di integrazione.

Per altre informazioni, vedere Endpoint servizio di rete virtuale.

Usare endpoint di servizio

Per limitare l'accesso a una subnet specifica, creare una regola di restrizione con un tipo di rete virtuale. È quindi possibile selezionare la sottoscrizione, la rete virtuale e la subnet a cui si vuole consentire o negare l'accesso.

Se gli endpoint di servizio non sono già abilitati con Microsoft.Web per la subnet selezionata, vengono abilitati automaticamente, a meno che non si selezioni la casella di controllo Ignora endpoint servizio Microsoft.Web mancanti. Lo scenario in cui è possibile abilitare gli endpoint di servizio nell'app, ma non la subnet dipende principalmente dal fatto che si disponga delle autorizzazioni per abilitarle nella subnet.

Se è necessario che un altro utente abiliti gli endpoint di servizio nella subnet, selezionare la casella di controllo Ignora endpoint servizio Microsoft.Web mancanti. L'app è configurata per gli endpoint di servizio, che verranno abilitati in un secondo momento nella subnet.

Screenshot del riquadro

Non è possibile usare gli endpoint di servizio per limitare l'accesso alle app eseguite in un ambiente del servizio app. Quando l'app si trova in un ambiente del servizio app, è possibile controllarne l'accesso applicando le regole di accesso IP.

Per informazioni su come configurare gli endpoint di servizio, vedere Stabilire l'accesso al sito privato di Funzioni di Azure.

Funzionalità di rete in uscita

È possibile usare le funzionalità di questa sezione per gestire le connessioni in uscita effettuate dall'app.

Integrazione della rete virtuale

Questa sezione descrive in dettaglio le funzionalità supportate da Funzioni per controllare i dati in uscita dall'app.

L'integrazione della rete virtuale consente all'app per le funzioni di accedere alle risorse nella rete virtuale. Dopo l'integrazione, l'app instrada il traffico in uscita attraverso la rete virtuale. Ciò consente all'app di accedere a endpoint privati o risorse con regole che consentono il traffico solo da subnet selezionate. Quando la destinazione è un indirizzo IP all'esterno della rete virtuale, l'INDIRIZZO IP di origine verrà comunque inviato da uno degli indirizzi elencati nelle proprietà dell'app, a meno che non sia stato configurato un gateway NAT.

Funzioni di Azure supporta due tipi di integrazione della rete virtuale:

Per informazioni su come configurare l'integrazione della rete virtuale, vedere Abilitare l'integrazione della rete virtuale.

Integrazione della rete virtuale regionale

L'uso dell'integrazione della rete virtuale a livello di area consente all'app di accedere:

  • Risorse nella stessa rete virtuale dell'app.
  • Le risorse nelle reti virtuali con peering alla rete virtuale con cui l'app è integrata.
  • Servizi protetti con endpoint di servizio.
  • Risorse nelle connessioni Azure ExpressRoute.
  • Risorse nelle connessioni con peering, tra cui le connessioni Azure ExpressRoute.
  • Endpoint privati

Quando si usa l'integrazione della rete virtuale a livello di area, è possibile usare le funzionalità di rete di Azure seguenti:

  • Gruppi di sicurezza di rete: è possibile bloccare il traffico in uscita con un gruppo di sicurezza di rete posizionato nella subnet di integrazione. Le regole in ingresso non si applicano perché non è possibile usare l'integrazione rete virtuale per consentire l'accesso in ingresso all'app.
  • Tabelle di route (route definite dall'utente): è possibile inserire una tabella di route nella subnet di integrazione per inviare il traffico in uscita in cui si vuole.

Nota

Quando si instrada tutto il traffico in uscita alla rete virtuale, è soggetto ai gruppi di sicurezza di rete e alle route definite dall'utente applicate alla subnet di integrazione. Quando la rete virtuale è integrata, il traffico in uscita dell'app per le funzioni verso gli indirizzi IP pubblici viene comunque inviato dagli indirizzi elencati nelle proprietà dell'app, a meno che non si forniscano route che indirizzano il traffico altrove.

L'integrazione della rete virtuale a livello di area non è in grado di usare la porta 25.

Considerazioni per il piano Flex Consumption :

  • Assicurarsi che il provider di risorse di Azure Microsoft.App sia abilitato per la sottoscrizione seguendo queste istruzioni. Questa operazione è necessaria per la delega della subnet.
  • La delega della subnet richiesta durante l'esecuzione in un piano a consumo flessibile è Microsoft.App/environments. Ciò differisce dai piani Elastic Premium e Dedicated (servizio app), che hanno un requisito di delega diverso.
  • È possibile pianificare l'uso massimo di 40 indirizzi IP per un'app per le funzioni, anche se l'app può utilizzarne più di 40. Ad esempio, se nella stessa subnet sono integrate 15 app per le funzioni Flex Consumption, è necessario pianificare 15x40 = 600 indirizzi IP usati al massimo. Questo limite è soggetto a modifiche e non viene applicato.
  • La subnet non può essere già usata per altri scopi, ad esempio con endpoint privati o endpoint di servizio, oppure essere delegata a qualsiasi altro piano di hosting o servizio. Sebbene sia possibile condividere la stessa subnet con più app Flex Consumption, le risorse di rete vengono condivise tra queste app per le funzioni, che possono causare un'app che influisce sulle prestazioni di altri nella stessa subnet.

Considerazioni sui piani Elastic Premium, Dedicato (servizio app) e App contenitore:

  • La funzionalità è disponibile per Elastic Premium e servizio app Premium V2 e Premium V3. È disponibile anche in Standard, ma solo dalle distribuzioni più recenti del servizio app. Se si usa una distribuzione precedente, è possibile usare solo la funzionalità di un piano di servizio app Premium V2. Se si vuole assicurarsi di poter usare la funzionalità in un piano di servizio app Standard, creare l'app in un piano di servizio app Premium V3. Questi piani sono supportati solo nelle versioni più recenti. Se lo si desidera, è possibile ridurre le prestazioni.
  • La funzionalità non può essere usata dalle app del piano isolato che si trovano in un ambiente del servizio app.
  • L'app e la rete virtuale devono essere nella stessa area.
  • La funzionalità richiede una subnet inutilizzata che sia /28 o superiore in una rete virtuale di Azure Resource Manager.
  • La subnet di integrazione può essere usata da un solo piano di servizio app.
  • Per un piano Servizio app è possibile avere fino a due integrazioni di rete virtuale a livello di area. Più app nello stesso piano di servizio app possono usare la stessa subnet di integrazione.
  • Non è possibile eliminare una rete virtuale con un'app integrata. Rimuovere l'integrazione prima di eliminare la rete virtuale.
  • Non è possibile modificare la sottoscrizione di un'app o un piano mentre è presente un'app che usa l'integrazione della rete virtuale a livello di area.

Abilitare l'integrazione della rete virtuale

  1. Nell'app per le funzioni nel portale di Azure selezionare Rete, quindi in Integrazione rete virtuale selezionare Fare clic qui per configurare.

  2. Selezionare Add VNet (Aggiungi rete virtuale).

    Screenshot della pagina Integrazione rete virtuale in cui è possibile abilitare l'integrazione della rete virtuale nell'app.

  3. L'elenco a discesa contiene tutte le reti virtuali di Azure Resource Manager della sottoscrizione nella stessa area. Selezionare la rete virtuale che si desidera integrare.

    Selezionare la rete virtuale

    • I piani di hosting Flex Consumption e Elastic Premium supportano solo l'integrazione della rete virtuale a livello di area. Se la rete virtuale si trova nella stessa area, creare una nuova subnet o selezionare una subnet vuota preesistente.

    • Per selezionare una rete virtuale in un'altra area, è necessario disporre di un gateway di rete virtuale di cui è stato effettuato il provisioning con il punto al sito abilitato. L'integrazione della rete virtuale tra aree è supportata solo per i piani dedicati, ma i peering globali funzionano con l'integrazione della rete virtuale a livello di area.

Durante l'integrazione, l'app viene riavviata. Al termine dell'integrazione, vengono visualizzati i dettagli sulla rete virtuale con cui si è integrati. Per impostazione predefinita, Route All è abilitato e tutto il traffico viene instradato nella rete virtuale.

Se si preferisce instradare solo il traffico privato (RFC1918 traffico), seguire la procedura descritta in questo articolo servizio app.

Subnet

L'integrazione della rete virtuale dipende da una subnet dedicata. Quando si effettua il provisioning di una subnet, la subnet di Azure perde cinque indirizzi IP dall'inizio. Per i piani Elastico Premium e Servizio app, viene usato un solo indirizzo dalla subnet di integrazione per ogni istanza del piano. Quando si ridimensiona l'app a quattro istanze, vengono usati quattro indirizzi. Per Flex Consumption questo non si applica e le istanze condividono gli indirizzi IP.

Nei piani Elastic Premium e Dedicated (servizio app), lo spazio degli indirizzi richiesto viene raddoppiato per un breve periodo di tempo quando si aumenta o si aumentano le dimensioni dell'istanza. Ciò influisce sulle istanze supportate reali e disponibili per una determinata dimensione della subnet. La tabella seguente illustra sia gli indirizzi disponibili massimi per ogni blocco CIDR che l'effetto che ha sulla scala orizzontale:

Dimensioni del blocco CIDR Numero massimo di indirizzi disponibili Scala orizzontale massima (istanze)*
/28 11 5
/27 27 13
/26 59 29

*Si presuppone che sia necessario aumentare o ridurre le dimensioni o lo SKU a un certo punto.

Poiché le dimensioni della subnet non possono essere modificate dopo l'assegnazione, usare una subnet sufficientemente grande per supportare qualsiasi ridimensionare l'app. Per evitare problemi con la capacità della subnet per i piani Elastico Premium di Funzioni, è consigliabile usare /24 con 256 indirizzi per Windows e /26 con 64 indirizzi per Linux. Quando si creano subnet nel portale di Azure come parte dell'integrazione con la rete virtuale, è necessaria rispettivamente una dimensione minima di /24 e /26 per Windows e Linux.

Il piano Flex Consumption consente a più app in esecuzione nel piano Flex Consumption di integrarsi con la stessa subnet. Questo non è il caso per i piani di hosting Elastic Premium e Dedicated (servizio app). Questi piani consentono solo la connessione di due reti virtuali con ogni piano di servizio app. Più app da un singolo piano di servizio app possono essere aggiunte alla stessa subnet, ma le app di un piano diverso non possono usare la stessa subnet.

La funzionalità è completamente supportata per le app Windows e Linux, inclusi i contenitori personalizzati. Tutti i comportamenti funzionano allo stesso modo tra le app di Windows e le app Linux.

Gruppi di sicurezza di rete

È possibile usare i gruppi di sicurezza di rete per controllare il traffico tra le risorse nella rete virtuale. Ad esempio, è possibile creare una regola di sicurezza che impedisce al traffico in uscita dell'app di raggiungere una risorsa nella rete virtuale o di uscire dalla rete. Queste regole di sicurezza si applicano alle app che hanno configurato l'integrazione della rete virtuale. Per bloccare il traffico verso indirizzi pubblici, è necessario avere l'integrazione della rete virtuale e Route All abilitata. Le regole in ingresso in un gruppo di sicurezza di rete non si applicano all'app perché l'integrazione della rete virtuale influisce solo sul traffico in uscita dall'app.

Per controllare il traffico in ingresso verso l'app, usare la funzionalità Restrizioni di accesso. Un gruppo di sicurezza di rete applicato alla subnet di integrazione è attivo indipendentemente dalle route applicate alla subnet di integrazione. Se l'app per le funzioni è integrata con Route All enabled e non sono presenti route che influiscono sul traffico degli indirizzi pubblici nella subnet di integrazione, tutto il traffico in uscita è comunque soggetto ai gruppi di sicurezza di rete assegnati alla subnet di integrazione. Quando Route All non è abilitato, i gruppi di sicurezza di rete vengono applicati solo al traffico RFC1918.

Route

È possibile usare le tabelle di route per instradare il traffico in uscita dall'app alla destinazione desiderata. Per impostazione predefinita, le tabelle di route influiscono solo sul traffico di destinazione RFC1918. Quando Route All è abilitato, tutte le chiamate in uscita sono interessate. Quando Route All è disabilitato, le tabelle di route influiscono solo sul traffico privato (RFC1918). Le route impostate nella subnet di integrazione non influiscono sulle risposte alle richieste di app in ingresso. Le destinazioni comuni possono includere dispositivi firewall o gateway.

Se si vuole instradare tutto il traffico in uscita in locale, è possibile usare una tabella di route per inviare tutto il traffico in uscita al gateway ExpressRoute. Se si instrada il traffico a un gateway, assicurarsi di impostare le route nella rete esterna per inviare eventuali risposte.

Le route BGP (Border Gateway Protocol) influiscono anche sul traffico dell'app. Se sono presenti route BGP da elementi come un gateway ExpressRoute, ciò influisce sul traffico in uscita dell'app. Per impostazione predefinita, le route BGP influiscono solo sul traffico di destinazione RFC1918. Quando l'app per le funzioni è integrata con Route All enabled, tutto il traffico in uscita può essere interessato dalle route BGP.

Restrizioni IP in uscita

Le restrizioni per gli IP in uscita sono disponibili in un piano A consumo Flex, Elastico Premium, Servizio app o Ambiente del Servizio app. È possibile configurare le restrizioni in uscita per la rete virtuale in cui è distribuito l'ambiente del servizio app.

Quando si integra un'app per le funzioni in un piano Elastico Premium o in un piano Servizio app con una rete virtuale, per impostazione predefinita l'app può comunque effettuare chiamate in uscita a Internet. Integrando l'app per le funzioni con una rete virtuale con Route All abilitata, si forza l'invio di tutto il traffico in uscita nella rete virtuale, in cui è possibile usare le regole del gruppo di sicurezza di rete per limitare il traffico. Per Flex Consumption tutto il traffico è già instradato attraverso la rete virtuale e Route All non è necessario.

Per informazioni su come controllare l'IP in uscita usando una rete virtuale, vedere Esercitazione: Controllare l'ip in uscita di Funzioni di Azure con un gateway NAT di rete virtuale di Azure.

Zone private di DNS di Azure

Dopo l'integrazione dell'app con la rete virtuale, usa lo stesso server DNS con cui è configurata la rete virtuale e funzionerà con le zone private DNS di Azure collegate alla rete virtuale.

Automazione

Le API seguenti consentono di gestire a livello di codice le integrazioni di rete virtuale a livello di codice:

  • Interfaccia della riga di comando di Azure: usare i comandi az functionapp vnet-integration per aggiungere, elencare o rimuovere un'integrazione di rete virtuale a livello di area.
  • Modelli di Resource Manager: l'integrazione della rete virtuale a livello di area può essere abilitata usando un modello di Azure Resource Manager. Per un esempio completo, vedere questo modello di avvio rapido di Funzioni.

Connessioni ibride

Le connessioni ibride sono una funzionalità di Inoltro di Azure che consente di accedere alle risorse dell'applicazione in altre reti. Il servizio fornisce l'accesso dall'app a un endpoint applicazione. Non è possibile usarla per accedere all'applicazione. Le connessioni ibride sono disponibili per le funzioni che vengono eseguite in Windows in tutte le versioni meno il Piano a consumo.

Come in Funzioni di Azure, ogni connessione ibrida è correlata a una singola combinazione di host e porta TCP. Questo significa che l'endpoint della connessione ibrida può trovarsi in qualsiasi sistema operativo e in qualsiasi applicazione, a condizione che si acceda a una porta TCP in ascolto. La funzionalità Connessioni ibride non conosce né deve conoscere qual è il protocollo dell'applicazione o a quale risorsa sta accedendo l'utente. Offre solo l'accesso alla rete.

Per altre informazioni, vedere la Documentazione del servizio app per le connessioni ibride. La stessa procedura di configurazione supporta Funzioni di Azure.

Importante

Le connessioni ibride sono supportate solo quando l'app per le funzioni viene eseguita in Windows. Le app Linux non sono supportate.

Connessione ai servizi di Azure tramite una rete virtuale

L'integrazione della rete virtuale consente all'app per le funzioni di accedere alle risorse in una rete virtuale. Questa sezione illustra gli aspetti da considerare quando si tenta di connettere l'app a determinati servizi.

Limitare l'account di archiviazione a una rete virtuale

Nota

Per distribuire rapidamente un'app per le funzioni con endpoint privati abilitati nell'account di archiviazione, vedere il modello seguente: App per le funzioni con endpoint privati di Archiviazione di Azure.

Quando si crea un'app per le funzioni, è necessario creare o collegare un account di archiviazione di Azure di uso generico che supporta l'archiviazione BLOB, Coda e Tabella. È possibile sostituire questo account di archiviazione con uno protetto con endpoint di servizio o endpoint privati.

È possibile usare un account di archiviazione con restrizioni di rete con app per le funzioni nei piani Flex Consumption, Elastic Premium e Dedicated (servizio app). Il piano a consumo non è supportato. Per i piani Elastic Premium e Dedicato, è necessario assicurarsi che il routing della condivisione contenuto privato sia configurato. Per informazioni su come configurare l'app per le funzioni con un account di archiviazione protetto con una rete virtuale, vedere Limitare l'account di archiviazione a una rete virtuale.

Usare i riferimenti di Key Vault

È possibile usare i riferimenti di Azure Key Vault per usare segreti di Azure Key Vault nell'applicazione Funzioni di Azure senza modificare il codice. Azure Key Vault è un servizio che fornisce una gestione centralizzata dei segreti, con controllo completo sui criteri di accesso e sulla cronologia dei controlli.

Se l'integrazione della rete virtuale è configurata per l'app, i riferimenti a Key Vault possono essere usati per recuperare i segreti da un insieme di credenziali con restrizioni di rete.

Trigger della rete virtuale (non HTTP)

Il carico di lavoro potrebbe richiedere che l'app venga attivata da un'origine evento protetta da una rete virtuale. Sono disponibili due opzioni se si vuole che l'app venga ridimensionata in modo dinamico in base al numero di eventi ricevuti da origini trigger non HTTP:

  • Eseguire l'app per le funzioni in un consumo flessibile.
  • Eseguire l'app per le funzioni in un piano Elastic Premium e abilitare il supporto del trigger di rete virtuale.

Le app per le funzioni in esecuzione nei piani dedicato (servizio app) non vengono ridimensionate in modo dinamico in base agli eventi. Invece, la scalabilità orizzontale dipende dalle regole di scalabilità automatica definite.

Piano Elastico Premium con trigger di rete virtuale

Il piano Elastic Premium consente di creare funzioni attivate dai servizi protetti da una rete virtuale. Questi trigger non HTTP sono noti come trigger di rete virtuale.

Per impostazione predefinita, i trigger di rete virtuale non causano la scalabilità dell'app per le funzioni oltre il numero di istanze preavviso. Tuttavia, alcune estensioni supportano trigger di rete virtuale che causano la scalabilità dinamica dell'app per le funzioni. È possibile abilitare questo monitoraggio della scalabilità dinamica nell'app per le funzioni per le estensioni supportate in uno dei modi seguenti:

  1. Nel portale di Azure passare all'app per le funzioni.

  2. In Impostazioni selezionare Configurazione, quindi nella scheda Impostazioni runtime funzione impostare Monitoraggio della scalabilità di runtime su .

  3. Selezionare Salva per aggiornare la configurazione dell'app per le funzioni e riavviare l'app.

VNETToggle

Suggerimento

L'abilitazione del monitoraggio dei trigger di rete virtuale può avere un impatto sulle prestazioni dell'applicazione, anche se questo impatto è probabilmente molto ridotto.

Il supporto per il monitoraggio a scalabilità dinamica dei trigger di rete virtuale non è disponibile nella versione 1.x del runtime di Funzioni.

Le estensioni in questa tabella supportano il monitoraggio della scalabilità dinamica dei trigger di rete virtuale. Per ottenere prestazioni di ridimensionamento ottimali, è consigliabile eseguire l'aggiornamento alle versioni che supportano anche il ridimensionamento basato sulla destinazione.

Estensione (versione minima) Solo monitoraggio della scalabilità di runtime Con Scalabilità basata su destinazione
Microsoft.Azure.WebJobs.Extensions.CosmosDB > 3.0.5 > 4.1.0
Microsoft.Azure.WebJobs.Extensions.DurableTask > 2.0.0 n/d
Microsoft.Azure.WebJobs.Extensions.EventHubs > 4.1.0 > 5.2.0
Microsoft.Azure.WebJobs.Extensions.ServiceBus > 3.2.0 > 5.9.0
Microsoft.Azure.WebJobs.Extensions.Storage > 3.0.10 > 5.1.0*

* Solo archiviazione code.

Importante

Quando si abilita il monitoraggio dei trigger di rete virtuale, solo i trigger per queste estensioni possono causare la scalabilità dinamica dell'app. È comunque possibile usare i trigger delle estensioni che non si trovano in questa tabella, ma non causeranno il ridimensionamento oltre il numero di istanze pre-riscaldamento. Per un elenco completo di tutte le estensioni di trigger e binding, vedere Trigger e associazioni.

Piano di servizio app e ambiente del servizio app con trigger della rete virtuale

Quando l'app per le funzioni viene eseguita in un piano di servizio app o in un ambiente del servizio app, è possibile scrivere funzioni attivate dalle risorse protette da una rete virtuale. Affinché le funzioni vengano attivate correttamente, l'app deve essere connessa a una rete virtuale con accesso alla risorsa definita nella connessione trigger.

Si supponga ad esempio di voler configurare Azure Cosmos DB in modo che accetti traffico solo da una rete virtuale. In questo caso è necessario distribuire l'app per le funzioni in un piano di servizio app che offre l'integrazione della rete virtuale con quella rete virtuale specifica. L'integrazione consente a una funzione di essere attivata da quella risorsa Azure Cosmos DB.

Considerazioni sul test

Quando si testano le funzioni in un'app per le funzioni con endpoint privati, è necessario eseguire i test dall'interno della stessa rete virtuale, ad esempio in una macchina virtuale (VM) in tale rete. Per usare l'opzione Code + Test nel portale da tale macchina virtuale, è necessario aggiungere le origini CORS seguenti all'app per le funzioni:

  • https://functions-next.azure.com
  • https://functions-staging.azure.com
  • https://functions.azure.com
  • https://portal.azure.com

Se è stato limitato l'accesso all'app per le funzioni con endpoint privati o per qualsiasi altra restrizione di accesso, aggiungere all'elenco elementi consentiti anche il tag del servizio AzureCloud. Per aggiornare l'elenco elementi consentiti:

  1. Passare all'app per le funzioni e selezionare Impostazioni>Rete e quindi selezionare Configurazione accesso in ingresso>Accesso alla rete pubblica.

  2. Assicurarsi che Accesso alla rete pubblica sia impostato su Abilitato da seleziona reti virtuali e indirizzi IP.

  3. Aggiungere una regola in Accesso al sito e regole:

    1. Selezionare Service Tag come Tipo di impostazioni di origine e AzureCloud come Tag del servizio.

    2. Assicurarsi che l'azione sia Consenti e impostare il nome e la priorità desiderati.

Risoluzione dei problemi

La funzionalità è facile da configurare, ma ciò non significa che l'esperienza sarà gratuita. In caso di problemi di accesso all'endpoint desiderato, sono disponibili varie utilità che permettono di testare la connettività dalla console dell'app. Le console disponibili sono due: Una è la console Kudu e l'altra è la console nel portale di Azure. Per raggiungere la console Kudu dall'app, passare a Strumenti>Kudu. È anche possibile raggiungere la console Kudo all'indirizzo [sitename].scm.azurewebsites.net. Dopo il caricamento del sito Web, passare alla scheda console di debug. Per accedere alla console ospitata nel portale di Azure dall'app, passare a Strumenti>Console.

Strumenti

Nelle app di Windows native, gli strumenti ping, nslookup e tracert non funzioneranno tramite la console a causa di vincoli di sicurezza (funzionano in contenitori Windows personalizzati). Per questo motivo sono stati aggiunti due strumenti separati. Per testare la funzionalità del DNS è stato aggiunto lo strumento nameresolver.exe. La sintassi è:

nameresolver.exe hostname [optional: DNS Server]

È possibile usare nameresolver per controllare i nomi host da cui dipende l'app. In questo modo è possibile verificare se la configurazione del server DNS è corretta e se si ha accesso al server DNS. È possibile visualizzare il server DNS usato dall'app nella console esaminando le variabili di ambiente WEBSITE_DNS_SERVER e WEBSITE_DNS_ALT_SERVER.

Nota

Lo strumento nameresolver.exe attualmente non funziona nei contenitori Windows personalizzati.

È possibile usare lo strumento successivo per testare la connettività TCP a una combinazione di host e porta. Questo strumento viene chiamato tcpping la cui sintassi è:

tcpping.exe hostname [optional: port]

L'utilità tcpping indica se è possibile raggiungere una porta e un host specifici. Essa visualizza il completamento solo se è presente un'applicazione in ascolto presso la combinazione di host e porta ed è presente un accesso di rete dall'app all'host e alla porta specificati.

Eseguire il debug dell'accesso alle risorse ospitate nella rete virtuale

Una serie di elementi può impedire all'app di raggiungere un host e una porta specifici. La maggior parte dei casi è una di queste cose:

  • L'ostacolo è rappresentato da un firewall. Se è presente un firewall, si verifica il timeout TCP. che in questo caso è di 21 secondi. Usare lo strumento tcpping per testare la connettività. Il timeout TCP può essere dovuto anche ad altri motivi, ma è consigliabile iniziare dal firewall.
  • Il DNS non è accessibile. Il timeout DNS è di tre secondi per ogni server DNS. Se si dispone di due server DNS, il timeout è di 6 secondi. Usare nameresolver per verificare il funzionamento del DNS. Non è possibile usare nslookup, perché non usa il DNS con cui è configurata la rete virtuale. Se non è accessibile, è possibile che un firewall o un gruppo di sicurezza di rete blocchi l'accesso a DNS o che sia inattivo.

Se questi elementi non rispondono ai problemi, cercare prima di tutto elementi come:

Integrazione della rete virtuale regionale

  • La destinazione è un indirizzo non RFC1918 e non è abilitato Route All?
  • Esiste un gruppo di sicurezza di rete che blocca l'uscita dalla subnet di integrazione?
  • Se si passa attraverso Azure ExpressRoute o una VPN, il gateway locale è configurato per instradare il traffico di backup ad Azure? Se è possibile raggiungere gli endpoint nella rete virtuale ma non in locale, controllare le route.
  • Sono disponibili autorizzazioni sufficienti per impostare la delega nella subnet di integrazione? Durante la configurazione dell'integrazione della rete virtuale a livello di area, la subnet di integrazione viene delegata a Microsoft.Web/serverFarms. L'interfaccia utente di integrazione della rete virtuale delega automaticamente la subnet a Microsoft.Web/serverFarms. Se l'account non dispone di autorizzazioni di rete sufficienti per impostare la delega, è necessario un utente che possa impostare gli attributi nella subnet di integrazione per delegare la subnet. Per delegare manualmente la subnet di integrazione, passare all'interfaccia utente della subnet di Rete virtuale di Azure e impostare la delega per Microsoft.Web/serverFarms.

Integrazione della rete virtuale richiesta dal gateway

  • Intervallo di indirizzi da punto a sito negli intervalli RFC 1918 (10.0.0.0-10.255.255.255 / 172.16.16.0 0.0-172.31.255.255 / 192.168.0.0-192.168.255.255)?
  • Il gateway viene visualizzato come attivo nel portale? Se il gateway è inattivo, è necessario riattivarlo.
  • I certificati vengono visualizzati come sincronizzati o si sospetta che la configurazione di rete sia stata modificata? Se i certificati non sono sincronizzati o si sospetta che sia stata apportata una modifica alla configurazione della rete virtuale non sincronizzata con i provider di servizi app, selezionare Sincronizza rete.
  • Se si passa attraverso una VPN, il gateway locale è configurato per instradare il traffico di backup ad Azure? Se è possibile raggiungere gli endpoint nella rete virtuale ma non in locale, controllare le route.
  • Si sta tentando di usare un gateway di coesistenza che supporta sia il punto a sito che ExpressRoute? I gateway di coesistenza non sono supportati con l'integrazione della rete virtuale.

Il debug dei problemi di rete è un problema perché non è possibile vedere cosa blocca l'accesso a una combinazione host:porta specifica. Alcune cause includono:

  • È presente un firewall sull'host che impedisce l'accesso alla porta dell'applicazione dall'intervallo IP da punto a sito. Il passaggio tra subnet spesso richiede l'accesso pubblico.
  • L'host di destinazione è inattivo.
  • L'applicazione è inattiva.
  • L'IP o il nome host è errato.
  • L'applicazione è in ascolto su una porta diversa da quella prevista. È possibile associare l'ID di processo alla porta di ascolto mediante "netstat -aon" nell'host dell'endpoint.
  • I gruppi di sicurezza di rete sono configurati in modo da impedire l'accesso all'host e alla porta dell'applicazione dall'intervallo IP da punto a sito.

Non si sa quale indirizzo viene effettivamente usato dall'app. Può trattarsi di qualsiasi indirizzo nella subnet di integrazione o nell'intervallo di indirizzi da punto a sito, quindi è necessario consentire l'accesso dall'intero intervallo di indirizzi.

Altri passaggi di debug includono:

  • Connettersi a un'altra macchina virtuale nella rete virtuale e provare a raggiungere l'host:porta della risorsa da quel punto. Per verificare l'accesso al protocollo TCP usare il comando di PowerShell test-netconnection. La sintassi è:
Test-NetConnection hostname [optional: -Port]
  • Visualizzare un'applicazione in una macchina virtuale e testare l'accesso a tale host e porta dalla console dall'app usando tcpping.

Risorse locali

Se l'app non riesce a raggiungere una risorsa locale, verificare se è possibile raggiungere la risorsa dalla propria rete virtuale. Usare il comando di PowerShell test-netconnection per eseguire controllare l'accesso al protocollo TCP. Se la macchina virtuale non riesce a raggiungere la risorsa locale, la connessione VPN o ExpressRoute potrebbe non essere configurata correttamente.

Se la macchina virtuale ospitata nella rete virtuale può raggiungere il sistema locale ma l'app non ci riesce, la causa è probabilmente una delle seguenti:

  • Le route non sono configurate con la subnet o gli intervalli di indirizzi da punto a sito nel gateway locale.
  • I gruppi di sicurezza della rete bloccano l'accesso all'intervallo IP da punto a sito.
  • I firewall locali bloccano il traffico proveniente dall'intervallo IP da punto a sito.
  • Si sta tentando di raggiungere un indirizzo non RFC 1918 usando la funzionalità di integrazione della rete virtuale a livello di area.

Eliminazione del piano di servizio app o dell'app Web prima di disconnettere l'integrazione della rete virtuale

Se è stata eliminata l'app Web o il piano di servizio app senza disconnettere prima l'integrazione della rete virtuale, non sarà possibile eseguire alcuna operazione di aggiornamento/eliminazione nella rete virtuale o nella subnet usata per l'integrazione con la risorsa eliminata. Una delega della subnet "Microsoft.Web/serverFarms" rimarrà assegnata alla subnet e impedirà le operazioni di aggiornamento/eliminazione.

Per eseguire di nuovo l'aggiornamento o l'eliminazione della subnet o della rete virtuale, è necessario ricreare l'integrazione della rete virtuale e quindi disconnetterla:

  1. Ricreare il piano di servizio app e l'app Web (è obbligatorio usare esattamente lo stesso nome dell'app Web di prima).
  2. Passare al pannello "Rete" nell'app Web e configurare l'integrazione della rete virtuale.
  3. Dopo aver configurato l'integrazione della rete virtuale, selezionare il pulsante "Disconnetti".
  4. Eliminare il piano di servizio app o l'app Web.
  5. Aggiornare/eliminare la subnet o la rete virtuale.

Se si verificano ancora problemi con l'integrazione della rete virtuale dopo aver seguito i passaggi precedenti, contattare il supporto tecnico Microsoft.

Strumento di risoluzione dei problemi di rete

È anche possibile usare lo strumento di risoluzione dei problemi di rete per risolvere i problemi di connessione. Per aprire lo strumento di risoluzione dei problemi di rete, passare all'app nel portale di Azure. Selezionare Diagnostica e risolvere il problema e quindi cercare Risoluzione dei problemi di rete.

Problemi di connessione: controlla lo stato dell'integrazione della rete virtuale, incluso il controllo se l'indirizzo IP privato è stato assegnato a tutte le istanze del piano e delle impostazioni DNS. Se non è configurato un DNS personalizzato, viene applicato IL DNS di Azure predefinito. Lo strumento di risoluzione dei problemi verifica anche la presenza di dipendenze comuni dell'app per le funzioni, tra cui la connettività per Archiviazione di Azure e altre dipendenze di associazione.

Screenshot che mostra la risoluzione dei problemi di connessione in esecuzione.

Problemi di configurazione: questo strumento di risoluzione dei problemi verifica se la subnet è valida per l'integrazione della rete virtuale.

Screenshot che mostra l'esecuzione dello strumento di risoluzione dei problemi di configurazione.

Problema di eliminazione di subnet/rete virtuale: questo strumento di risoluzione dei problemi controlla se la subnet ha blocchi e se contiene collegamenti di associazione del servizio inutilizzati che potrebbero bloccare l'eliminazione della rete virtuale o della subnet.

Passaggi successivi

Per altre informazioni sulla rete e su Funzioni di Azure: