Esegui il deployment di una funzione Cloud Run (1ª generazione.)

Nota: Questi contenuti riguardano solo le funzioni Cloud Run (1ª generazione.), in precedenza Cloud Functions (1ª generazione.). Consulta Eseguire il deployment di una funzione Cloud Run per la versione di questo documento relativa alle funzioni Cloud Run, precedentemente Cloud Functions (2ª gen.).

Questa guida illustra come eseguire il deployment di una funzione Cloud Run dal codice sorgente.

Il processo di deployment prende il codice sorgente e le impostazioni di configurazione e crea un'immagine eseguibile gestita automaticamente dalle funzioni Cloud Run per gestire le richieste alla tua funzione.

Nozioni di base sul deployment

Gli utenti che eseguono il deployment delle funzioni Cloud Run devono avere Sviluppatore funzioni Cloud Run un ruolo IAM o un ruolo che include le stesse autorizzazioni. Consulta anche Configurazione aggiuntiva per il deployment.

Seleziona una scheda per le istruzioni per eseguire il deployment di una funzione utilizzando gcloud CLI o la console Google Cloud.

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

2. Utilizza la gcloud functions deploy per eseguire il deployment di una funzione:

   gcloud functions deploy YOUR_FUNCTION_NAME \
   [--gen2] \
   --region=YOUR_REGION \
   --runtime=YOUR_RUNTIME \
   --source=YOUR_SOURCE_LOCATION \
   --entry-point=YOUR_CODE_ENTRYPOINT \
   TRIGGER_FLAGS
   

   Il primo argomento, YOUR_FUNCTION_NAME, è un nome per della funzione di cui hai eseguito il deployment. Il nome della funzione deve iniziare con una lettera followed da un massimo di 62 lettere, numeri, trattini o trattini bassi e deve terminare con una lettera o un numero.

   • Il flag --gen2 specifica che vuoi eseguire il deployment nelle funzioni Cloud Run. A partire da settembre 2024, diventa l'impostazione predefinita. Per eseguire il deployment nella versione 1, utilizza --no-gen2.

   • Il flag --region specifica la regione in cui eseguire il deployment della funzione. Consulta Località per un elenco delle regioni supportate dalle funzioni Cloud Run.

   • Il flag --runtime specifica il runtime del linguaggio utilizzato dalla funzione. Cloud Run supporta diversi runtime. Per ulteriori informazioni, consulta Runtime.

   • Il flag --source specifica la posizione del codice sorgente della funzione. Per maggiori dettagli, consulta le seguenti sezioni:

     • Esegui il deployment dal tuo computer locale
     • Eseguire il deployment da Cloud Storage

   • Il flag --entry-point specifica il punto di ingresso della funzione nel codice sorgente. Questo è il codice che verrà eseguito quando viene eseguita la funzione. Il valore di questo deve essere un nome di funzione o un nome di classe completo esistente del codice sorgente. Per ulteriori informazioni, consulta Entry point della funzione.

   • Per specificare l'attivatore per il tuo , flag aggiuntivi (rappresentati come TRIGGER_FLAGS sopra) sono obbligatori, a seconda l'attivatore che vuoi utilizzare:

   Flag di attivazione	Descrizione trigger
   --trigger-http	Attiva la funzione con una richiesta HTTP(S). Consulta: Trigger HTTP per ulteriori informazioni.
   --trigger-topic=YOUR_PUBSUB_TOPIC	Attiva la funzione quando un messaggio viene pubblicato nel Pub/Sub. Consulta: Pub/Sub trigger per ulteriori informazioni.
   --trigger-bucket=YOUR_STORAGE_BUCKET	Attiva la funzione quando un oggetto viene creato o sovrascritto nel specificato per il bucket Cloud Storage specificato. Consulta: Trigger di Cloud Storage per ulteriori informazioni.
   --trigger-event=EVENT_TYPE [--trigger-resource=RESOURCE]	Attiva la funzione quando si verifica l'evento specificato. La specifica di una risorsa è obbligatoria per alcuni tipi di eventi. Per ulteriori informazioni, consulta Trigger supportati nelle funzioni Cloud Run (1ª gen.).

   Facoltativamente, puoi specificare ulteriori configurazione, networking e le opzioni di sicurezza quando esegui il deployment di una funzione.

   Per un riferimento completo sul comando deployment e sui suoi flag, consulta gcloud functions deploy documentazione.

   Per alcuni comandi di deployment di esempio, consulta Esempi di riga di comando.

Console

1. Vai alla pagina Panoramica delle funzioni Cloud Run nella console Google Cloud:

   Vai alle funzioni Cloud Run

   Assicurati che sia selezionato il progetto Google Cloud in cui vuoi eseguire il deployment delle funzioni Cloud Run.

2. Fai clic su Crea funzione.

3. Nel campo Ambiente, seleziona 1a generazione.

4. Nel campo Nome funzione, inserisci un nome per la funzione. La il nome della funzione deve iniziare con una lettera seguita da un massimo di 62 lettere numeri, trattini o trattini bassi e deve terminare con una lettera o un numero.

5. Nel campo Regione, seleziona una regione in cui eseguire il deployment della funzione.

6. Nella sezione Attivazione, segui i passaggi in base all'ambiente selezionato:

   1. Nella sezione Autenticazione HTTPS, seleziona il token appropriato a seconda che tu voglia o meno consentire per la funzione. Per impostazione predefinita, l'autenticazione obbligatorio. Per ulteriori informazioni, consulta Autenticazione per l'invocazione.
   2. Nel campo Tipo di attivatore, seleziona un tipo di attivatore. Per ulteriori dettagli, consulta Trigger supportati nelle funzioni Cloud Run (1ª gen.).
   3. Completa i campi aggiuntivi per il tipo di attivatore selezionato.
   4. Fai clic su Salva.

7. Facoltativamente, espandi la sezione Runtime, build... alla fine del pagina per ulteriori configurazioni e le opzioni di sicurezza.

8. Fai clic su Avanti per passare al passaggio Codice.

9. Nel campo Runtime, seleziona il runtime del linguaggio utilizzato dalla funzione. Le funzioni Cloud Run supportano diversi runtime. Per ulteriori informazioni, consulta Runtime.

10. Nel campo Entry point (Punto di ingresso), inserisci il punto di ingresso della funzione nel codice sorgente. Si tratta del codice che verrà eseguito di una funzione. Il valore di questo flag deve essere un nome di funzione o un nome di classe completamente qualificato esistente nel codice sorgente. Per ulteriori informazioni, consulta Punto di ingresso della funzione.

11. Nel campo Codice sorgente, seleziona l'opzione appropriata per la modalità di indicazione del codice sorgente della funzione. Per maggiori dettagli, consulta le sezioni seguenti:

    • Esegui il deployment dal tuo computer locale (caricamento ZIP)
    • Esegui il deployment da Cloud Storage
    • Eseguire il deployment dall'editor in linea della console Google Cloud

12. Fai clic su Esegui il deployment.

Al termine del deployment, le funzioni vengono contrassegnate da un segno di spunta verde. nella pagina di riepilogo delle funzioni di Cloud Run della console Google Cloud:

Il deployment iniziale di una funzione può richiedere diversi minuti, mentre dell'infrastruttura sottostante. Eseguire di nuovo il deployment di una funzione esistente è più veloce e il traffico in entrata viene migrato automaticamente alla versione più recente.

Nota: le istanze di cui è stato eseguito il provisioning con una versione precedente di una funzione potrebbero continuare a eseguire ed elaborare il traffico per diversi minuti dopo il completamento di un nuovo dispiegamento. Ciò garantisce che il traffico inviato alla funzione durante un deployment in corso non viene eliminata. Inoltre, quando un deployment non va a buon fine, se esiste una versione precedente della funzione, continuerà a essere disponibile nella maggior parte dei casi.

Esegui il deployment dal computer locale

Questa sezione descrive come eseguire il deployment di una funzione dal codice sorgente che si trova dalla macchina locale.

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

2. Segui le istruzioni per il deployment riportate sopra utilizzando il metodo Comando gcloud functions deploy.

   Per il flag --source, specifica un percorso del file system locale per la directory principale del codice sorgente della funzione, vedi Struttura della directory di origine. Se questo flag viene omesso, viene usata la directory di lavoro attuale.

   Se vuoi, puoi anche utilizzare il flag --stage-bucket per specificare un bucket Cloud Storage in cui caricare il codice sorgente durante il deployment.

   Durante il caricamento del codice sorgente, le funzioni Cloud Run escludono i file non necessari tramite il file .gcloudignore.

Console

1. Segui le istruzioni per il deployment riportate sopra utilizzando il metodo nella console Google Cloud finché non arrivi al campo Codice sorgente.
2. Nel campo Codice sorgente, seleziona Carica file ZIP.
3. Nel campo Bucket di destinazione, fai clic su Sfoglia per selezionare una Bucket Cloud Storage in cui caricare il codice sorgente come parte di e deployment continuo.
4. Nel campo File ZIP, fai clic su Sfoglia per selezionare un file ZIP da caricare. dal tuo file system locale. I file di origine delle funzioni devono trovarsi in la radice del file ZIP; vedi Struttura della directory di origine.
5. Fai clic su Esegui il deployment.

Esegui il deployment da Cloud Storage

Questa sezione descrive come eseguire il deployment di una funzione dal codice sorgente che si trova in un nel bucket Cloud Storage. Il codice sorgente deve essere pacchettizzato come file ZIP.

Affinché le funzioni Cloud Run possano leggere da un bucket Cloud Storage, devi concedere la classe storage.objects.get per l'account che esegue il deployment.

Consulta Utilizzare le autorizzazioni IAM. nella documentazione di Cloud Storage per informazioni sul controllo dell'accesso ai bucket.

Con questa autorizzazione ora puoi eseguire il deployment di una funzione da Cloud Storage:

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

2. Segui le istruzioni di implementazione riportate sopra utilizzando il comando gcloud functions deploy.

   Per il flag --source, specifica un percorso Cloud Storage che inizia con gs://. L'oggetto nel percorso deve essere un file ZIP contenente il codice sorgente della funzione. I file di origine delle funzioni devono trovarsi nella directory principale ZIP - vedi Struttura della directory di origine.

Console

1. Segui le istruzioni per il deployment riportate sopra utilizzando il metodo nella console Google Cloud finché non arrivi al campo Codice sorgente.
2. Nel campo Codice sorgente, seleziona ZIP da Cloud Storage.
3. Nel campo Posizione Cloud Storage, fai clic su Sfoglia per selezionare un file ZIP da Cloud Storage. I file di origine della funzione devono trovarsi nella directory radice del file ZIP. Consulta la struttura della directory di origine.
4. Fai clic su Esegui il deployment.

Esegui il deployment dall'editor in linea della console Google Cloud

Questa sezione descrive come scrivere ed eseguire il deployment di una funzione direttamente dalla console Google Cloud utilizzando l'editor in linea fornito.

1. Segui le istruzioni di implementazione riportate sopra utilizzando la console Google Cloud fino a raggiungere il campo Codice sorgente.
2. Nel campo Codice sorgente, seleziona Editor incorporato.
3. Utilizza l'editor fornito per creare o modificare i file di origine a seconda delle esigenze. Vedi Struttura della directory di origine.
   • Il riquadro a sinistra elenca i file di origine e ti consente di crearli, rinominarli e eliminarli.
   • Il riquadro a destra è un editor di testo che ti consente di modificare i contenuti del file.
4. Fai clic su Esegui il deployment.

Esempi dalla riga di comando

Questa sezione mostra i comandi di deployment per alcuni scenari di deployment di esempio.

Per maggiori dettagli sui diversi trigger supportati dalle funzioni di Cloud Run, consulta Trigger delle funzioni di Cloud Run.

Funzione HTTP dal codice sorgente locale

Supponiamo che tu abbia una funzione HTTP come segue:

• La funzione utilizza Node.js 20.
• Il codice sorgente si trova nella directory di lavoro attuale (.).
• Il punto di accesso nel codice è denominato myHttpFunction.

Per eseguire il deployment della funzione nelle funzioni Cloud Run con il nome my-http-function nella regione us-central1, utilizza il seguente comando:

gcloud functions deploy my-http-function \
  --no-gen2 \
  --region=us-central1 \
  --runtime=nodejs20 \
  --source=. \
  --entry-point=myHttpFunction \
  --trigger-http

Funzione Pub/Sub dal codice sorgente in Cloud Storage

Supponiamo che tu abbia una funzione basata sugli eventi come segue:

• La funzione gestisce gli eventi di pubblicazione dei messaggi Pub/Sub.
• La funzione utilizza Python 3.12.
• Il codice sorgente si trova in Cloud Storage nel percorso gs://my-bucket/my_function_source.zip.
• Il punto di ingresso nel codice si chiama pubsub_handler.

Per eseguire il deployment della funzione nelle funzioni Cloud Run con il nome my-pubsub-function nella regione europe-west1 e attivarla tramite i messaggi nell'argomento Pub/Sub my-topic, utilizza il seguente comando:

gcloud functions deploy my-pubsub-function \
  --no-gen2 \
  --region=europe-west1 \
  --runtime=python312 \
  --source=gs://my-bucket/my_function_source.zip \
  --entry-point=pubsub_handler \
  --trigger-topic=my-topic

Funzione Cloud Storage dal codice sorgente locale

Supponiamo che tu abbia una funzione basata sugli eventi come segue:

• La funzione gestisce gli eventi di eliminazione degli oggetti Cloud Storage.
• La funzione utilizza Java 17.
• Il codice sorgente si trova localmente nel percorso ./functions/storage-function.
• Il punto di accesso nel codice è denominato myproject.StorageFunction.

Per eseguire il deployment della funzione nelle funzioni Cloud Run con il nome my-storage-function nella regione asia-northeast1 e attivarla tramite eventi nel bucket Cloud Storage my-bucket, utilizza il seguente comando:

gcloud functions deploy my-storage-function \
  --no-gen2 \
  --region=asia-northeast1 \
  --runtime=java17 \
  --source=./functions/storage-function \
  --entry-point=myproject.StorageFunction \
  --trigger-resource=gs://my-bucket \
  --trigger-event=google.storage.object.delete

Passaggi successivi

• Consulta i dettagli sugli trigger di Cloud Run Functions.
• Scopri di più sulla procedura di compilazione delle funzioni Cloud Run.
• Esplora altre opzioni di configurazione di Cloud Run Functions.
• Scopri di più sulla protezione delle funzioni Cloud Run.
• Consulta i tutorial per esempi di casi d'uso specifici per le funzioni di Cloud Run.