Déploiement Canary d'une application sur une cible
Ce guide de démarrage rapide explique comment utiliser Cloud Deploy pour fournir un exemple d'image d'application dans un déploiement Canary, sur Google Kubernetes Engine ou sur Cloud Run. (Vous pouvez également exécuter un déploiement Canary sur GKE Enterprise, mais seuls GKE et Cloud Run sont présentés dans ce guide de démarrage rapide.)
Un déploiement Canary répartit le trafic entre une version déjà déployée de l'application et la nouvelle version. Cloud Run répartit le trafic en fonction des pourcentages que vous configurez dans le pipeline de livraison. GKE déploie la nouvelle version sur une proportion de pods. Ce guide de démarrage rapide se déploie d'abord à 50 %, puis à 100%.
Dans ce guide de démarrage rapide, il n'y a qu'une seule cible (prod
). Nous ne créons donc qu'un seul cluster GKE ou un seul service Cloud Run pour exécuter votre application.
Dans ce guide de démarrage rapide, vous allez effectuer les opérations suivantes:
Créez un cluster GKE ou définissez un service Cloud Run.
Vous pouvez également effectuer un déploiement Canary sur des clusters GKE Enterprise, mais ce guide de démarrage rapide n'utilise que GKE et Cloud Run.
Créez une configuration Skaffold et un fichier manifeste Kubernetes pour spécifier l'image de conteneur (précompilée) à déployer.
Définissez votre pipeline de livraison Cloud Deploy et votre cible de déploiement.
Appelez votre pipeline de livraison en créant une version, qui se déploie automatiquement sur une cible.
Cette première version ignore la phase Canary.
Afficher le pipeline de livraison et sa version dans la console Google Cloud
Créez une deuxième version, en exécutant cette fois la phase Canary pour déployer l'application à 50%.
Faites passer la version à 100%.
Avant de commencer
- Connectez-vous à votre compte Google Cloud. Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits gratuits pour exécuter, tester et déployer des charges de travail.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Vérifiez que la facturation est activée pour votre projet Google Cloud.
-
Activer les API Cloud Deploy, Cloud Build, GKE, Cloud Run, and Cloud Storage.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Vérifiez que la facturation est activée pour votre projet Google Cloud.
-
Activer les API Cloud Deploy, Cloud Build, GKE, Cloud Run, and Cloud Storage.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
- Assurez-vous que le compte de service Compute Engine par défaut dispose des autorisations suffisantes.
Le compte de service dispose peut-être déjà des autorisations nécessaires. Ces étapes sont incluses pour les projets qui désactivent les attributions automatiques de rôles pour les comptes de service par défaut.
- Commencez par ajouter le rôle
clouddeploy.jobRunner
:gcloud projects add-iam-policy-binding PROJECT_ID \ --member=serviceAccount:$(gcloud projects describe PROJECT_ID \ --format="value(projectNumber)")-compute@developer.gserviceaccount.com \ --role="roles/clouddeploy.jobRunner"
- Ajoutez le rôle de développeur pour votre environnement d'exécution spécifique.
- Pour GKE et GKE avec l'API Gateway:
gcloud projects add-iam-policy-binding PROJECT_ID \ --member=serviceAccount:$(gcloud projects describe PROJECT_ID \ --format="value(projectNumber)")-compute@developer.gserviceaccount.com \ --role="roles/container.developer"
- Pour Cloud Run:
gcloud projects add-iam-policy-binding PROJECT_ID \ --member=serviceAccount:$(gcloud projects describe PROJECT_ID \ --format="value(projectNumber)")-compute@developer.gserviceaccount.com \ --role="roles/run.developer"
-
Ajoutez le rôle
iam.serviceAccountUser
, qui inclut l'autorisationactAs
permettant de déployer dans l'environnement d'exécution:gcloud iam service-accounts add-iam-policy-binding $(gcloud projects describe PROJECT_ID \ --format="value(projectNumber)")-compute@developer.gserviceaccount.com \ --member=serviceAccount:$(gcloud projects describe PROJECT_ID \ --format="value(projectNumber)")-compute@developer.gserviceaccount.com \ --role="roles/iam.serviceAccountUser" \ --project=PROJECT_ID
- Commencez par ajouter le rôle
Si la CLI est déjà installée, assurez-vous d'utiliser la dernière version:
gcloud components update
Créer votre environnement d'exécution
GKE
Créez un cluster GKE Autopilot:
gcloud container clusters create-auto canary-quickstart-cluster \
--project=PROJECT_ID \
--region=us-central1
GKE + API Gateway
Créez un cluster GKE en utilisant les paramètres recommandés pour Istio:
gcloud container clusters create canary-quickstart-cluster \ --machine-type=n1-standard-1 \ --num-nodes 4 \ --region=us-central1 \ --project=PROJECT_ID
Obtenez les identifiants du cluster :
gcloud container clusters get-credentials canary-quickstart-cluster \ --project=PROJECT_ID \ --region=us-central1
Installez les CRD de l'API Kubernetes Gateway si elles ne sont pas déjà présentes sur le cluster.
kubectl apply -f https://github.com/kubernetes-sigs/gateway-api/releases/download/v0.6.2/standard-install.yaml
Activez la mise en œuvre du contrôleur de passerelle d'Istio en installant Istio.
curl -L https://istio.io/downloadIstio | ISTIO_VERSION=1.17.2 sh - \ && ./istio-1.17.2/bin/istioctl install --set profile=minimal -y
Cloud Run
Si vous utilisez Cloud Run, vous pouvez ignorer cette commande. Aucune action n'est requise de votre part.
Préparer la configuration Skaffold et le fichier manifeste de l'application
Cloud Deploy utilise Skaffold pour fournir les détails des éléments à déployer et comment les déployer correctement sur votre cible.
Dans ce guide de démarrage rapide, vous allez créer un fichier skaffold.yaml
qui identifie le fichier manifeste Kubernetes ou la configuration du service Cloud Run à déployer.
Ouvrez une fenêtre de terminal.
Créez un répertoire et accédez-y.
GKE
mkdir deploy-canary-quickstart-gke cd deploy-canary-quickstart-gke
GKE + API Gateway
mkdir deploy-canary-quickstart-gke-gatewayapi cd deploy-canary-quickstart-gke-gatewayapi
Cloud Run
mkdir deploy-canary-quickstart-run cd deploy-canary-quickstart-run
Créez un fichier nommé
skaffold.yaml
avec le contenu suivant :GKE
apiVersion: skaffold/v4beta7 kind: Config manifests: rawYaml: - kubernetes.yaml deploy: kubectl: {}
GKE + API Gateway
apiVersion: skaffold/v4beta7 kind: Config manifests: rawYaml: - kubernetes.yaml deploy: kubectl: {}
Cloud Run
apiVersion: skaffold/v4beta7 kind: Config manifests: rawYaml: - run.yaml deploy: cloudrun: {}
Ce fichier est une configuration Skaffold minimale, qui identifie votre fichier manifeste. Pour ce guide de démarrage rapide, vous allez créer le fichier. Mais vous pouvez également demander à Cloud Deploy d'en créer un pour vous, pour les applications simples hors production.
Pour en savoir plus sur ce fichier, consultez la documentation de référence sur
skaffold.yaml
.Créez le fichier manifeste de votre application.
GKE
Créez un fichier nommé
kubernetes.yaml
dans le répertoiredeploy-canary-quickstart-gke
avec le contenu suivant:apiVersion: apps/v1 kind: Deployment metadata: name: my-deployment labels: app: my-app namespace: default spec: replicas: 1 selector: matchLabels: app: my-app template: metadata: labels: app: my-app spec: containers: - name: nginx image: my-app-image --- apiVersion: v1 kind: Service metadata: name: my-service namespace: default spec: selector: app: my-app ports: - protocol: TCP port: 80
Ce fichier est un fichier manifeste Kubernetes simple, qui est appliqué au cluster pour déployer l'application.
GKE + API Gateway
Créez un fichier nommé
kubernetes.yaml
dans le répertoiredeploy-canary-quickstart-gke-gatewayapi
avec le contenu suivant:kind: Gateway apiVersion: gateway.networking.k8s.io/v1beta1 metadata: name: my-gateway annotations: networking.istio.io/service-type: "ClusterIP" spec: gatewayClassName: istio listeners: - name: default hostname: "*.example.com" port: 80 protocol: HTTP allowedRoutes: namespaces: from: All --- kind: HTTPRoute apiVersion: gateway.networking.k8s.io/v1beta1 metadata: name: my-httproute spec: parentRefs: - kind: Gateway name: my-gateway hostnames: - "test.example.com" rules: - backendRefs: - name: my-service port: 80 --- apiVersion: v1 kind: Service metadata: name: my-service spec: selector: app: my-app ports: - name: tcp-port protocol: TCP port: 80 targetPort: 8080 --- apiVersion: apps/v1 kind: Deployment metadata: name: my-deployment labels: app: my-app spec: replicas: 1 selector: matchLabels: app: my-app template: metadata: labels: app: my-app spec: containers: - name: nginx image: my-app-image
Ce fichier est un fichier manifeste Kubernetes, qui est appliqué au cluster pour déployer l'application. Ce fichier manifeste inclut les ressources de service et de déploiement requises pour le déploiement Canary, ainsi qu'une ressource HTTPRoute et la ressource Gateway requise pour l'utilisation de l'API Gateway.
Cloud Run
Créez un fichier nommé
run.yaml
dans le répertoiredeploy-canary-quickstart-run
avec le contenu suivant:apiVersion: serving.knative.dev/v1 kind: Service metadata: name: my-canary-run-service spec: template: spec: containers: - image: my-app-image
Ce fichier est un fichier de configuration du service Cloud Run, qui est appliqué au moment du déploiement pour créer votre service dans Cloud Run.
Créer votre pipeline de livraison et vos cibles
Vous pouvez définir votre pipeline de livraison et vos cibles dans un ou plusieurs fichiers distincts. Dans ce guide de démarrage rapide, nous créons un fichier pour notre pipeline et notre cible unique:
GKE
Créez un fichier nommé clouddeploy.yaml
dans le répertoire deploy-canary-quickstart-gke
avec le contenu suivant:
apiVersion: deploy.cloud.google.com/v1
kind: DeliveryPipeline
metadata:
name: my-canary-demo-app-1
description: main application pipeline
serialPipeline:
stages:
- targetId: prod
profiles: []
strategy:
canary:
runtimeConfig:
kubernetes:
serviceNetworking:
service: "my-service"
deployment: "my-deployment"
canaryDeployment:
percentages: [50]
verify: false
---
apiVersion: deploy.cloud.google.com/v1
kind: Target
metadata:
name: prod
description: prod GKE cluster
gke:
cluster: projects/PROJECT_ID/locations/us-central1/clusters/canary-quickstart-cluster
GKE + API Gateway
Créez un fichier nommé clouddeploy.yaml
dans le répertoire deploy-canary-quickstart-gke-gatewayapi
avec le contenu suivant:
apiVersion: deploy.cloud.google.com/v1
kind: DeliveryPipeline
metadata:
name: my-canary-demo-app-1
description: main application pipeline
serialPipeline:
stages:
- targetId: prod
profiles: []
strategy:
canary:
runtimeConfig:
kubernetes:
gatewayServiceMesh:
httpRoute: "my-httproute"
service: "my-service"
deployment: "my-deployment"
canaryDeployment:
percentages: [50]
verify: false
---
apiVersion: deploy.cloud.google.com/v1
kind: Target
metadata:
name: prod
description: prod GKE cluster
gke:
cluster: projects/PROJECT_ID/locations/us-central1/clusters/canary-quickstart-cluster
Cloud Run
Dans le répertoire deploy-canary-quickstart-run
, créez un fichier nommé clouddeploy.yaml
avec le contenu suivant:
apiVersion: deploy.cloud.google.com/v1
kind: DeliveryPipeline
metadata:
name: my-canary-demo-app-1
description: main application pipeline
serialPipeline:
stages:
- targetId: prod
profiles: []
strategy:
canary:
runtimeConfig:
cloudRun:
automaticTrafficControl: true
canaryDeployment:
percentages: [50]
verify: false
---
apiVersion: deploy.cloud.google.com/v1
kind: Target
metadata:
name: prod
description: prod Run Service
run:
location: projects/PROJECT_ID/locations/us-central1
Enregistrez votre pipeline et vos cibles avec le service Cloud Deploy:
gcloud deploy apply --file=clouddeploy.yaml --region=us-central1 --project=PROJECT_ID
Vous disposez maintenant d'un pipeline, avec une cible configurée pour une stratégie de déploiement Canary.
Confirmez votre pipeline et vos cibles:
Dans la console Google Cloud, accédez à la page Pipelines de livraison de Cloud Deploy pour afficher la liste des pipelines de livraison disponibles.
Ouvrir la page Pipelines de diffusion
Le pipeline de livraison que vous venez de créer s'affiche, et la cible que vous avez configurée est répertoriée dans la colonne Cibles.
Créer une version
Une version est la ressource Cloud Deploy centrale qui représente les modifications en cours de déploiement. Le pipeline de livraison définit le cycle de vie de cette version. Pour en savoir plus sur ce cycle de vie, consultez la section Architecture du service Cloud Deploy.
Pour créer une ressource release
qui représente l'image de conteneur à déployer, exécutez la commande suivante à partir du répertoire deploy-canary-quickstart-gke
, deploy-canary-quickstart-gke-gatewayapi
ou deploy-canary-quickstart-run
:
GKE
gcloud deploy releases create test-release-001 \
--project=PROJECT_ID \
--region=us-central1 \
--delivery-pipeline=my-canary-demo-app-1 \
--images=my-app-image=gcr.io/google-containers/nginx@sha256:f49a843c290594dcf4d193535d1f4ba8af7d56cea2cf79d1e9554f077f1e7aaa
GKE + API Gateway
gcloud deploy releases create test-release-001 \
--project=PROJECT_ID \
--region=us-central1 \
--delivery-pipeline=my-canary-demo-app-1 \
--images=my-app-image=gcr.io/google-containers/nginx@sha256:f49a843c290594dcf4d193535d1f4ba8af7d56cea2cf79d1e9554f077f1e7aaa
Cloud Run
gcloud deploy releases create test-release-001 \
--project=PROJECT_ID \
--region=us-central1 \
--delivery-pipeline=my-canary-demo-app-1 \
--images=my-app-image=us-docker.pkg.dev/cloudrun/container/hello@sha256:6063adf8f687702b4065151acddba6781c47bc602167eb9f3bec8aebc9ce95cc
Lorsque vous créez une version, Cloud Deploy crée automatiquement une ressource de déploiement pour le déployer immédiatement sur votre cible, prod
.
Nous passons à la phase stable
Avec cette première version, nous ignorons la phase Canary et effectuons le déploiement à 100% (phase stable). En effet, l'application n'a pas été déployée précédemment. Il est donc impossible de calculer 50% des pods (pour GKE) ou la répartition du trafic pour le service (pour Cloud Run). Les pods (GKE) ou les révisions (Cloud Run) n'existent pas encore.
Après avoir ignoré la phase Canary, nous sommes prêts à démarrer la phase stable, qui amène le trafic à 100%. Après cela, nous allons créer une autre version, qui exécutera la Canary.
Dans une situation réelle, vous exécuterez généralement un déploiement Canary dans lequel votre application est déjà en cours d'exécution. Cet omission de phase est donc rare.
Afficher la version dans la console Google Cloud
Maintenant que vous avez créé la première version, le déploiement est créé. Vous pouvez consulter la version et son déploiement dans la console Google Cloud. Vous pouvez également afficher la visualisation du pipeline, qui indique l'état actuel de la version.
Dans la console Google Cloud, accédez à la page Pipelines de livraison de Cloud Deploy pour afficher votre pipeline de livraison my-canary-demo-app-1.
Cliquez sur le nom de votre pipeline de livraison "my-canary-demo-app-1".
La visualisation du pipeline montre l'état du déploiement de l'application. Étant donné qu'il n'y a qu'une seule étape dans le pipeline, la visualisation ne montre qu'un seul nœud.
Votre version est répertoriée dans l'onglet Versions sous Détails du pipeline de diffusion.
Cliquez sur le nom de la version,
test-release-001
.Les déploiements s'affichent sous Déploiements. Vous pouvez cliquer sur un déploiement pour afficher ses détails, y compris le journal de déploiement.
Notez que l'état du déploiement est "Avancement en attente" et que la cible affichée dans la visualisation du pipeline contient un lien "Passer à la version stable".
Avancer la phase de déploiement
Après la première version, la phase Canary a été ignorée, et le déploiement attend le lancement de la phase "stable", qui déploie l'application à 100%:
Dans la visualisation du pipeline, cliquez sur Passer à la version stable.
Lorsque vous y êtes invité, cliquez sur Avancer pour confirmer.
Après quelques minutes, le déploiement est passé en phase "stable" et l'application est déployée à 100%.
Exécuter le déploiement Canary
Étant donné que la première version a ignoré la phase Canary, nous allons maintenant créer une autre version qui, cette fois, exécute un déploiement Canary.
Pour créer un
release
, exécutez la commande suivante à partir du répertoiredeploy-canary-quickstart-gke
,deploy-canary-quickstart-gke-gatewayapi
oudeploy-canary-quickstart-run
:GKE
gcloud deploy releases create test-release-002 \ --project=PROJECT_ID \ --region=us-central1 \ --delivery-pipeline=my-canary-demo-app-1 \ --images=my-app-image=gcr.io/google-containers/nginx@sha256:f49a843c290594dcf4d193535d1f4ba8af7d56cea2cf79d1e9554f077f1e7aaa
GKE + API Gateway
gcloud deploy releases create test-release-002 \ --project=PROJECT_ID \ --region=us-central1 \ --delivery-pipeline=my-canary-demo-app-1 \ --images=my-app-image=gcr.io/google-containers/nginx@sha256:f49a843c290594dcf4d193535d1f4ba8af7d56cea2cf79d1e9554f077f1e7aaa
Cloud Run
gcloud deploy releases create test-release-002 \ --project=PROJECT_ID \ --region=us-central1 \ --delivery-pipeline=my-canary-demo-app-1 \ --images=my-app-image=us-docker.pkg.dev/cloudrun/container/hello@sha256:6063adf8f687702b4065151acddba6781c47bc602167eb9f3bec8aebc9ce95cc
Après quelques minutes, un déploiement est créé et, cette fois, la phase Canary est exécutée:
Une fois la première phase de déploiement terminée, le déploiement est en phase Canary:
Cela signifie que l'application est maintenant déployée à 50%. Pour GKE basé sur serviceNetworking, il est déployé sur la moitié de vos pods. Pour les API Gateway, le trafic GKE et Cloud Run est alloué à 50%.
Cliquez sur Avancer le déploiement, puis sur Avancer lorsque vous y êtes invité.
Le déploiement passe alors à la phase "stable", qui consiste à déployer l'application à 100%.
Effectuer un nettoyage
Pour éviter que les ressources utilisées sur cette page soient facturées sur votre compte Google Cloud, procédez comme suit :
Supprimez le cluster
canary-quickstart-cluster
(GKE uniquement):gcloud container clusters delete canary-quickstart-cluster --region=us-central1 --project=PROJECT_ID
Supprimez le service
my-canary-run-service
(Cloud Run uniquement):gcloud run services delete my-canary-run-service --region=us-central1 --project=PROJECT_ID
Supprimez le pipeline de livraison, la cible et toutes les ressources de publication et de déploiement:
gcloud deploy delete --file=clouddeploy.yaml --force --region=us-central1 --project=PROJECT_ID
Supprimez les buckets Cloud Storage créés par Cloud Deploy.
L'une se termine par
_clouddeploy
, l'autre se termine par[region].deploy-artifacts.[project].appspot.com
.
Voilà ! Vous avez terminé le guide de démarrage rapide.