Funktionen verwalten

In dieser Anleitung erfahren Sie, wie Sie eine Funktion verwalten und trennen, die mit dem Befehl gcloud functions erstellt wurde. Informationen zum Verwalten einer Funktion, die mit dem Befehl gcloud run erstellt wurde, finden Sie unter Cloud Run-Dienste verwalten.

Funktionen, die mit der Cloud Functions v2 API erstellt wurden (z. B. mit gcloud functions, der REST API oder Terraform), können sowohl mit der Cloud Run Admin API als auch mit der Cloud Functions v2 API verwaltet werden. Sie können eine vorhandene Funktion beispielsweise mit den Befehlen gcloud functions oder gcloud run aktualisieren:

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

Trennen

Mit dem Befehl gcloud functions detach können Sie eine Cloud Functions v2-Funktion von ihrer vorhandenen API-Umgebung trennen. Nachdem Sie eine Funktion abgetrennt haben, können Sie sie nur noch über die Cloud Run Admin API verwalten. Das kann sinnvoll sein, wenn Ihre Arbeitslasten innerhalb der run.googleapis.com API-Grenze für Assured Workloads bleiben müssen oder wenn Sie sicherstellen möchten, dass Ihre Arbeitslasten die Cloud Run-SKU verwenden.

Funktion für das Trennen vorbereiten

Beachten Sie bei der Vorbereitung des Trennens Ihrer Funktion Folgendes:

  • Das Trennen kann nicht rückgängig gemacht werden.
  • Der Vorgang zum Trennen kann nicht auf Cloud Run Functions der 1. Generation angewendet werden.
  • Machen Sie sich mit der Bereitstellung von Funktionen in Cloud Run mit der Google Cloud Console, der Google Cloud CLI und Terraform vertraut.
  • HTTP-Funktionen behalten ihre zugewiesenen URLs bei.
  • Trigger, die an ereignisgesteuerte Funktionen angehängt sind, bleiben erhalten.
  • Trigger können nicht direkt über die run.googleapis.com API verwaltet werden. Machen Sie sich mit den Anleitungen zur Triggerverwaltung für Eventarc oder Pub/Sub vertraut.
  • Das Deaktivieren von Wiederholung bei Fehler wird in Cloud Run nicht unterstützt.
    • Während des Trennvorgangs ändert Cloud Run Functions die Trigger, die an Funktionen angehängt sind, die mit no retry on failure konfiguriert sind. So wird sichergestellt, dass das zugrunde liegende Pub/Sub-Thema maximal fünf Zustellversuche unternimmt. Nach Abschluss des Vorgangs zum Trennen werden die nicht zugestellten Nachrichten in einem Thema für die Warteschlange für unzustellbare Nachrichten gespeichert. Sie können sie abrufen, indem Sie ein neues Abo für die Warteschlange für unzustellbare Nachrichten erstellen. Wenn Sie einen vom Kunden verwalteten Verschlüsselungsschlüssel für das DLQ-Thema verwenden möchten, können Sie CMEK für das Thema aktualisieren, nachdem Sie es getrennt haben.
  • Wenn eine Funktion erfolgreich getrennt wurde, wird eine neue Cloud Run-Überarbeitung erstellt. Ab dieser Revision wird die Funktion mit der Cloud Run-SKU abgerechnet.

Funktion trennen

Sie können die Funktion mit dem folgenden Befehl trennen:

gcloud functions detach FUNCTION_NAME

Ersetzen Sie FUNCTION_NAME durch den Namen Ihrer Funktion.