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ª gen. utilizzando Cloud Functions con Cloud Code.

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. Enable the Cloud Functions, Cloud Build, Artifact Registry, Cloud Run, Logging, and Pub/Sub APIs.

    Enable the APIs

    5.

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

    Go to project selector

  6. Make sure that billing is enabled for your Google Cloud project.

  7. Enable the Cloud Functions, Cloud Build, Artifact Registry, Cloud Run, Logging, and Pub/Sub APIs.

    Enable the APIs

    8.
  8. Installa Git. Git è necessario per copiare i sample sulla tua macchina.
  9. Se non l'hai ancora fatto, installa il plug-in Cloud Code.

Crea una funzione

Se hai già creato una funzione, puoi scaricarne una 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 un'unica area di lavoro, consulta Gestire le funzioni nello spazio di lavoro di VS Code.

Scaricare una funzione esistente in una nuova area di lavoro

Per scaricare una funzione in un nuovo spazio di lavoro:

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

  2. Espandi lo snippet del progetto, fai clic con il tasto destro del mouse sulla funzione che vuoi scaricare e seleziona Scarica in una nuova area di lavoro. Google Cloud

  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'IDE.

Esegui il deployment di una funzione

Per eseguire il deployment di una funzione:

  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 Google Cloud progetto 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. Durante l'operazione, viene visualizzato un indicatore di avanzamento progress_activity. Al termine, viene visualizzato un segno di spunta check_circle. In caso di errore, viene visualizzato un segno di errore.

    Se il deployment non riesce, fai riferimento alla scheda 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.

    Output del 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, 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.

Richiamare una funzione

Richiamare una funzione consente di eseguire la funzione di cui è stato eseguito il deployment nella console Google Cloud dal terminale integrato dell'IDE. Per invocare 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 una delle due opzioni:

    • Predefinito: un terminale si apre nell'IDE e lancia un comando per eseguire la funzione in Google Cloud.

    • Importa gli argomenti dal file JSON: questa opzione prende il contenuto del file JSON selezionato, lo trasforma in una stringa e lo passa con -d '{. Questa operazione è utile quando hai un input per le tue funzioni e vuoi salvarlo, in modo da poterlo eseguire senza dover digitarlo ripetutamente.

Passaggi successivi

Richiedi assistenza

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