Manifeste in Google Cloud Deploy verwalten

Auf dieser Seite wird beschrieben, wie Google Cloud Deploy konfiguriert wird, um die Konfiguration für jedes Ziel in einer Bereitstellungspipeline zu rendern.

Google Cloud Deploy verwendet Skaffold, um Ihre Kubernetes-Manifeste zu rendern. Der Dienst unterstützt das Rendering von RAW-Manifesten und erweiterten Manifestverwaltungstools wie Helm, Kustomize und kpt.

Der Renderingprozess umfasst zwei Phasen:

  1. Das Manifest-Managementtool generiert das Manifest.

  2. Skaffold ersetzt die Image-Referenzen im Manifest durch die Images, die Sie in Ihrem Release bereitstellen möchten.

Diese Seite enthält Konfigurationsbeispiele mit Helm und Kustomize.

Skaffold zum Generieren der Konfiguration verwenden

Wenn Sie noch keine Skaffold-Konfigurationsdatei (skaffold.yaml) haben, können Sie basierend auf dem Inhalt Ihres Repositorys Skaffold verwenden.

  1. Installieren Sie Skaffold mit dem Cloud SDK:

    gcloud components install skaffold

  2. Führen Sie skaffold init in dem Repository aus, das Ihre Manifeste enthält:

    skaffold init --skip-build

Mit diesem Befehl wird eine skaffold.yaml-Datei in Ihrem Repository erstellt. Diese Datei verweist auf die Manifeste in diesem Repository. Dieser Inhalt sieht so aus:

apiVersion: skaffold/v2beta15
kind: Config
metadata:
 name: sample-app
deploy:
 kubectl:
   manifests:
   - k8s-manifests/deployment.yaml
   - k8s-manifests/rbac.yaml
   - k8s-manifests/redis.yaml
   - k8s-manifests/service.yaml

RAW-Manifeste rendern

Raw-Manifeste sind Manifeste, die nicht von einem Tool wie Helm oder Kustomize verwaltet werden und daher keine Vorverarbeitung erfordern, bevor sie in einem Cluster hydriert und in einem Cluster bereitgestellt werden.

Standardmäßig verwendet Google Cloud Deploy skaffold render zum Rendern Ihrer Kubernetes-Manifeste. Dabei werden nicht getaggte Image-Namen durch die getaggten Image-Namen der bereitgestellten Container-Images ersetzt. Wenn Sie dann den Release hochstufen, verwendet Google Cloud Deploy skaffold apply, um die Manifeste anzuwenden und die Images in Ihrem Google Kubernetes Engine-Cluster bereitzustellen.

Eine deploy-Stanza aus einer grundlegenden Konfiguration sieht so aus:

deploy:
  kubectl:
    manifests:
      - PATH_TO_MANIFEST

Weitere Informationen dazu, welche Werte hier übergeben werden können, finden Sie in der Skaffold-Dokumentation.

Rendering mit Helm

Sie können Google Cloud Deploy verwenden, um Ihre Helm-Diagramme zu rendern. Fügen Sie dazu Helm-Diagrammdetails in eine deploy-Stanza in einem Skaffold-Profil ein.

Jede Definition sieht so aus:

apiVersion: skaffold/v2beta16
kind: Config
deploy:
 helm:
   releases:
     - name: RELEASE_NAME
       chartPath: PATH_TO_HELM_CHART
       artifactOverrides:
         image: IMAGE_NAME

Wobei:

RELEASE_NAME ist der Name der Helm-Diagramminstanz für diesen Release.

PATH_TO_HELM_CHART ist der lokale Pfad zu einem gepackten Helm-Diagramm oder einem entpackten Helm-Diagrammverzeichnis.

IMAGE_NAME ist der Name des Container-Images, das Sie bereitstellen.

Ihr Helm-Diagramm muss einen Wert image-Parameter haben, der das im Diagramm bereitzustellende Image definiert.

Sie können zusätzliche Helm-Konfigurationsoptionen verwenden, wie in der Skaffold-Dokumentation beschrieben.

Rendering mit Kustomize

Sie können Kustomize mit Google Cloud Deploy verwenden. Verweisen Sie dazu auf die Kustomization-Dateien aus der deploy-Stanza in Ihrer skaffold.yaml-Profilkonfiguration.

Sie fügen eine separate Kustomize-Konfiguration für jedes Ziel hinzu, für das Sie Kustomize verwenden, und zwar unter jeder entsprechenden profile in Ihrer skaffold.yaml.

Jede Definition sieht so aus:

apiVersion: skaffold/v2beta16
kind: Config
metadata:
 name: getting-started-kustomize
deploy:
 kustomize:
   paths:
     - PATH_TO_KUSTOMIZE

Wobei:

PATH_TO_KUSTOMIZE verweist auf Ihre Kustomization-Dateien. Der Standardwert ist ["."]

Sie können zusätzliche Kustomize-Konfigurationsoptionen verwenden, wie in der Skaffold-Dokumentation beschrieben.

Unterschiedliche Manifeste pro Ziel konfigurieren

Oft erfordert jedes Ziel eine etwas andere Konfiguration. Beispielsweise können die Produktionsbereitstellungen mehr Replikate enthalten als die Staging-Bereitstellungen.

Sie können für jedes Ziel eine andere Gruppe von Manifesten rendern, indem Sie jede Variante als anderes Skaffold-Profil bereitstellen.

Profile mit RAW-Manifesten

Bei der Arbeit mit Rohmanifesten können Sie Google Cloud Deploy je nach Ziel auf eine andere Datei verweisen. Sie könnten sie so konfigurieren:

apiVersion: skaffold/v2beta16
kind: Config
metadata:
 name: getting-started-kustomize
profiles:
 - name: prod
   deploy:
     kubectl:
       manifests:
         - prod.yaml
 - name: staging
   deploy:
     kubectl:
       manifests:
         - staging.yaml

Profile mit Kustomize

Hier sehen Sie ein Beispiel-skaffold.yaml mit unterschiedlichen Profilen für Staging und Produktion mit Kustomize, wobei jedes Profil auf eine andere Kustomisierung verweist:

apiVersion: skaffold/v2beta16
kind: Config
profiles:
 - name: prod
   deploy:
     kustomize:
       paths:
         - environments/prod
 - name: staging
   deploy:
     kustomize:
       paths:
         - environments/staging

Profile, auf die in der Bereitstellungspipeline verwiesen wird

Auf diese in skaffold.yaml definierten Profile wird in der Konfiguration der Bereitstellungspipeline pro Ziel verwiesen:

serialPipeline:
 stages:
 - targetId: staging-target
   profiles:
   - staging
 - targetId: prod-target
   profiles:
   - prod

Nächste Schritte