Benutzerdefinierte Canary-Deployments

In diesem Dokument wird beschrieben, wie Sie benutzerdefinierte Canary-Bereitstellungen konfigurieren und verwenden, um Ihre Anwendungen mit Cloud Deploy in alle Zieltypen bereitzustellen.

Funktionsweise von benutzerdefinierten Canary-Bereitstellungen

Wenn Sie die Bereitstellung mit einer benutzerdefinierten Canary-Bereitstellungsstrategie vornehmen, ändert Cloud Deploy Ihre Manifeste nicht, um die ausgewählte Konfiguration für den Lastausgleich zu ermöglichen. Stattdessen sind Sie dafür verantwortlich, Manifeste bereitzustellen, die für jede Canary-Phase auf Ihre Ziel-Laufzeit angewendet werden.

Sie müssen die erforderlichen Berechtigungen haben.

Zusätzlich zu anderen Identity and Access Management-Berechtigungen, die Sie für die Verwendung von Cloud Deploy benötigen, sind die folgenden Berechtigungen erforderlich, um zusätzliche Aktionen auszuführen, die möglicherweise für eine Canary-Bereitstellung erforderlich sind:

  • clouddeploy.rollouts.advance
  • clouddeploy.rollouts.ignoreJob
  • clouddeploy.rollouts.cancel
  • clouddeploy.rollouts.retryJob
  • clouddeploy.jobRuns.get
  • clouddeploy.jobRuns.list
  • clouddeploy.jobRuns.terminate

Weitere Informationen dazu, welche verfügbaren Rollen diese Berechtigungen enthalten, finden Sie unter IAM-Rollen und -Berechtigungen.

skaffold.yaml vorbereiten

In der skaffold.yaml-Datei wird definiert, wie Ihre Manifeste gerendert und bereitgestellt werden. Bei einer benutzerdefinierten Canary-Bereitstellung müssen Sie Profile definieren, die den einzelnen Canary-Phasen zugeordnet sind, um die ausgewählte Konfiguration für den Lastausgleich zu ermöglichen. Diese Profile werden Phasen in der Konfiguration der Bereitstellungspipeline-Strategie zugeordnet.

Hier sehen Sie ein Beispiel für eine skaffold.yaml-Konfiguration, die von einem benutzerdefinierten Canary verwendet wird:

apiVersion: skaffold/v4beta7
kind: Config
profiles:
- name: canary-25
  manifests:
    rawYaml:
    - canary-25-resources.yaml
- name: canary-50
  manifests:
    rawYaml:
    - canary-50-resources.yaml
- name: stable
  manifests:
    rawYaml:
    - stable-resources.yaml

Benutzerdefiniertes Canary-Release konfigurieren

Mit der benutzerdefinierten Canary-Konfiguration geben Sie in der Definition Ihrer Bereitstellungspipeline Folgendes an:

  • Namen der Roll-out-Phasen

    Bei einem vollständig automatisierten Canary-Release benennt Cloud Deploy die Phasen für Sie (z. B. canary-25, canary-75, stable). Bei einem benutzerdefinierten Canary können Sie jeder Phase einen beliebigen Namen geben, solange er unter allen Phasen für diese Canary-Phase eindeutig ist und die Einschränkungen für Ressourcen-IDs eingehalten werden. Der Name der letzten Phase (100%) muss stable sein.

  • Prozentuale Ziele für jede Phase

    Geben Sie die Prozentsätze für jede Phase separat an.

  • Skaffold-Profile, die für die Phase verwendet werden sollen

    Sie können für jede Phase ein separates Skaffold-Profil verwenden oder dasselbe Profil oder eine beliebige Kombination. Jedes Profil kann eine andere Cloud Run-Dienstdefinition verwenden. Sie können auch mehrere Profile für eine bestimmte Phase verwenden. Cloud Deploy kombiniert sie.

  • Gibt an, ob es einen Bestätigungsjob für die Phase gibt.

  • Ob es Jobs vor oder nach der Bereitstellung für die Phase gibt

Benutzerdefinierte Elemente der Canary-Konfiguration

Das folgende YAML zeigt die Konfiguration für die Phasen der vollständig benutzerdefinierten Canary-Bereitstellung:

strategy:
  canary:
    # Custom configuration for each canary phase
    customCanaryDeployment:
      phaseConfigs:
      - phaseId: "PHASE1_NAME"
        percentage: PERCENTAGE1
        profiles: [ "PROFILE_NAME" ]
        verify:
          tasks: [TASKS]
        predeploy:
          tasks: [TASKS]
        postdeploy:
          tasks: [TASKS]
      - …
      - phaseId: "stable"
        percentage: 100
        profiles: [ "LAST_PROFILE_NAME" ]
        verify:
          tasks: [TASKS]
        predeploy:
          tasks: [TASKS]
        postdeploy:
          tasks: [TASKS]

In diesem YAML

  • PHASE1_NAME

    Ist der Name der Phase. Jeder Phasenname muss eindeutig sein.

  • [ "PROFILE_NAME" ]

    Ist der Name des Profils, das für die Phase verwendet werden soll. Sie können für jede Phase dasselbe Profil oder für jede Phase ein anderes Profil verwenden oder eine beliebige Kombination. Sie können auch mehrere Profile angeben. Cloud Deploy verwendet alle von Ihnen angegebenen Profile sowie das Profil oder Manifest, das für die gesamte Phase verwendet wird.

  • stable

    Die letzte Phase muss stable heißen.

  • PERCENTAGE1

    Der Prozentsatz, der für die erste Phase bereitgestellt werden soll. Jede Phase muss einen eindeutigen Prozentwert haben, der eine ganze Zahl sein muss (z. B. nicht 10.5). Die Phasen müssen in aufsteigender Reihenfolge angegeben werden.

  • Sie können die Deployment-Überprüfung aktivieren, indem Sie den verify-Abschnitt konfigurieren. Wenn Sie dies tun, wird der Phase ein verify-Job hinzugefügt.

  • Sie können Hooks vor der Bereitstellung aktivieren, indem Sie den predeploy-Abschnitt konfigurieren. Wenn Sie dies tun, wird der Phase ein predeploy-Job hinzugefügt.

  • Sie können Hooks nach der Bereitstellung aktivieren, indem Sie den postdeploy-Abschnitt konfigurieren. Wenn Sie dies tun, wird der Phase ein postdeploy-Job hinzugefügt.

  • Das Attribut tasks unter verify, predeploy und postdeploy besteht aus einer oder mehreren Aufgaben, die als Teil dieses Jobs ausgeführt werden sollen. Alle konfigurierten Aufgaben werden sequenziell in der Reihenfolge ausgeführt, in der sie definiert sind.

Der Prozentsatz für die letzte Phase muss 100 sein. Phasen werden in der Reihenfolge ausgeführt, in der Sie sie in diesem customCanaryDeployment-Abschnitt konfigurieren. Wenn die Prozentwerte jedoch nicht in aufsteigender Reihenfolge angegeben sind, schlägt der Befehl zum Registrieren der Bereitstellungspipeline mit einem Fehler fehl.

Die Konfiguration für einen benutzerdefinierten Canary-Release enthält keinen runtimeConfig-Abschnitt. Wenn Sie runtimeConfig angeben, wird das als benutzerdefinierter automatisierter Canary betrachtet.

Nächste Schritte