Creare la prima funzione nel portale di Azure

Funzioni di Azure consente di eseguire il codice in un ambiente serverless senza dover prima creare una macchina virtuale (VM) o pubblicare un'applicazione Web. Questo articolo illustra come usare Funzioni di Azure per creare una funzione trigger HTTP "hello world" nel portale di Azure.

Nota

La modifica nel portale è supportata solo per le funzioni JavaScript, PowerShell, TypeScript e C#Script.

Per le funzioni C# di libreria di classi, Java e Python, è possibile creare l'app per le funzioni nel portale, ma è anche necessario creare le funzioni in locale e quindi pubblicarle in Azure.

È invece consigliabile sviluppare le funzioni in locale e pubblicare in un'app per le funzioni in Azure.
Usare uno dei collegamenti seguenti per iniziare a usare l'ambiente e il linguaggio di sviluppo locali scelti:

Visual Studio Code Terminale/prompt dei comandi Visual Studio
Attività iniziali con C#
Attività iniziali con Java
Attività iniziali con JavaScript
Attività iniziali con PowerShell
Attività iniziali con Python
Attività iniziali con C#
Attività iniziali con Java
Attività iniziali con JavaScript
Attività iniziali con PowerShell
Attività iniziali con Python
Introduzione a C#

Dettagli sul supporto linguistico

La tabella seguente illustra quali linguaggi supportati da Funzioni possono essere eseguiti in Linux o in Windows. Indica anche se la lingua supporta la modifica nel portale di Azure. Il linguaggio si basa sull'opzione Stack di runtime scelta durante la creazione dell'app per le funzioni nel portale di Azure. Si tratta della stessa --worker-runtime opzione quando si usa il func init comando in Funzioni di Azure Core Tools.

Linguaggio Stack di runtime Linux Windows Modifica nel portale1
Libreria di classi C#2 .NET
Script C# .NET
JavaScript Node.js
Python Python
Java Java
PowerShell PowerShell Core
TypeScript Node.js
Vai/Rust/altro Gestori personalizzati

1 Quando è in esecuzione in Linux, la modifica nel portale è supportata solo in un piano dedicato (servizio app).
2 Nel portale non è attualmente possibile creare app per le funzioni eseguite in .NET 5.0. Per altre informazioni, vedere Sviluppare e pubblicare funzioni .NET 5 usando Funzioni di Azure.

Per altre informazioni, vedere Supporto del sistema operativo/runtime.

Quando la modifica nel portale non è disponibile, è invece necessario sviluppare le funzioni in locale.

Prerequisiti

Se non si ha una sottoscrizione di Azure, creare un account Azure gratuito prima di iniziare.

Accedere ad Azure

Accedere al portale di Azure con il proprio account Azure.

Creare un'app per le funzioni

Per ospitare l'esecuzione delle funzioni è necessaria un'app per le funzioni. Un'app per le funzioni consente di raggruppare le funzioni come un'unità logica per semplificare la gestione, la distribuzione, il ridimensionamento e la condivisione delle risorse.

  1. Nel menu del portale di Azure o dalla pagina Home selezionare Crea una risorsa.

  2. Nella pagina Nuovo, selezionare Calcolo>App per le funzioni.

  3. Nella pagina Informazioni di base usare le impostazioni dell'app per le funzioni specificate nella tabella seguente.

    Impostazione Valore consigliato Descrizione
    Sottoscrizione Sottoscrizione in uso Sottoscrizione in cui viene creata questa nuova app per le funzioni.
    Gruppo di risorse myResourceGroup Nome del nuovo gruppo di risorse in cui creare l'app per le funzioni.
    Nome dell'app per le funzioni Nome univoco a livello globale Nome che identifica la nuova app per le funzioni. I caratteri validi sono a-z (senza distinzione tra maiuscole e minuscole), 0-9 e -.
    Pubblica Codice Opzione per la pubblicazione di file di codice o di un contenitore Docker.
    Stack di runtime Lingua preferita Scegliere un runtime che supporti il linguaggio di programmazione della funzione preferito. La modifica nel portale è disponibile solo per script JavaScript, PowerShell, TypeScript e C#. Le funzioni C# di libreria di classi, Java e Python devono essere sviluppate localmente.
    Versione Numero di versione Scegliere la versione del runtime installato.
    Area Area preferita Scegliere un'area nelle vicinanze o vicino ad altri servizi a cui accedono le funzioni.
  4. Selezionare Avanti: Hosting. Nella pagina Hosting immettere le impostazioni seguenti.

    Impostazione Valore consigliato Descrizione
    Account di archiviazione Nome globalmente univoco Creare un account di archiviazione usato dall'app per le funzioni. I nomi degli account di archiviazione devono avere una lunghezza compresa tra 3 e 24 caratteri e possono contenere solo numeri e lettere minuscole. È anche possibile usare un account esistente, che deve soddisfare i requisiti dell'account di archiviazione.
    Sistema operativo Windows Viene preselezionato automaticamente un sistema operativo in base alla selezione dello stack di runtime, ma, se necessario, è possibile modificare l'impostazione. La modifica all'interno del portale è supportata solo in Windows.
    Piano Consumo (serverless) Piano di hosting che definisce come vengono allocate le risorse all'app per le funzioni. Nel piano a consumo predefinito le risorse vengono aggiunte dinamicamente in base alle esigenze delle funzioni. In questo hosting serverless si paga solo per il periodo in cui le funzioni sono in esecuzione. In caso di esecuzione in un piano di servizio app, è necessario gestire il ridimensionamento dell'app per le funzioni.
  5. Selezionare Avanti: Monitoraggio. Nella pagina Monitoraggio immettere le impostazioni seguenti.

    Impostazione Valore consigliato Descrizione
    Application Insights Predefinito Crea una risorsa di Application Insights con lo stesso nome di app nell'area più vicina supportata. Espandendo questa impostazione o selezionando Crea nuovo, è possibile cambiare il nome Application Insights oppure scegliere una regione diversa in un'area geografica di Azure in cui archiviare i dati.
  6. Selezionare Rivedi e crea per rivedere le selezioni effettuate per la configurazione dell'app.

  7. Nella pagina Rivedi e crea esaminare le impostazioni e quindi selezionare Crea per effettuare il provisioning e distribuire l'app per le funzioni.

  8. Selezionare l'icona Notifiche nell'angolo superiore destro del portale e attendere che venga visualizzato il messaggio La distribuzione è riuscita.

  9. Selezionare Vai alla risorsa per visualizzare la nuova app per le funzioni. È anche possibile selezionare Aggiungi al dashboard. In questo modo è più facile tornare in questa risorsa di app per le funzioni dal dashboard.

    Deployment notification

Creare quindi una funzione nella nuova app per le funzioni.

Creare una funzione trigger HTTP

  1. Nel menu a sinistra della finestra App per le funzioni selezionare Funzioni, quindi selezionare Crea dal menu in alto.

  2. Nella finestra Crea funzione lasciare che la proprietà Sviluppo ambiente abbia Sviluppo nel portale e selezionare il modello di trigger HTTP .

    Choose HTTP trigger function

  3. In Dettagli modello usare HttpExample per Nuova funzione scegliere Anonimo nell'elenco a discesa Livello di autorizzazione e quindi selezionare Crea.

    A questo punto Azure crea la funzione Trigger HTTP. Ora è possibile eseguire la nuova funzione inviando una richiesta HTTP.

Testare la funzione

  1. Nella nuova funzione Trigger HTTP, selezionare Codice + test dal menu a sinistra, quindi selezionare Ottieni URL funzione dal menu in alto.

    Select Get function URL

  2. Nella finestra di dialogo Ottieni URL funzione, selezionare Predefinito dall'elenco a discesa, quindi l'icona Copia negli Appunti.

    Copy the function URL from the Azure portal

  3. Incollare l'URL della funzione nella barra degli indirizzi del browser. Aggiungere il valore della stringa di query ?name=<your_name> alla fine dell'URL e premere INVIO per eseguire la richiesta. Il browser dovrebbe visualizzare un messaggio di risposta che restituisce il valore della stringa di query.

    Se l'URL della richiesta include una chiave di accesso (?code=...), significa che si sceglie Funzione invece del livello di accesso anonimo durante la creazione della funzione. In questo caso, è invece necessario aggiungere &name=<your_name>.

  4. Quando viene eseguita la funzione, vengono scritte nei log informazioni di traccia. Per visualizzare l'output di traccia, tornare alla pagina Codice + test nel portale ed espandere la freccia Log nella parte inferiore della pagina. Chiamare di nuovo la funzione per visualizzare l'output di traccia scritto nei log.

    Functions log viewer in the Azure portal

Pulire le risorse

Altre guide di avvio rapido di questa raccolta si basano sulla presente guida di avvio rapido. Se si prevede di continuare a usare le guide di avvio rapido o i servizi creati con questa guida di avvio rapido, non eseguire la pulizia delle risorse.

Il termine risorse in Azure si riferisce ad app per le funzioni, funzioni, account di archiviazione e così via. Le risorse sono raggruppate in gruppi di risorse, ed è possibile eliminare tutti gli elementi in un gruppo eliminando il gruppo.

Per completare queste guide introduttive sono state create risorse. Per tali risorse potrebbero venire addebitati costi, a seconda dello stato dell'account e dei prezzi dei servizi. Se le risorse non sono più necessarie, ecco come eliminarle:

  1. Nel portale di Azure passare alla pagina Gruppo di risorse.

    Per visualizzare tale pagina dalla pagina dell'app per le funzioni, selezionare la scheda Panoramica e quindi selezionare il collegamento sotto Gruppo di risorse.

    Select the resource group to delete from the function app page.

    Per accedere a tale pagina dal dashboard, selezionare Gruppi di risorse e quindi selezionare il gruppo di risorse usato per questo articolo.

  2. Nella pagina Gruppo di risorse esaminare l'elenco delle risorse incluse e verificare che siano quelle da eliminare.

  3. Selezionare Elimina gruppo di risorse e seguire le istruzioni.

    L'eliminazione potrebbe richiedere alcuni minuti. Al termine, viene visualizzata una notifica per pochi secondi. È anche possibile selezionare l'icona a forma di campana nella parte superiore della pagina per visualizzare la notifica.

Passaggi successivi

Dopo avere creato la prima funzione, è possibile aggiungere un'associazione di output alla funzione che scrive un messaggio in una coda di archiviazione.