crea una funzione ed eseguine il deployment con Cloud Shell

Scopri come creare, eseguire il deployment, richiamare e scaricare una funzione Cloud Run HTTP utilizzando le funzioni Cloud Run con Cloud Code nell'Editor Cloud Shell.

---

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

Procedura guidata

---

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

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. Make sure that billing is enabled for your Google Cloud project.

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. Make sure that billing is enabled for your Google Cloud project.

Connettiti a Google Cloud

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

Per connetterti a Google Cloud:

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 non hai ancora eseguito la connessione a Google Cloud, 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 alle 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, vedrai nome del progetto nella barra di stato di Cloud Code e procedere a crea la tua 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 Cloud Shell. Puoi cambiare questo progetto in qualsiasi momento facendo clic sul nome del progetto attivo nella barra di stato di Cloud Code selezionando un altro progetto.

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. Nel menu di scelta rapida visualizzato, seleziona Nuova applicazione.

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

4. Dall'elenco delle app di esempio per le funzioni di Cloud Run, 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 ricaricamenti, la tua app è accessibile dalla vista 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 una singola area di lavoro, consulta Gestisci le funzioni nell'area di lavoro 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 l'esploratore 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 22.

   Il deployment della funzione potrebbe richiedere alcuni minuti. Se è ancora in corso, vedrai un'icona di avanzamento . Al termine dell'operazione, vedrai Icona operazione riuscita di Se ha esito positivo, sull'icona di errore se non riesce o Icona di avviso se il deployment non riesce e ripristina un deployment riuscito in precedenza.

   Se il deployment non riesce, fai riferimento alla visualizzazione Output (Visualizza > Output) per 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

Il richiamo di una funzione ti consente di eseguire la funzione di cui è stato eseguito il deployment 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 di scelta rapida Attiva funzione tramite HTTP che viene visualizzato, seleziona Richiama senza argomenti.

   Un terminale si apre nell'IDE e lancia 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 ed espandi l'esploratore 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.

   In questo modo 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 creata per questa guida rapida:

1. Nell'Explorer di Cloud Functions, fai clic con il tasto destro del mouse sul nome della funzione, quindi Seleziona Apri nella 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, quindi fai clic su Elimina.

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

   Il progetto viene chiuso e pianificato per l'eliminazione.

Passaggi successivi

• Consulta la panoramica Lavorare con le funzioni Cloud Run per scoprire di più su come gestire lo spazio di lavoro o configurare un ambiente di sviluppo locale.