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

  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.

    Go to project selector

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

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

    Abilita le API

    5.

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

    Go to project selector

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

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

    Abilita le API

    8.
  8. Installa Git. Git è necessario per copiare i campioni nella tua macchina.
  9. 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 localmente.

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

  1. Fai clic su Cloud Code ed espandi la sezione Cloud Functions.

  2. Fai clic su aggiungi Crea funzione e seleziona un modello.

  3. Vai al percorso in cui vuoi creare la nuova funzione, inserisci un nome per la funzione e seleziona Crea nuova applicazione.

    Se la cartella dell'applicazione non viene visualizzata automaticamente in Explorer, fai clic su Aggiorna Aggiorna.

    Il file launch.json contiene le configurazioni richieste per la 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, vedi Gestire le funzioni nell'area di lavoro VS Code.

Scaricare una funzione esistente in una nuova area di lavoro

Per scaricare una funzione in una nuova area di lavoro:

  1. Fai clic su Cloud Code ed espandi la sezione 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 nella macchina 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:

  1. Fai clic con il tasto destro del mouse su una funzione e seleziona Esegui il deployment della funzione.

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

  3. Seleziona una regione in cui verrà eseguito il deployment della funzione.

  4. Seleziona un runtime.

    Il deployment della funzione potrebbe richiedere alcuni minuti. Mentre l'attività è in corso, viene visualizzato un indicatore di avanzamento progress_activity. Al termine, viene visualizzato un segno di spunta check_circle. Se l'operazione non riesce, viene visualizzato un contrassegno di errore.

    Se il deployment non riesce, fai riferimento alla scheda Output per leggere il messaggio di errore. Se fai clic sul link, vengono visualizzati i log di build nella console Google Cloud e vengono forniti ulteriori dettagli sull'errore.

    Output messaggio di errore

  5. (Facoltativo) Una volta 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 e 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 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.

Richiamare una funzione

Richiamare una funzione ti consente di eseguire la funzione di cui è stato eseguito il deployment nella console Google Cloud dal terminale integrato dell'IDE. Per richiamare una funzione, procedi nel seguente modo:

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

  2. Nella finestra Quickpick visualizzata Trigger function via HTTP (Funzione di trigger tramite HTTP), 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 dal file JSON: questa opzione prende 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

Richiedi assistenza

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