Crea ed esegui il deployment di una funzione con Cloud Shell

Scopri come creare, eseguire il deployment, richiamare e scaricare una funzione HTTP di 2ª generazione utilizzando Cloud Functions con Cloud Code nell'editor di Cloud Shell.

---

Per seguire le indicazioni dettagliate per questa attività direttamente nell'editor di Cloud Shell, fai clic su Procedura guidata:

Aiuto

---

1. 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.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

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

4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

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

Connettersi a Google Cloud

In questa sezione avvierai l'editor di Cloud Shell, ti connetterai a Google Cloud e selezionerai un progetto Google Cloud.

Per connetterti a Google Cloud, segui questi passaggi:

1. Avvia l'editor di Cloud Shell.

2. Se ti viene richiesto di autorizzare Cloud Code a utilizzare le tue credenziali per effettuare una chiamata API Google Cloud, fai clic su Autorizza se accetti i termini.

3. Se la connessione a Google Cloud non è ancora attiva, fai clic su Connetti a Google Cloud nella barra di stato di Cloud Code.

   

4. Se ti viene chiesto di autorizzare Cloud Code a utilizzare le tue credenziali per effettuare chiamate API Google Cloud, fai clic su Autorizza se accetti questi termini.

5. Se non hai ancora selezionato un progetto Google Cloud, nella barra di stato di Cloud Code fai clic su Seleziona un progetto Google Cloud.

   Se hai già selezionato un progetto Google Cloud, verrà visualizzato il nome del progetto nella barra di stato di Cloud Code e potrai procedere con la creazione della funzione.

6. Nel menu di scelta rapida Seleziona un progetto Google Cloud visualizzato, seleziona il tuo progetto Google Cloud.

   Il progetto viene caricato e diventa il progetto attivo nell'editor di Cloud Shell. Puoi cambiare questo progetto in qualsiasi momento facendo clic sul nome del progetto attivo nella barra di stato di Cloud Code e selezionando un progetto diverso.

Crea la funzione

Utilizza l'editor di Cloud Shell come ambiente per la creazione e il deployment della funzione. L'editor viene caricato preventivamente con gli strumenti necessari per lo sviluppo cloud.

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

1. Nella barra di stato di Cloud Code, fai clic su Cloud Code.

   

2. Seleziona Nuova applicazione nel menu Selezione rapida visualizzato.

3. Seleziona Applicazione Cloud Functions come tipo di applicazione di esempio.

4. Dall'elenco delle app Cloud Functions di esempio, seleziona Node.js: Hello World.

5. Seleziona una cartella per il percorso della tua applicazione e fai clic su Crea nuova applicazione.

   L'editor di Cloud Shell carica la tua app in una nuova area di lavoro. Dopo averla ricaricata, l'app è accessibile tramite la visualizzazione Explorer.

   Il file launch.json, che si trova nella cartella .vscode, 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 Shell.

esegui il deployment della funzione

Ora che hai creato la funzione, puoi eseguirne il deployment in Cloud Shell seguendo questi passaggi:

1. Fai clic su Cloud Code ed espandi lo strumento di esplorazione di Cloud Functions.

2. Fai clic su una funzione, quindi su Esegui il deployment della funzione.

3. Nel menu Scelta rapida, seleziona un progetto Google Cloud in cui eseguire il deployment della funzione.

4. Seleziona la regione in cui verrà eseguito il deployment della funzione.

5. Seleziona Node.js 20.

   Il deployment della funzione potrebbe richiedere alcuni minuti. Se è ancora in corso, vedrai un'icona di avanzamento . Al termine dell'operazione, vedrai l'icona di successo in caso di esito positivo, l'icona di errore in caso di esito negativo o l'icona di avviso se il deployment non riesce e ne viene ripristinato uno eseguito in precedenza.

   Se il deployment non riesce, fai riferimento alla visualizzazione Output (Visualizza > Output) per trovare il messaggio di errore. Facendo clic sul link vengono visualizzati i log di build nella console Google Cloud e vengono forniti ulteriori dettagli sull'errore.

6. (Facoltativo) Una volta eseguito il deployment della funzione, puoi eseguire queste azioni:

   • Per visualizzare i file di sola lettura della funzione di cui hai eseguito il deployment, espandi la funzione, quindi 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, seleziona Apri nella 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.

Richiama la funzione

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

1. Fai clic con il tasto destro del mouse sulla funzione e seleziona Richiama funzione tramite HTTP.

2. Nel menu Attiva funzione tramite HTTP che viene visualizzato, seleziona Richiama senza argomenti.

   Un terminale si apre nell'IDE ed esegue un comando per eseguire la funzione in Google Cloud.

(Facoltativo) Scarica una funzione esistente in una nuova area di lavoro

Per scaricare una funzione esistente in una nuova area di lavoro:

1. Fai clic su Cloud Code, quindi espandi lo strumento di esplorazione di Cloud Functions.

2. 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.

3. Quando richiesto, inserisci un nome per la nuova applicazione e fai clic su Crea nuova applicazione.

   La funzione viene scaricata sulla macchina locale e viene aperta in una nuova area di lavoro nell'editor di Cloud Shell.

Esegui la pulizia

Per eliminare solo la funzione che hai creato per questa guida rapida:

1. Nell'Explorer di Cloud Functions, fai clic con il tasto destro del mouse sul nome della funzione e seleziona Apri in console Cloud.

2. Fai clic su Elimina e quindi su Elimina.

Per eliminare il progetto (e le risorse associate):

1. Vai alla pagina Progetti nella console Google Cloud:

   Vai alla pagina Progetti

2. Seleziona il progetto che hai creato per questa guida rapida e fai clic su Elimina.

3. Digita l'ID progetto per confermare e fai clic su Chiudi.

   Il progetto verrà chiuso e ne verrà pianificato l'eliminazione.

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.