Deployment in Cloud Run Functions

Questa pagina spiega come eseguire il deployment delle applicazioni in Cloud Run Functions utilizzando Cloud Build. Se non hai mai utilizzato Cloud Build, leggi prima le guide rapide e la panoramica della configurazione di compilazione.

Cloud Run Functions è un ambiente di esecuzione serverless per la creazione e la connessione di servizi cloud. Con Cloud Run Functions puoi scrivere funzioni a uso specifico che vengono collegate agli eventi generati dall'infrastruttura e dai servizi cloud. La funzione viene attivata quando viene generato un evento monitorato. Per ulteriori informazioni su Cloud Run Functions, consulta la documentazione di Cloud Run Functions.

Prima di iniziare

  • Abilita l'API Cloud Run Functions:

    Abilita l'API Cloud Run Functions

  • Prepara il codice sorgente dell'applicazione. Il codice sorgente deve essere archiviato in un repository come GitHub o Bitbucket.

  • Per eseguire i gcloud comandi in questa pagina, installa il Google Cloud CLI.

Autorizzazioni Identity and Access Management richieste

  1. Nella Google Cloud console, vai alla pagina Autorizzazioni di Cloud Build:

    Vai ad Autorizzazioni

  2. Per il service account Cloud Build specificato o per il service account Cloud Build predefinito, imposta lo stato dei seguenti ruoli su Attivato:

    • Sviluppatore Cloud Functions (roles/cloudfunctions.developer) | Per eseguire il deployment e gestire le funzioni.
    • Amministratore Cloud Run (roles/run.admin) | Consente al account di servizio Cloud Build di eseguire il deployment di nuove versioni in Cloud Run.
    • Amministratore Storage (roles/storage.admin) | Consente la lettura e la scrittura da Cloud Storage.
    • Artifact Registry Writer (roles/artifactregistry.writer) | Consente di eseguire il pull delle immagini da Artifact Registry e di scriverci.
    • Writer log (roles/logging.logWriter) | Consente di scrivere voci di log in Cloud Logging.
    • Editor Cloud Build (roles/cloudbuild.builds.editor) | Consente al account di servizio di eseguire le build.

Configurazione del deployment

Cloud Build ti consente di utilizzare qualsiasi immagine container disponibile pubblicamente per eseguire le tue attività. Per farlo, specifica l'immagine in un step di build nel file di configurazione di Cloud Build.

Cloud Run Functions fornisce il comando gcloud functions deploy, che esegue il deployment della funzione dalla directory contenente il codice della funzione. Puoi utilizzare l'immagine cloud-sdk come passaggio di build nel file di configurazione per richiamare i comandi gcloud all'interno dell'immagine. Gli argomenti passati a questo passaggio di build vengono passati direttamente a Google Cloud CLI, consentendoti di eseguire qualsiasi comando gcloud in questa immagine.

Per eseguire il deployment di un'applicazione in Cloud Run Functions:

  1. Nella directory principale del progetto, crea il file di configurazione di compilazione di Cloud Build denominato cloudbuild.yaml o cloudbuild.json.

  2. Nel file di configurazione:

    • Aggiungi un campo name e specifica il passaggio di build gcloud.
    • Aggiungi functions deploy al campo args per richiamare il comando gcloud functions deploy. Per le opzioni di configurazione disponibili, consulta il riferimento gcloud functions deploy.

    • --source=. implica che il codice sorgente si trova nella directory di lavoro corrente.

    YAML 

    steps:
- name: 'gcr.io/google.com/cloudsdktool/cloud-sdk'
  args:
  - gcloud
  - functions
  - deploy
  - FUNCTION_NAME
  - --region=FUNCTION_REGION
  - --source=.
  - --trigger-http
  - --runtime=RUNTIME

    JSON 

    {
 "steps": [
  {
     "name": "gcr.io/google.com/cloudsdktool/cloud-sdk",
     "args": [
       "gcloud",
       "functions",
       "deploy",
        [
          "FUNCTION_NAME"
        ],
        "--region=FUNCTION_REGION",
        "--source=.",
        "--trigger-http",
        "--runtime=RUNTIME"
     ]
   }
  ]
}

    Sostituisci i valori dei segnaposto nel file di configurazione sopra con i seguenti:

    • FUNCTION_NAME è il nome di Cloud Run Functions di cui stai eseguendo il deployment. Se stai aggiornando una funzione esistente, questo valore deve corrispondere al nome della funzione che stai aggiornando.
    • FUNCTION_REGION è la regione in cui stai eseguendo il deployment di Cloud Run Functions. Per un elenco delle regioni supportate, consulta Località di Cloud Run Functions.
    • --trigger-http è il tipo di trigger per questa funzione, in questo caso una richiesta HTTP (webhook).
    • RUNTIME è il runtime in cui eseguire la funzione.

    Per ulteriori informazioni sull'utilizzo di gcloud functions deploy, consulta la documentazione di Cloud Run Functions.

  3. Avvia la build utilizzando il file di configurazione creato nel passaggio precedente:

     gcloud builds submit --region=REGION --config CONFIG_FILE_PATH SOURCE_DIRECTORY

    Sostituisci i valori dei segnaposto nel file di configurazione sopra con i seguenti:

    • CONFIG_FILE_PATH è il percorso del file di configurazione della build.
    • SOURCE_DIRECTORY è il percorso o l'URL del codice sorgente.
    • REGION è una delle regioni di build supportate.

    Se non specifichi un CONFIG_FILE_PATH e un SOURCE_DIRECTORY nel comando gcloud builds submit, Cloud Build presuppone che il file di configurazione e il codice sorgente si trovino nella directory di lavoro corrente.

Deployment continuo

Puoi automatizzare il deployment del software in Cloud Run Functions creando trigger di Cloud Build. Puoi configurare i trigger per creare ed eseguire il deployment delle immagini ogni volta che aggiorni il codice sorgente.

Per automatizzare il deployment in Cloud Run Functions:

  1. Nella radice del repository, aggiungi un file di configurazione con i passaggi per richiamare il comando gcloud functions deploy:

    YAML 

    steps:
- name: 'gcr.io/google.com/cloudsdktool/cloud-sdk'
  args:
  - gcloud
  - functions
  - deploy
  - FUNCTION_NAME
  - --region=FUNCTION_REGION
  - --source=.
  - --trigger-http
  - --runtime=RUNTIME

    JSON 

    {
 "steps": [
  {
     "name": "gcr.io/google.com/cloudsdktool/cloud-sdk",
     "args": [
       "gcloud",
       "functions",
       "deploy",
        [
          "FUNCTION_NAME"
        ],
        "--region=FUNCTION_REGION",
        "--source=.",
        "--trigger-http",
        "--runtime=RUNTIME"
     ]
   }
  ]
}

    Sostituisci i valori dei segnaposto nel file di configurazione sopra con i seguenti:

    • FUNCTION_NAME è il nome di Cloud Run Functions di cui stai eseguendo il deployment. Se stai aggiornando una funzione esistente, questo valore deve corrispondere al nome della funzione che stai aggiornando.
    • FUNCTION_REGION è la regione in cui stai eseguendo il deployment di Cloud Run Functions. Per un elenco delle regioni supportate, consulta Località di Cloud Run Functions.
    • --trigger-http è il tipo di trigger per questa funzione, in questo caso una richiesta HTTP (webhook).
    • RUNTIME è il runtime in cui eseguire la funzione.

  2. Crea un trigger di build con il file di configurazione creato nel passaggio precedente:

    1. Apri la pagina Trigger nella Google Cloud console:

      Apri la pagina Trigger

    2. Seleziona il tuo progetto dal menu a discesa del selettore di progetti nella parte superiore della pagina.

    3. Fai clic su Crea trigger.

    4. Nel campo Nome, inserisci un nome per il trigger.

    5. In Regione, seleziona la regione per il trigger.

    6. In Evento, seleziona l'evento del repository per avviare il trigger.

    7. In Origine, seleziona il repository e il nome del ramo o del tag che avvierà il trigger. Per ulteriori informazioni su come specificare i rami di cui eseguire la build automatica, consulta Creare un trigger di build.

    8. In Configurazione, seleziona File di configurazione di Cloud Build (YAML o JSON).

    9. Nel campo Posizione file di configurazione Cloud Build, digita cloudbuild.yaml dopo il carattere /.

    10. Fai clic su Crea per salvare il trigger di build.

Ogni volta che esegui il push di nuovo codice nel repository, viene attivata automaticamente una build e un deployment in Cloud Run Functions.

Per ulteriori informazioni sulla creazione di trigger di Cloud Build, consulta Creare e gestire i trigger di build.

Passaggi successivi