Crea ed esegui il deployment di una funzione con Cloud Code for VS Code

Questa pagina mostra come creare, scaricare, eseguire il deployment e richiamare una funzione HTTP di 2ª generazione utilizzando Cloud Functions con Cloud Code.

Prima di iniziare

Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.

Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

Vai al selettore progetti

Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

Abilita le API Cloud Functions, Cloud Build, Artifact Registry, Cloud Run, Logging, and Pub/Sub.

Abilita le API

Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

Vai al selettore progetti

Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

Abilita le API Cloud Functions, Cloud Build, Artifact Registry, Cloud Run, Logging, and Pub/Sub.

Abilita le API

Installa Git. Git è necessario per copiare gli esempi sulla tua macchina.
Se non l'hai ancora fatto, installa il plug-in Cloud Code.

crea una funzione

Se hai già creato una funzione in precedenza, puoi scaricare una funzione esistente in una nuova area di lavoro e modificarla in locale.

Per creare una nuova funzione utilizzando un esempio, segui questi passaggi:

Fai clic su Cloud Code, quindi espandi la sezione Cloud Functions.
Fai clic su aggiungi Crea funzione e seleziona un modello.
Vai al percorso in cui vuoi creare la nuova funzione, inserisci un nome per la funzione e seleziona Create New Application (Crea nuova applicazione).

Se la cartella dell'applicazione non viene visualizzata automaticamente in Spazio di esplorazione, fai clic su aggiorna Aggiorna.

Il file launch.json contiene le configurazioni richieste per la tua funzione:
```
{
  "configurations": [
    {
      "name": "Deploy Cloud Function",
      "type": "cloudcode.cloudfunctions",
      "request": "launch",
      "functionName": "function-hello-world",
      "gen": "GEN_2",
      "entryPoint": "helloHttp",
    }
  ]
}
```

Per scoprire di più sulla creazione di più funzioni in un'unica area di lavoro, consulta Gestire le funzioni nell'area di lavoro di VS Code.

Scaricare una funzione esistente in una nuova area di lavoro

Per scaricare una funzione in una nuova area di lavoro:

Fai clic su Cloud Code, quindi espandi la sezione Cloud Functions.
Espandi lo snippet del progetto Google Cloud, fai clic con il tasto destro del mouse sulla funzione che vuoi scaricare e seleziona Scarica in una nuova area di lavoro.
Quando richiesto, inserisci un nome per la nuova applicazione e fai clic su Create New Application (Crea nuova applicazione).

La funzione viene scaricata sul computer locale e viene aperta in una nuova area di lavoro nel tuo IDE.

Esegui il deployment di una funzione

Per eseguire il deployment di una funzione, segui questi passaggi:

Fai clic con il pulsante destro del mouse su una funzione e seleziona Esegui il deployment della funzione.
Nel menu Scelta rapida, seleziona un progetto Google Cloud in cui eseguire il deployment della funzione.
Seleziona una regione in cui verrà eseguito il deployment della funzione.
Seleziona un runtime.

Il deployment della funzione potrebbe richiedere alcuni minuti. Mentre l'operazione è in corso, viene visualizzato un indicatore di avanzamento di progress_activity. Una volta completato, viene visualizzato un segno di spunta check_circle. Se non va a buon fine, viene visualizzato un segno di errore.

Se il deployment non va a buon fine, fai riferimento alla scheda Output per trovare il messaggio di errore. Se fai clic sul link, accedi ai log di build nella console Google Cloud e forniscono ulteriori dettagli sull'errore.
(Facoltativo) Dopo aver eseguito il deployment della funzione, puoi eseguire le seguenti azioni:
- Per visualizzare i file di sola lettura della funzione di cui hai eseguito il deployment, espandi la funzione ed espandi la cartella Codice sorgente. Qui puoi visualizzare launch.json in .vscode, il codice di cui è stato eseguito il deployment e package.json.
- Per visualizzare la funzione nella console Google Cloud, fai clic con il tasto destro del mouse sulla funzione e seleziona Apri in console Cloud e, se richiesto, seleziona Apri.
- Per modificare i metadati della funzione, fai clic con il tasto destro del mouse sulla funzione e seleziona Modifica metadati nella console Cloud.
- Per visualizzare i log della funzione di cui è stato eseguito il deployment, fai clic con il tasto destro del mouse sulla funzione e seleziona Visualizza log.

Richiamare una funzione

La chiamata di una funzione consente di eseguire la funzione di cui è stato eseguito il deployment nella console Google Cloud dal terminale integrato dell'IDE. Per richiamare una funzione, segui questi passaggi:

Fai clic con il tasto destro del mouse sulla funzione e seleziona Richiama funzione tramite HTTP.
Nella sezione Quickpick Attiva funzione tramite HTTP visualizzata, seleziona una delle due opzioni:
- Predefinito: un terminale si apre nell'IDE ed esegue un comando per eseguire la funzione in Google Cloud.
- Importa argomenti da file JSON: questa opzione acquisisce i contenuti del file JSON selezionato, li trasforma in una stringa e li passa con -d '{. Questo è utile quando hai un input per le tue funzioni e vuoi salvarlo, in modo da eseguirlo senza doverlo ridigitare ripetutamente.

Passaggi successivi

Consulta la panoramica sull'utilizzo di Cloud Functions per scoprire di più sulla gestione dell'area di lavoro o sulla configurazione di un ambiente di sviluppo locale.

Richiedi assistenza

Per inviare feedback, segnala problemi su GitHub o fai una domanda su Stack Overflow.