Describe y enumera las implementaciones azul-verde

En este documento, se describe cómo enumerar y describir las implementaciones azul-verde de Cloud SQL, inspeccionar los detalles de conexión y las diferencias de configuración, y conectarse al entorno de etapa de desarrollo verde para probar y validar tus cargas de trabajo.

Antes de comenzar

Para enumerar o describir una implementación azul-verde y conectarte a la instancia de etapa de pruebas verde, verifica que tengas los roles y las credenciales de la base de datos necesarios.

Roles y permisos requeridos

Para obtener los permisos que necesitas para enumerar y describir las implementaciones azul-verde, pídele a tu administrador que te otorgue los siguientes roles de IAM en tu proyecto:

  • Visualizador de Cloud SQL (roles/cloudsql.viewer)
  • Editor de Cloud SQL (roles/cloudsql.editor)
  • Administrador de Cloud SQL (roles/cloudsql.admin)

Para los roles personalizados, asegúrate de tener los siguientes permisos:

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

Para conectarte a la instancia de etapa de pruebas verde y ejecutar consultas de prueba, también necesitas credenciales de usuario de la base de datos configuradas en la instancia de origen.

Para obtener más información sobre los roles y permisos de IAM en Cloud SQL, consulta Roles y permisos.

Descripción general

El comando describe te permite supervisar y hacer un seguimiento del estado de una implementación azul-verde de Cloud SQL en todo momento durante su ciclo de vida, desde el aprovisionamiento y la preparación iniciales hasta la finalización del cambio.

La descripción de una implementación azul-verde proporciona visibilidad sobre lo siguiente:

  • Estado del ciclo de vida de la implementación: Supervisa el estado en tiempo real de tu implementación a medida que pasa por estados como PROVISIONING, SWITCHOVER_READY, SWITCHOVER_NOT_READY, SWITCHOVER_IN_PROGRESS y SWITCHOVER_COMPLETED.
  • Detalles de conexión de la instancia de destino: Recupera el nombre de conexión único y los extremos de red para la instancia de etapa de pruebas verde. Esto permite que los administradores de bases de datos (DBA) y los ingenieros de QA conecten aplicaciones, ejecuten consultas de prueba y validen el rendimiento en la instancia verde sin afectar el tráfico de producción azul en vivo.
  • Estado de la replicación y preparación para la conmutación por error: Verifica que la replicación lógica continua de azul a verde sea correcta y, si surgen problemas, inspecciona los detalles de los errores de diagnóstico. Ten en cuenta que la descripción de una implementación no muestra el retraso de la replicación.
  • Diferencias de configuración: Cuando se solicita con la vista detallada, inspecciona una comparación en paralelo (diffs) de las versiones de la base de datos, los niveles de la máquina, la configuración de almacenamiento y las configuraciones de alta disponibilidad entre las instancias azules y verdes.

Enumera las implementaciones azul-verde

Para enumerar las implementaciones azul-verde en un proyecto, haz lo siguiente:

Console

  1. En la consola de Google Cloud , ve a la página Instancias de Cloud SQL.

    Ir a Instancias de Cloud SQL

  2. En la lista de instancias, consulta la columna ID de implementación azul-verde para ver las implementaciones azul-verde asociadas a tus instancias. Las instancias que forman parte de una implementación azul-verde también muestran una etiqueta de rol (Azul, Verde, Azul-antigua o Azul-nueva) junto al nombre de la instancia.

gcloud

Para enumerar las implementaciones azul-verde con gcloud, ejecuta el comando blue-green-deployments list:

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

Para enumerar las implementaciones en todas las regiones de tu proyecto, omite la marca --region.

REST v1

Para enumerar las implementaciones con la API de Cloud SQL Admin, envía una solicitud GET al método blueGreenDeployments.list:

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

REST v1beta4

Para enumerar las implementaciones con la API de Cloud SQL Admin, envía una solicitud GET al método blueGreenDeployments.list:

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

Describe la implementación azul-verde

Para inspeccionar el estado de la implementación y obtener los detalles de la conexión de instancia verde, describe la implementación:

Console

  1. En la consola de Google Cloud , ve a la página Instancias de Cloud SQL.

    Ir a Instancias de Cloud SQL

  2. Para abrir la página Descripción general de la implementación, realiza una de las siguientes acciones:
    • En la columna ID de implementación azul-verde, haz clic en el ID de implementación.
    • Haz clic en el nombre de la instancia para abrir la página Descripción general y, luego, en la tarjeta Estado de la implementación azul-verde, haz clic en Detalles.
  3. En la página Descripción general de la implementación, revisa la tarjeta Detalles de la implementación para inspeccionar el Estado, la Instancia de origen, la Instancia de destino, el Extremo de la instancia de destino y la Versión de destino de la implementación, y revisa la tarjeta Progreso de la implementación para inspeccionar los estados de las tareas.

gcloud

Para describir una implementación con gcloud, ejecuta el comando blue-green-deployments describe:

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

Reemplaza lo siguiente:

  • DEPLOYMENT_NAME: Es el nombre de tu implementación azul-verde.
  • REGION: Es la región de Google Cloud en la que se creó la implementación.

REST v1

Para describir una implementación con la API de Cloud SQL Admin, envía una solicitud GET al método blueGreenDeployments.get:

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

REST v1beta4

Para describir una implementación con la API de Cloud SQL Admin, envía una solicitud GET al método blueGreenDeployments.get:

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

Inspecciona el estado y los detalles de la conexión

En el resultado del comando, verifica el estado de la implementación y busca la información de conexión de la instancia verde de destino:

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'

Revisa los siguientes campos en la respuesta:

  • name: Es la ruta de acceso al recurso completamente calificada de la implementación en el formato projects/PROJECT_ID/locations/REGION/blueGreenDeployments/DEPLOYMENT_NAME.
  • createTime: Es la marca de tiempo en la que se creó la implementación.
  • state: Es el estado general del ciclo de vida de la implementación:
    • PROVISIONING: La implementación está aprovisionando el entorno verde y configurando la replicación.
    • SWITCHOVER_READY: La preparación está completa, la replicación lógica funciona correctamente y la implementación está lista para el cambio. Confirma este estado antes de ejecutar las pruebas.
    • SWITCHOVER_NOT_READY: La implementación no está lista para el cambio. Consulta errorDetail para solucionar problemas.
    • SWITCHOVER_IN_PROGRESS: Se está ejecutando una operación de cambio.
    • SWITCHOVER_COMPLETED: El cambio finalizó correctamente y la instancia verde ahora entrega tráfico de producción como la instancia activa de lectura y escritura.
    • DELETING: Se está borrando el recurso de implementación.
  • sourceInstance: Es el identificador de instancia de tu instancia de producción azul original.
  • switchoverTargetInstance: Es el identificador de la instancia de etapa de desarrollo verde que se convierte en la instancia de producción de lectura y escritura durante la conmutación por error.
  • requestedConfig: Es la configuración prevista para la instancia de destino en el momento de la creación, como databaseVersion para las actualizaciones de versión principal.
  • errorDetail: Son detalles de errores de diagnóstico que explican por qué no está lista la conmutación o por qué falló una tarea de aprovisionamiento o conmutación.
  • deploymentMappings: Es la lista de pares de instancias de origen y destino en la implementación. Para cada par, revisa lo siguiente:
    • source: Detalles de la conexión y la red de la instancia azul, incluida la ruta de acceso al recurso de la instancia (instance), el nombre de la conexión (connection), el nombre de host DNS (dns) y las direcciones IP (ipAddresses).
    • target: Detalles de conexión y red para la instancia verde. Usa el nombre de connection o ipAddresses de destino para conectar las aplicaciones de etapa de pruebas y los paquetes de pruebas al entorno verde.
    • diffs: Diferencias en la configuración entre las instancias azules y verdes cuando se usa la vista detallada. Durante la versión preliminar, no se muestran los cambios en las marcas de la base de datos.
    • state: Es el estado operativo del nodo vinculado (por ejemplo, PROVISIONING, PROVISIONED, UPGRADING, UPGRADED, UPGRADE_FAILED, SWITCHOVER_IN_PROGRESS, SWITCHOVER_FAILED, SWITCHOVER_SUCCEEDED o DELETING).
    • tasks: El estado de ejecución, la hora de inicio, la hora de finalización y los detalles de errores de las tareas de implementación realizadas en este nodo.
  • deploymentTasks: Es una lista consolidada de todas las tareas de implementación en todos los nodos, incluidas las tareas type (PROVISION, UPGRADE, SWITCHOVER, DELETE o POST_SWITCHOVER_OPERATIONS), state (PENDING, RUNNING, SUCCEEDED o FAILED), startTime, endTime y errorMessage.

Cómo ver las diferencias de configuración

De forma predeterminada, la descripción de una implementación devuelve la vista básica con metadatos principales. Para revisar las diferencias de configuración entre las instancias azules y verdes, consulta las diferencias de configuración en la Google Cloud consola o solicita la vista detallada con la gcloud CLI o la API de Cloud SQL Admin:

Console

  1. En la consola de Google Cloud , ve a la página Instancias de Cloud SQL.

    Ir a Instancias de Cloud SQL

  2. Para abrir la página de Descripción general de una instancia, haz clic en su nombre.
  3. En la tarjeta Estado de la implementación azul-verde, haz clic en Detalles para abrir la página Resumen de la implementación.
  4. En la tarjeta Detalles de la implementación, haz clic en Ver diferencias de configuración.
  5. En el diálogo Instance Setting Differences, revisa la comparación entre las instancias de Source y Target y, luego, haz clic en Close.

gcloud

Sigue los pasos que se indican a continuación para ejecutar el comando blue-green-deployments describe con la marca --show-config-diff:

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

REST v1

Envía una solicitud GET al método blueGreenDeployments.get con el parámetro de consulta view=DETAILED:

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

REST v1beta4

Envía una solicitud GET al método blueGreenDeployments.get con el parámetro de consulta view=DETAILED:

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

Revisa las diferencias de configuración

Cuando especificas la vista detallada, la respuesta incluye una sección diffs dentro de cada nodo emparejado en 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

En la sección diffs, se destacan las diferencias entre las instancias de origen y de destino para atributos como los siguientes:

  • database_version: La versión del motor de base de datos en las instancias azules y verdes.
  • settings/tier: Tipo de máquina (CPU virtual y memoria) asignado a la instancia.
  • edition: Es la edición de Cloud SQL (edición Enterprise de Cloud SQL o edición Enterprise Plus de Cloud SQL).
  • availability_type: Configuración de alta disponibilidad (HA) (ZONAL o REGIONAL).
  • settings/data_disk_size_gb: Capacidad de almacenamiento en gigabytes.
  • settings/data_disk_type: Tipo de almacenamiento (PD_SSD).

Confirma que todos los cambios enumerados coincidan con las especificaciones de implementación planificadas antes de comenzar las pruebas funcionales de la carga de trabajo.

Conecta y valida las cargas de trabajo de la aplicación

Conecta tu aplicación o herramientas de cliente a la instancia verde con su cadena de conexión única:

gcloud sql connect TARGET_INSTANCE_NAME --user=DB_USER

Reemplaza lo siguiente:

  • TARGET_INSTANCE_NAME: Es el nombre de tu instancia verde de destino.
  • DB_USER: Es el nombre de usuario de la base de datos.

Sigue estos pasos de validación:

  • Ejecuta pruebas de integración: Verifica que las consultas de la aplicación y los procedimientos almacenados se ejecuten sin errores en la instancia verde.
  • Inspecciona los registros de errores: Verifica los registros de errores de Cloud Logging y de la base de datos de Cloud SQL para detectar advertencias de sintaxis obsoleta o errores inesperados del motor.
  • Revisa las estadísticas de rendimiento: Supervisa las métricas de CPU, memoria y E/S en la instancia verde para garantizar que el rendimiento cumpla con los SLO operativos.

¿Qué sigue?