Gestire le funzioni

Questa guida mostra come gestire e scollegare una funzione creata con il comando gcloud functions. Per scoprire come gestire una funzione creata con il comando gcloud run, consulta Gestire i servizi Cloud Run.

Nota :se hai creato una funzione Cloud Run utilizzando i comandi gcloud run o l'API Cloud Run Admin, non puoi gestirla con i comandi gcloud functions o l'API Cloud Functions v2.

Le funzioni create utilizzando l'API Cloud Functions v2 (ad esempio utilizzando gcloud functions, l'API REST o Terraform) possono essere gestite con l'API Cloud Run Admin e con l'API Cloud Functions v2. Ad esempio, puoi aggiornare una funzione esistente utilizzando i comandi gcloud functions o gcloud run:

gcloud functions

  gcloud functions deploy FUNCTION_NAME \
    --runtime=nodejs24 \
    --source= . \
    --entry-point=ENTRYPOINT
    --trigger-http

gcloud run

gcloud run deploy FUNCTION_NAME \
  --source= . \
  --function=ENTRYPOINT
  --base-image=google-22-full/nodejs24

Scollega

Il comando gcloud functions detach consente di scollegare una funzione Cloud Functions v2 dal relativo ambiente API esistente. Dopo aver scollegato una funzione, puoi gestirla solo utilizzando l'API Cloud Run Admin. Potresti volerlo fare se i tuoi carichi di lavoro devono rimanere all'interno del limite dell'API run.googleapis.com per Assured Workloads o per assicurarti che i tuoi carichi di lavoro utilizzino lo SKU Cloud Run.

Preparare la funzione per il distacco

Quando ti prepari a scollegare la funzione, considera quanto segue:

• L'operazione di distacco non è reversibile.
• L'operazione di distacco non può essere applicata a Cloud Run Functions (1ª generazione.).
• Acquisisci familiarità con la distribuzione di funzioni in Cloud Run utilizzando la console Google Cloud , Google Cloud CLI e Terraform.
• Le funzioni HTTP manterranno gli URL assegnati.
• I trigger collegati alle funzioni basate su eventi verranno conservati.
• I trigger non possono essere gestiti direttamente tramite l'API run.googleapis.com. Assicurati di acquisire familiarità con le guide alla gestione dei trigger per Eventarc o Pub/Sub.
• La disattivazione di Riprova in caso di errore non è una funzionalità supportata su Cloud Run.
  • Durante l'operazione di distacco, Cloud Run Functions modifica i trigger collegati alle funzioni configurate con nessun nuovo tentativo in caso di errore, per garantire che l'argomento Pub/Sub sottostante esegua un massimo di cinque tentativi di consegna. Al termine dell'operazione di distacco, un argomento coda messaggi non recapitabili memorizza i messaggi non consegnati, che puoi recuperare creando un nuovo abbonamento alla coda messaggi non recapitabili. Se vuoi utilizzare una chiave di crittografia gestita dal cliente per l'argomento DLQ, puoi aggiornare CMEK per l'argomento dopo il distacco.
• Quando una funzione viene scollegata correttamente, viene creata una nuova revisione Cloud Run. A partire da questa revisione, la funzione verrà fatturata utilizzando lo SKU Cloud Run.

Scollega la funzione

Puoi scollegare la funzione utilizzando il seguente comando:

gcloud functions detach FUNCTION_NAME

Sostituisci FUNCTION_NAME con il nome della funzione.