Gestisci 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 Gestisci 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.

Puoi gestire le funzioni create utilizzando l'API Cloud Functions v2 (ad esempio utilizzando gcloud functions, l'API REST o Terraform) sia con l'API Cloud Run Admin che 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=nodejs22 \
    --source= . \
    --entry-point=ENTRYPOINT
    --trigger-http

gcloud run

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

Scollega una funzione

Il comando gcloud functions detach consente di scollegare una funzione Cloud Functions v2 dal suo ambiente API esistente. Dopo aver scollegato una funzione, puoi gestirla solo utilizzando l'API Cloud Run Admin. Questo può essere utile se i tuoi workload devono rimanere all'interno del confine dell'API run.googleapis.com per Assured Workloads o per assicurarti che i tuoi workload utilizzino lo SKU Cloud Run.

Prepara la funzione prima di scollegarla

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

• L'operazione di scollegamento non è reversibile.
• L'operazione di scollegamento non può essere applicata alle funzioni Cloud Run (1ª gen.).
• Acquisisci familiarità con il deployment delle 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 per Cloud Run.
  • Durante l'operazione di scollegamento, Cloud Run Functions modifica i trigger collegati alle funzioni configurate senza Riprova in caso di errore, per assicurare che l'argomento Pub/Sub sottostante esegua un massimo di cinque tentativi di consegna. Al termine dell'operazione di scollegamento, i messaggi non consegnati sono archiviati in un argomento coda messaggi non recapitabili e puoi recuperarli creando una nuova sottoscrizione alla coda messaggi non recapitabili.
• Quando una funzione viene scollegata correttamente, viene creata una nuova revisione Cloud Run. A partire da quella 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.