Décrire et lister les déploiements bleu-vert

MySQL | PostgreSQL | SQL Server

Aperçu

Cette fonctionnalité est soumise aux "Conditions des offres de pré-DG" de la section "Conditions générales du service" des Conditions spécifiques du service. Les fonctionnalités pré-DG sont disponibles "en l'état" et peuvent avoir une prise en charge limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Ce document explique comment lister et décrire les déploiements bleu-vert Cloud SQL, inspecter les détails de connexion et les différences de configuration, et se connecter à l'environnement de staging vert pour tester et valider vos charges de travail.

Avant de commencer

Pour lister ou décrire un déploiement bleu-vert et vous connecter à l'instance de préproduction verte, vérifiez que vous disposez des rôles et des identifiants de base de données requis.

Rôles et autorisations nécessaires

Pour obtenir les autorisations nécessaires pour lister et décrire les déploiements bleu-vert, demandez à votre administrateur de vous accorder les rôles IAM suivants sur votre projet :

• Lecteur Cloud SQL (roles/cloudsql.viewer)
• Éditeur Cloud SQL (roles/cloudsql.editor)
• Administrateur Cloud SQL (roles/cloudsql.admin)

Pour les rôles personnalisés, assurez-vous de disposer des autorisations suivantes :

• cloudsql.blueGreenDeployments.get
• cloudsql.blueGreenDeployments.list

Pour vous connecter à l'instance de préproduction "verte" et exécuter des requêtes de test, vous avez également besoin d'identifiants d'utilisateur de base de données configurés sur l'instance source.

Pour en savoir plus sur les rôles et les autorisations IAM dans Cloud SQL, consultez Rôles et autorisations.

Présentation

La commande "describe" vous permet de surveiller et de suivre l'état d'un déploiement bleu-vert Cloud SQL à tout moment de son cycle de vie, de l'approvisionnement et de la préparation initiaux à la fin du basculement.

La description d'un déploiement bleu-vert permet d'obtenir des informations sur les éléments suivants :

• État du cycle de vie du déploiement : surveillez l'état en temps réel de votre déploiement lorsqu'il passe par des états tels que PROVISIONING, SWITCHOVER_READY, SWITCHOVER_NOT_READY, SWITCHOVER_IN_PROGRESS et SWITCHOVER_COMPLETED.
• Détails de la connexion à l'instance cible : récupérez le nom de connexion unique et les points de terminaison réseau pour l'instance de préproduction verte. Les administrateurs de bases de données (DBA) et les ingénieurs QA peuvent ainsi connecter des applications, exécuter des requêtes de test et valider les performances sur l'instance verte sans affecter le trafic de production bleu en direct.
• État de la réplication et préparation au basculement : vérifiez que la réplication logique continue du bleu au vert est saine et examinez les détails des erreurs de diagnostic en cas de problème. Notez que la description d'un déploiement n'indique pas le décalage de réplication.
• Différences de configuration : lorsque vous demandez la vue détaillée, examinez une comparaison côte à côte (diffs) des versions de base de données, des niveaux de machine, des paramètres de stockage et des configurations de haute disponibilité entre les instances bleue et verte.

Lister les déploiements bleu-vert

Pour lister les déploiements bleu-vert dans un projet :

Console

1. Dans la console Google Cloud , accédez à la page Instances Cloud SQL.

   Accéder à la page Instances Cloud SQL

2. Dans la liste des instances, consultez la colonne ID de déploiement bleu-vert pour afficher les déploiements bleu-vert associés à vos instances. Les instances qui font partie d'un déploiement bleu-vert affichent également un tag de rôle (Bleu, Vert, Ancien bleu ou Nouveau bleu) à côté de leur nom.

gcloud

Pour lister les déploiements bleu-vert à l'aide de gcloud, exécutez la commande blue-green-deployments list :

gcloud beta sql blue-green-deployments list \
  --region=REGION

Pour lister les déploiements dans toutes les régions de votre projet, omettez l'indicateur --region.

REST v1

Pour lister les déploiements à l'aide de l'API Cloud SQL Admin, envoyez une requête GET à la méthode blueGreenDeployments.list :

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/
  locations/REGION/blueGreenDeployments

REST v1beta4

Pour lister les déploiements à l'aide de l'API Cloud SQL Admin, envoyez une requête GET à la méthode blueGreenDeployments.list :

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/
  locations/REGION/blueGreenDeployments

Décrire le déploiement bleu-vert

Pour inspecter l'état du déploiement et obtenir les détails de connexion à l'instance verte, décrivez le déploiement :

Console

1. Dans la console Google Cloud , accédez à la page Instances Cloud SQL.

   Accéder à la page Instances Cloud SQL

2. Pour ouvrir la page Vue d'ensemble du déploiement, effectuez l'une des opérations suivantes :
   • Dans la colonne ID de déploiement bleu-vert, cliquez sur l'ID de déploiement.
   • Cliquez sur le nom de l'instance pour ouvrir la page Présentation, puis, dans la fiche État du déploiement bleu/vert, cliquez sur Détails.
3. Sur la page Présentation du déploiement, examinez la fiche Détails du déploiement pour inspecter l'état, l'instance source, l'instance cible, le point de terminaison de l'instance cible et la version cible du déploiement, puis examinez la fiche Progression du déploiement pour inspecter l'état des tâches.

gcloud

Pour décrire un déploiement à l'aide de gcloud, exécutez la commande blue-green-deployments describe :

gcloud beta sql blue-green-deployments describe DEPLOYMENT_NAME \
  --region=REGION

Remplacez les éléments suivants :

• DEPLOYMENT_NAME : nom de votre déploiement bleu-vert.
• REGION : région Google Cloud dans laquelle le déploiement a été créé.

REST v1

Pour décrire un déploiement à l'aide de l'API Cloud SQL Admin, envoyez une requête GET à la méthode blueGreenDeployments.get :

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/
  locations/REGION/
  blueGreenDeployments/DEPLOYMENT_NAME

REST v1beta4

Pour décrire un déploiement à l'aide de l'API Cloud SQL Admin, envoyez une requête GET à la méthode blueGreenDeployments.get :

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/
  locations/REGION/
  blueGreenDeployments/DEPLOYMENT_NAME

Inspecter l'état et les informations de connexion

Dans le résultat de la commande, vérifiez l'état du déploiement et recherchez les informations de connexion pour l'instance verte cible :

name: projects/my-project/locations/us-central1/
  blueGreenDeployments/my-deployment
createTime: '2026-08-13T10:00:00.000Z'
state: SWITCHOVER_READY
sourceInstance: my-source-instance
switchoverTargetInstance: my-target-instance
requestedConfig:
  databaseVersion: MYSQL_8_4
deploymentMappings:
- source:
    connection: my-project:us-central1:my-source-instance
    dns: my-source-instance.123456789012.us-central1.sql.goog.
    instance: projects/my-project/instances/my-source-instance
    ipAddresses:
    - ipAddress: 10.0.0.1
      type: PRIMARY
  state: PROVISIONED
  target:
    connection: my-project:us-central1:my-target-instance
    dns: my-target-instance.123456789012.us-central1.sql.goog.
    instance: projects/my-project/instances/my-target-instance
    ipAddresses:
    - ipAddress: 10.0.0.2
      type: PRIMARY
  tasks:
  - type: PROVISION
    state: SUCCEEDED
    startTime: '2026-08-13T10:00:00.000Z'
    endTime: '2026-08-13T10:15:00.000Z'
deploymentTasks:
- type: PROVISION
  state: SUCCEEDED
  startTime: '2026-08-13T10:00:00.000Z'
  endTime: '2026-08-13T10:15:00.000Z'

Examinez les champs suivants dans la réponse :

• name : chemin d'accès complet à la ressource du déploiement au format projects/PROJECT_ID/locations/REGION/blueGreenDeployments/DEPLOYMENT_NAME.
• createTime : code temporel de la création du déploiement.
• state : état général du cycle de vie du déploiement :
  • PROVISIONING : le déploiement provisionne l'environnement vert et configure la réplication.
  • SWITCHOVER_READY : la préparation est terminée, la réplication logique est opérationnelle et le déploiement est prêt pour le basculement. Vérifiez cet état avant d'exécuter les tests.
  • SWITCHOVER_NOT_READY : le déploiement n'est pas prêt pour le basculement. Consultez errorDetail pour le dépannage.
  • SWITCHOVER_IN_PROGRESS : une opération de permutation est en cours d'exécution.
  • SWITCHOVER_COMPLETED : le basculement s'est terminé avec succès et l'instance verte diffuse désormais le trafic de production en tant qu'instance active de lecture et d'écriture.
  • DELETING : la ressource de déploiement est en cours de suppression.
• sourceInstance : identifiant de l'instance de production bleue d'origine.
• switchoverTargetInstance : identifiant de l'instance de préproduction verte qui devient l'instance de production en lecture et en écriture lors du basculement.
• requestedConfig : configuration prévue pour l'instance cible au moment de la création, par exemple databaseVersion pour les mises à niveau de version majeure.
• errorDetail : détails de l'erreur de diagnostic expliquant pourquoi le basculement n'est pas prêt ou pourquoi une tâche de provisionnement ou de basculement a échoué.
• deploymentMappings : liste des paires d'instances source et cible dans le déploiement. Pour chaque paire, examinez :
  • source : informations sur la connexion et le réseau de l'instance bleue, y compris le chemin d'accès à la ressource de l'instance (instance), le nom de la connexion (connection), le nom d'hôte DNS (dns) et les adresses IP (ipAddresses).
  • target : informations sur la connexion et le réseau pour l'instance verte. Utilisez le nom de la cible connection ou ipAddresses pour connecter les applications de préproduction et les suites de tests à l'environnement vert.
  • diffs : différences de configuration entre les instances bleues et vertes lorsque vous utilisez la vue détaillée. Pendant la version Preview, les modifications apportées aux indicateurs de base de données ne sont pas affichées.
  • state : état opérationnel du nœud associé (par exemple, PROVISIONING, PROVISIONED, UPGRADING, UPGRADED, UPGRADE_FAILED, SWITCHOVER_IN_PROGRESS, SWITCHOVER_FAILED, SWITCHOVER_SUCCEEDED ou DELETING).
  • tasks : état d'exécution, heure de début, heure de fin et détails des erreurs pour les tâches de déploiement effectuées sur ce nœud.
• deploymentTasks : liste consolidée de toutes les tâches de déploiement sur tous les nœuds, y compris les tâches type (PROVISION, UPGRADE, SWITCHOVER, DELETE ou POST_SWITCHOVER_OPERATIONS), state (PENDING, RUNNING, SUCCEEDED ou FAILED), startTime, endTime et errorMessage.

Afficher les différences de configuration

Par défaut, la description d'un déploiement renvoie la vue de base avec les métadonnées principales. Pour examiner les différences de configuration entre les instances bleue et verte, consultez les différences de paramètres dans la console Google Cloud ou demandez la vue détaillée à l'aide de la gcloud CLI ou de l'API Cloud SQL Admin :

Console

1. Dans la console Google Cloud , accédez à la page Instances Cloud SQL.

   Accéder à la page Instances Cloud SQL

2. Pour ouvrir la page Présentation d'une instance, cliquez sur son nom.
3. Dans la fiche État du déploiement bleu-vert, cliquez sur Détails pour ouvrir la page Présentation du déploiement.
4. Dans la fiche Informations sur le déploiement, cliquez sur Afficher les différences de paramètres.
5. Dans la boîte de dialogue Différences de paramètres d'instance, examinez la comparaison entre les instances Source et Cible, puis cliquez sur Fermer.

gcloud

Exécutez la commande blue-green-deployments describe avec l'option --show-config-diff :

gcloud beta sql blue-green-deployments describe DEPLOYMENT_NAME \
  --region=REGION \
  --show-config-diff

REST v1

Envoyez une requête GET à la méthode blueGreenDeployments.get avec le paramètre de requête view=DETAILED :

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/
  locations/REGION/
  blueGreenDeployments/DEPLOYMENT_NAME?view=DETAILED

REST v1beta4

Envoyez une requête GET à la méthode blueGreenDeployments.get avec le paramètre de requête view=DETAILED :

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/
  locations/REGION/
  blueGreenDeployments/DEPLOYMENT_NAME?view=DETAILED

Examiner les différences de configuration

Lorsque vous spécifiez la vue détaillée, la réponse inclut une section diffs dans chaque nœud associé sous deploymentMappings :

deploymentMappings:
- diffs:
  - field: database_version
    sourceValue: MYSQL_8_0
    targetValue: MYSQL_8_4
  - field: settings/tier
    sourceValue: db-custom-2-7680
    targetValue: db-custom-4-15360
  source:
    instance: projects/PROJECT_ID/instances/my-source-instance
  target:
    connection: PROJECT_ID:REGION:my-target-instance
    instance: projects/PROJECT_ID/instances/my-target-instance

La section diffs met en évidence les différences entre les instances source et cible pour des attributs tels que :

• database_version : version du moteur de base de données sur les instances bleues et vertes.
• settings/tier : type de machine (vCPU et mémoire) alloué à l'instance.
• edition : édition Cloud SQL (édition Cloud SQL Enterprise ou Cloud SQL Enterprise Plus).
• availability_type : configuration de haute disponibilité (HA) (ZONAL ou REGIONAL).
• settings/data_disk_size_gb : capacité de stockage en gigaoctets.
• settings/data_disk_type : type de stockage (PD_SSD).

Remarque : Pendant la version Preview, les différences de configuration entre les instances source et cible n'affichent pas les modifications apportées aux indicateurs de base de données.

Avant de commencer les tests fonctionnels de la charge de travail, vérifiez que toutes les modifications listées correspondent aux spécifications de déploiement prévues.

Connecter et valider les charges de travail des applications

Connectez votre application ou vos outils client à l'instance verte à l'aide de sa chaîne de connexion unique :

gcloud sql connect TARGET_INSTANCE_NAME --user=DB_USER

Remplacez les éléments suivants :

• TARGET_INSTANCE_NAME : nom de votre instance verte cible.
• DB_USER : nom d'utilisateur de la base de données.

Effectuez les étapes de validation suivantes :

• Exécutez des tests d'intégration : vérifiez que les requêtes d'application et les procédures stockées s'exécutent sans erreur sur l'instance verte.
• Inspectez les journaux d'erreurs : consultez les journaux d'erreurs Cloud Logging et de la base de données Cloud SQL pour détecter les avertissements de syntaxe obsolète ou les erreurs de moteur inattendues.
• Examiner les statistiques de performances : surveillez les métriques de processeur, de mémoire et d'E/S sur l'instance verte pour vous assurer que les performances répondent aux SLO opérationnels.

Étapes suivantes

• Si la validation réussit et que l'instance verte répond à tous les critères fonctionnels et de performances, passez à Basculer un déploiement bleu-vert.
• Si vous détectez des problèmes lors de la validation, vous pouvez supprimer le déploiement bleu-vert en toute sécurité sans affecter votre environnement bleu en production.