Release einführen

In diesem Dokument wird beschrieben, wie Sie einen Release mit App Lifecycle Manager einführen.

Mit App Lifecycle Manager können Sie Updates für mehrere bereitgestellte Einheiten mithilfe von Rollouts durchführen. Rollouts richten sich an Einheiten basierend auf ihrem UnitKind und können optional Filter (unit_filter) anwenden, um mit der Google Cloud CLI eine bestimmte Teilmenge von Einheiten anzusprechen . So können Sie verwaltete Updates für Ihre bereitgestellte Basis durchführen. Ein Rollback kann durchgeführt werden, indem Sie Einheiten auf einen früheren Release aktualisieren.

Für Vorgänge für eine einzelne, bestimmte Einheit verwenden Sie die Steuerelemente auf der Seite Einheitendetails.

Hinweis

Bevor Sie Ihr SaaS-Angebot aktualisieren, sollten Sie Folgendes tun:

Release erstellen

Bevor Sie Ihr SaaS-Angebot aktualisieren können, müssen Sie einen Release erstellen. Ein Release stellt eine bestimmte Version Ihrer SaaS-Anwendung dar, die durch ein Blueprint-Paket und die zugehörigen Konfigurationen definiert wird. Im Wesentlichen enthält ein Release das Update für Ihre Einheiten.

Console

  1. Rufen Sie App Lifecycle Manager auf.

    App Lifecycle Manager aufrufen

  2. Klicken Sie auf Releases.

  3. Klicken Sie auf der Seite Releases auf Erstellen.

  4. Auf der Seite Release erstellen:

    1. Geben Sie im Feld Release-Name einen eindeutigen Namen für den Release ein.
    2. Wählen Sie im Feld Art der Einheit die Art der Einheit aus, mit der dieser Release verknüpft ist.
    3. Im Abschnitt Nur Upgrade von (optional) können Sie optional Releases auswählen, von denen aus Einheiten auf diesen Release aktualisiert werden können. So können Sie Upgrade-Pfade steuern.
    4. Wählen oder erstellen Sie in den Schritten Blueprint erstellen und Blueprint speichern Ihren Blueprint aus. In der Blueprint-Dokumentation finden Sie detaillierte Informationen zu den Optionen zum Erstellen von Blueprints.

    5. Im Abschnitt Variablen (optional) können Sie optional Eingabevariablen für diesen Release festlegen. Weitere Informationen zum Festlegen von Variablen finden Sie in der Dokumentation zu Variablen.

  5. Klicken Sie auf Erstellen.

  6. Sie haben einen Release erstellt. Sie können die Releasedetails auf der Seite Releasedetails ansehen. Sie können auf diesen Release verweisen, wenn Sie einen Rollout erstellen.

gcloud

So erstellen Sie einen Release mit der Google Cloud Console:

gcloud beta saas-runtime releases create RELEASE_NAME --blueprint-package=BLUEPRINT_PACKAGE_URI --unit-kind=UNIT_KIND [--location=LOCATION] [--labels=[KEY=VALUE,...]] [--upgradeable-from-releases=[RELEASE_NAME,...]] [--input-variable-defaults=[variable=VARIABLE,value=VALUE,type=TYPE,...]]

Ersetzen Sie:

  • RELEASE_NAME: Die ID des Release, den Sie erstellen möchten. Dies ist Teil des vollständigen Ressourcennamens für den Release.
  • BLUEPRINT_PACKAGE_URI: Der URI des Blueprint-Pakets, das für diesen Release verwendet werden soll. Blueprints sind OCI-Images, die in Artifact Registry oder einer anderen OCI-Registrierung gehostet werden.
    • Das Blueprint-Paket enthält die Artefakte, die zum Bereitstellen einer Einheit erforderlich sind, sowie Metadaten zur verwendeten Engine (Terraform) und zur Version.
    • Wenn Sie den Hostnamen im URI weglassen, wird standardmäßig der regionale Artifact Registry-Pfad verwendet (z. B. us-east1-docker.pkg.dev).
    • Weitere Informationen zum Erstellen von Blueprints finden Sie in der Blueprint-Dokumentation.
  • UNIT_KIND: Die ID oder voll qualifizierte Kennung für die Art der Einheit, der dieser Release entspricht. UNIT_KIND ist nach dem Erstellen eines Release unveränderlich.
  • LOCATION: Der Standort, an dem Sie den Release erstellen möchten. Dieses Flag bietet einen Fallback-Wert für den Release-Standort, wenn der vollständige URI-Pfad nicht angegeben wird. Standardmäßig wird der in Ihrer Google Cloud CLI-Umgebung konfigurierte Standort verwendet.
  • LABELS: (Optional) Labels, die auf den Release angewendet werden sollen, um ihn zu kategorisieren. Labels sind Schlüssel/Wert-Paare.
    • Schlüssel müssen mit einem Kleinbuchstaben beginnen und dürfen nur Bindestriche, Unterstriche, Kleinbuchstaben und Ziffern enthalten.
    • Werte dürfen nur Bindestriche, Unterstriche, Kleinbuchstaben und Ziffern enthalten.
    • Beispiel: --labels=environment=staging,team=saas-runtime
  • UPGRADEABLE_FROM_RELEASES: (Optional) Eine durch Kommas getrennte Liste von Release-Namen, die angibt, welche vorhandenen Releases mit dem neuen Release aktualisiert werden können.
    • Wenn Sie dieses Flag leer lassen, gibt es keine Einschränkungen hinsichtlich der Releases, die auf diesen Release aktualisiert werden können.
    • Wenn angegeben, wird diese Einschränkung bei Anfragen zur Aktualisierung von Einheiten auf diesen Release erzwungen.
  • INPUT_VARIABLE_DEFAULTS: (Optional) Standardwerte für Eingabevariablen, die für den Blueprint erforderlich sind.
    • Sie können Standardwerte für Variablen inline oder durch Verweis auf eine YAML- oder JSON-Datei angeben.
    • Hier definierte Variablen können beim Erstellen des Rollouts überschrieben werden.

Weitere Informationen zum Festlegen von Variablen finden Sie in der Dokumentation zu Variablen. Weitere Informationen zu Releases finden Sie in der Release Google Cloud CLI-Referenz.

Roll-out-Art erstellen

Bevor Sie einen Rollout erstellen können, müssen Sie eine Roll-out-Art erstellen, die als Vorlage für die Bereitstellung Ihres Release für Ihre Einheiten dient.

Console

  1. Rufen Sie App Lifecycle Manager auf.

    App Lifecycle Manager aufrufen

  2. Klicken Sie auf Roll-out-Arten.

  3. Klicken Sie auf der Seite Roll-out-Arten auf Erstellen.

  4. Auf der Seite Roll-out-Art erstellen:

    1. Geben Sie im Feld Name der Roll-out-Art einen Namen für die Roll-out-Art ein.
    2. Wählen Sie im Feld Art der Einheit die Art der Einheit aus, für die der Release eingeführt werden soll.

    3. Wählen Sie in der Drop-down-Liste Roll-out-Strategie die Strategie aus, die Sie verwenden möchten, um den Release für Ihre Einheiten bereitzustellen:

      • Jeweils ein Standort (einfach): Aktualisiert jeweils einen Standort (ohne Wartezeiten). Aktualisiert bis zu 5% der Einheiten gleichzeitig.
      • Alle gleichzeitig (einfach): Der Rollout beginnt gleichzeitig an allen Standorten (ideal für Entwicklungsumgebungen und Notfallszenarien).
      • Progressiv (schrittweise): Führt Updates schrittweise in prozentualen Batches exponentiell an mehreren Standorten ein (mit Wartezeiten).
      • Progressiv (einzelner Standort): Aktualisiert Einheiten in prozentualen Batches mit längeren Wartezeiten, um Probleme an einem einzelnen Standort zu erkennen.

      Weitere Informationen zu Roll-out-Strategien finden Sie unter Roll-out-Strategien.

  5. Klicken Sie auf Erstellen.

  6. Sie haben eine Roll-out-Art erstellt. Auf der Seite Details zur Roll-out-Art können Sie die Parameter für die Roll-out-Art ansehen und bearbeiten.

gcloud

So erstellen Sie eine Roll-out-Art mit der Google Cloud Console:

  gcloud beta saas-runtime rollout-kinds create ROLLOUT_KIND_NAME --unit-kind=UNIT_KIND --location=LOCATION --rollout_strategy=ROLLOUT_STRATEGY --error_budget=ERROR_BUDGET --unit_filter=UNIT_FILTER --update_unit_kind_default=UPDATE_UNIT_KIND_DEFAULT

Ersetzen Sie:

  • ROLLOUT_KIND_NAME: Der Name der Roll-out-Art.
  • UNIT_KIND: Definiert, auf welche Einheiten Sie Releases anwenden möchten. Releases werden auf alle Einheiten der ausgewählten Art angewendet.
  • LOCATION: Der Standort, an dem Sie die Roll-out-Art erstellen möchten.

  • ROLLOUT_STRATEGY: Definiert die Roll-out-Strategie für die Roll-out-Art. Mögliche Werte:

    • Google.Cloud.Simple.OneLocationAtATime: Aktualisiert jeweils einen Standort (ohne Wartezeiten). Aktualisiert bis zu 5% der Einheiten gleichzeitig.
    • Google.Cloud.Simple.AllAtOnce: Der Rollout beginnt gleichzeitig an allen Standorten (ideal für Entwicklungsumgebungen und Notfallszenarien).
    • Google.Cloud.Progressive.Gradual.v1: Führt Updates schrittweise in prozentualen Batches exponentiell an mehreren Standorten ein (mit Wartezeiten).
    • Google.Cloud.Progressive.SingleLocation.v1: Aktualisiert Einheiten in prozentualen Batches mit längeren Wartezeiten, um Probleme an einem einzelnen Standort zu erkennen.

    Weitere Informationen zu Roll-out-Strategien finden Sie unter Roll-out-Strategien.

  • ERROR_BUDGET: Die Konfiguration für das Fehlerbudget. Wenn die Anzahl der fehlerhaften Einheiten das Maximum für error_budget überschreitet (definiert durch allowed_count, allowed_ratio * total_units), wird der Rollout pausiert. Wenn error_budget nicht festgelegt ist, versucht App Lifecycle Manager, alle Einheiten zu aktualisieren, unabhängig von der Anzahl der aufgetretenen Fehler.

  • UNIT_FILTER: CEL Im CEL-Format formatierte Filterstring, die auf Einheiten angewendet werden. Der Filter wird angewendet, um die infrage kommenden Einheiten zu bestimmen. Dieser Filter kann den Umfang des Rollouts nur verringern. Er kann den Umfang des Rollouts nicht erweitern.

  • UPDATE_UNIT_KIND_DEFAULT: Die Konfiguration zum Aktualisieren der Art der Einheit. Standardmäßig wird die Art der Einheit beim Start des Rollouts aktualisiert. Mögliche Werte:

    • UPDATE_UNIT_KIND_STRATEGY_UNSPECIFIED: Die Aktualisierungsstrategie für die Art der Einheit ist nicht angegeben.
    • UPDATE_UNIT_KIND_STRATEGY_ON_START: Aktualisieren Sie die Strategie für die Art der Einheit beim Start des Rollouts.
    • UPDATE_UNIT_KIND_STRATEGY_NEVER: Aktualisieren Sie die Strategie für die Art der Einheit nie.

Weitere Informationen finden Sie in der RolloutKind Google Cloud CLI-Referenz.

Funktion für das Fehlerbudget

App Lifecycle Manager enthält als Schutzmaßnahme eine Funktion für das Fehlerbudget (ErrorBudget in RolloutKind). Dadurch kann ein Rollout automatisch pausiert werden, wenn die Anzahl oder der Prozentsatz der Fehler bei der Aktualisierung von Einheiten (z. B. bei der Anwendung der Infrastruktur) einen konfigurierten Schwellenwert überschreitet. So können die Auswirkungen potenzieller Probleme während eines Updates begrenzt werden.

Roll-out erstellen

Nachdem Sie eine Roll-out-Art erstellt haben, können Sie einen Rollout erstellen, der den Release angibt, mit dem Sie Ihre Einheiten aktualisieren möchten.

Sobald der Rollout erstellt wurde, aktualisiert App Lifecycle Manager Ihre Einheiten gemäß der in der Art der Einheit definierten Strategie.

Console

  1. Rufen Sie App Lifecycle Manager auf.

    App Lifecycle Manager aufrufen

  2. Klicken Sie auf Rollouts.

  3. Klicken Sie auf der Seite Rollout-Liste auf Erstellen.

  4. Auf der Seite Roll-out erstellen:

    1. Wählen Sie im Feld Roll-out-Art die Roll-out-Art aus, die angibt, wie der Release für die angegebenen Einheiten eingeführt werden soll.
    2. Geben Sie im Feld Release den Release an, mit dem die Einheiten aktualisiert werden sollen.
    3. Geben Sie im Feld Rollout-Name einen Namen für den Rollout ein.

  5. Klicken Sie auf Erstellen.

  6. Der Rollout wurde erstellt.

    Auf der Seite Details zum globalen Rollout können Sie Rollout-Details wie den Rollout-Status, den Rollout-Fortschritt (nach Anzahl der Einheiten) und Rollout-Fehler beobachten.

gcloud

So erstellen Sie einen Rollout mit der Google Cloud Console:

  gcloud beta saas-runtime rollouts create ROLLOUT_NAME --rollout-kind=ROLLOUT_KIND_NAME --release=RELEASE_NAME --location=LOCATION

Ersetzen Sie:

  • ROLLOUT_NAME: Der Name des Rollouts.
  • ROLLOUT_KIND_NAME: Definiert, welche Roll-out-Art Sie verwenden möchten, um Releases auf Ihre Einheiten anzuwenden. Releases werden auf alle Einheiten der Art angewendet, die in der Roll-out-Art definiert ist.
  • RELEASE_NAME: Definiert die Release-Binärdatei, die Sie für Ihre Einheiten bereitstellen möchten.
  • LOCATION: Der Standort, an dem Sie den Rollout erstellen möchten.

Weitere Informationen finden Sie in der Rollout Google Cloud CLI-Referenz.

Nächste Schritte