Questa pagina è stata tradotta dall'API Cloud Translation.

Deployment in Cloud Run Functions

Questa pagina spiega come eseguire il deployment di applicazioni nelle funzioni Cloud Run utilizzando Cloud Build. Se non hai mai utilizzato Cloud Build, leggi prima le guide di avvio rapido 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 le funzioni Cloud Run puoi scrivere funzioni semplici a uso specifico che vengono collegate agli eventi generati dall'infrastruttura e dai servizi cloud. La funzione viene attivata quando viene attivato un evento controllato. Per maggiori informazioni su Cloud Run Functions, leggi la documentazione di Cloud Run Functions.

Prima di iniziare

Abilita l'API Cloud Run Functions:

Abilita l'API Cloud Run Functions
Concedi il ruolo Sviluppatore di funzioni Cloud Run al account di servizio Cloud Build:
1. Nella console Google Cloud , vai alla pagina Cloud Build Autorizzazioni:
  Vai ad Autorizzazioni
2. Imposta lo stato del ruolo Sviluppatore di Cloud Run Functions su Abilitato.
Per eseguire i comandi gcloud in questa pagina, installa Google Cloud CLI.
Tieni a portata di mano il codice sorgente dell'applicazione che vuoi creare e di cui vuoi eseguire il deployment su Cloud Run Functions. Il codice sorgente deve essere archiviato in un repository, ad esempio Cloud Source Repositories, GitHub o Bitbucket.

Configurazione del deployment

Cloud Build ti consente di utilizzare qualsiasi immagine container disponibile pubblicamente per eseguire le tue attività. Puoi farlo specificando l'immagine in una build step 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, segui questi passaggi:

Nella directory principale del progetto, crea il file di configurazione Cloud Build denominato cloudbuild.yaml o cloudbuild.json.
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 la documentazione di riferimento di gcloud functions deploy.
- --source=. indica 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 precedente con quanto segue:
- FUNCTION_NAME è il nome delle funzioni Cloud Run 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, vedi Località delle funzioni Cloud Run.
- --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 saperne di più sull'utilizzo di gcloud functions deploy, consulta la documentazione di Cloud Run Functions.
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 precedente con quanto segue:
- 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 nelle funzioni Cloud Run 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:

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 precedente con quanto segue:
- FUNCTION_NAME è il nome delle funzioni Cloud Run 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 esegui il deployment di Cloud Run Functions. Per un elenco delle regioni supportate, vedi Località delle funzioni Cloud Run.
- --trigger-http è il tipo di trigger per questa funzione, in questo caso una richiesta HTTP (webhook).
- RUNTIME è il runtime in cui eseguire la funzione.
Crea un trigger di build con il file di configurazione creato nel passaggio precedente:
1. Apri la pagina Trigger nella console Google Cloud :
  
  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.
  
  Nota: la regione del trigger deve corrispondere a quella della funzione di cui stai eseguendo il deployment.
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 da compilare automaticamente, vedi Creazione di 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 /.
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 su Cloud Run Functions.

Per saperne di più sulla creazione di trigger Cloud Build, consulta la pagina Creare e gestire trigger di build.

Passaggi successivi

Scopri come eseguire deployment blu/verde su Compute Engine
Scopri come eseguire il deployment su Cloud Run
Scopri come eseguire il deployment su GKE
Scopri come eseguire il deployment su Firebase.
Scopri come eseguire il deployment su App Engine
Scopri come risolvere gli errori di build.