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 Funzioni di Cloud Run con Cloud Code in dell'editor di Cloud Shell.

---

Per seguire una guida passo passo per questa attività direttamente nel 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 chiesto di autorizzare Cloud Code a utilizzare le tue credenziali per effettuare una chiamata all'API Google Cloud, fai clic su Autorizza se accetti i termini.

3. Se non hai ancora una connessione a Google Cloud, nella sezione Barra di stato di Cloud Code, fai clic su Connetti a Google Cloud.

   

4. Se ti viene richiesto di autorizzare Cloud Code a utilizzare il tuo 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, vedrai nome del progetto nella barra di stato di Cloud Code e procedere a crea la tua funzione.

6. Nel menu Scelta rapida Seleziona un progetto Google Cloud visualizzato, selezionare il 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 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. Una volta 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 unico spazio di lavoro, consulta Gestire le funzioni nello spazio 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. Clic Cloud Code ed espandi l'explorer 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 a Output (Visualizzazione > Output). visualizza 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 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.

   La funzione viene scaricata sul computer locale e viene aperta in una nuova 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.

   Questa operazione chiude il progetto e ne pianifica 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.