Crea una funzione Cloud Run di 2ª generazione utilizzando Cloud Code per Cloud Shell

Scopri come creare, eseguire il deployment, richiamare e scaricare una funzione Cloud Run HTTP utilizzando Cloud Code nell'editor di Cloud Shell.

Cloud Code è un'estensione che porta molti servizi Google Cloud, come Google Kubernetes Engine e Cloud Run, direttamente nel tuo IDE, per consentirti di sviluppare le tue applicazioni senza dover cambiare contesto. Cloud Code è disponibile per impostazione predefinita nell'editor Cloud Shell.

Puoi installare l'estensione Cloud Code in VS Code, che supporta anche la creazione e il deployment delle funzioni, o IntelliJ e altri IDE JetBrains supportati, che non supportano le funzioni Cloud Run.

Per seguire una guida passo passo per questa attività direttamente nel Editor di Cloud Shell, fai clic su Procedura guidata:

Procedura guidata

Prima di iniziare

  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.

    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.

    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 di Cloud Shell, ti connetterai a Google Cloud e seleziona 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 non hai ancora eseguito la connessione a Google Cloud, fai clic su Connetti a Google Cloud nella barra di stato di Cloud Code.

    Pulsante Connetti a Google Cloud nella barra di stato

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

    Pulsante della barra di stato di 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 delle funzioni Cloud Run 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. 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",
    }
]
}

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'explorer 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 sul computer locale e viene aperta in una nuova nell'editor di Cloud Shell.

Esegui la pulizia

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

  1. Nell'esploratore Cloud Functions, fai clic con il tasto destro del mouse sul nome della funzione e poi 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