En este documento, se explica cómo borrar una implementación azul-verde de Cloud SQL y se detalla la diferencia crítica en el comportamiento de borrado antes y después de la conmutación.
Antes de comenzar
Para borrar o cancelar una implementación azul-verde, verifica que tengas los roles y permisos necesarios.
Roles y permisos requeridos
Para obtener los permisos que necesitas para borrar una implementación azul-verde, pídele a tu administrador que te otorgue el siguiente rol de IAM en tu proyecto:
- Administrador de Cloud SQL (
roles/cloudsql.admin)
Para los roles personalizados, asegúrate de tener los siguientes permisos:
cloudsql.blueGreenDeployments.deletecloudsql.blueGreenDeployments.getcloudsql.instances.deletecloudsql.operations.get
Para obtener más información sobre los roles y permisos de IAM en Cloud SQL, consulta Roles y permisos.
Información sobre los comportamientos de eliminación
La operación delete se comporta de manera diferente según si se produjo la conmutación por error:
| Etapa de implementación | Comportamiento predeterminado | Impacto en la instancia |
|---|---|---|
| Antes del cambio (Cancelar) |
Borra los metadatos de la implementación y borra automáticamente la instancia de etapa de pruebas verde. | Tu instancia de producción azul seguirá en ejecución y no se verá afectada en absoluto. |
| Después del cambio (Borrar) |
Borra los metadatos de la implementación, pero conserva ambas instancias como instancias independientes de forma predeterminada. | La instancia verde sigue publicando tráfico de producción como tu instancia de base de datos activa de lectura y escritura. La instancia azul se conserva como una instancia independiente de lectura y escritura, a menos que selecciones la opción Borrar la instancia de origen anterior, pases la marca opcional --delete-old-source o establezcas el parámetro deleteOldSource en true para borrarla. |
Caso 1: Cancela una implementación antes de la conmutación
Si detectas problemas durante la validación o decides no continuar con una actualización, borra la implementación antes de activar la conmutación.
Console
-
En la consola de Google Cloud , ve a la página Instancias de Cloud SQL.
- Para abrir la página de Descripción general de una instancia, haz clic en su nombre.
- En la tarjeta Estado de la implementación azul-verde, haz clic en Detalles para abrir la página Resumen de la implementación.
- Haz clic en Borrar implementación.
- En el cuadro de diálogo ¿Borrar implementación?, ingresa el ID de la implementación en el campo ID de implementación para confirmar.
- Haz clic en Borrar.
gcloud
Para cancelar y borrar una implementación azul-verde con gcloud, ejecuta el comando blue-green-deployments delete:
gcloud beta sql blue-green-deployments delete 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 cancelar y borrar una implementación azul-verde con la API de Cloud SQL Admin, envía una solicitud DELETE al método blueGreenDeployments.delete:
DELETE https://sqladmin.googleapis.com/v1/ projects/PROJECT_ID/locations/REGION/ blueGreenDeployments/DEPLOYMENT_NAME
Reemplaza lo siguiente:
- PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
- REGION: Es la región de Google Cloud en la que se creó la implementación.
- DEPLOYMENT_NAME: Es el nombre de tu implementación azul-verde.
REST v1beta4
Para cancelar y borrar una implementación azul-verde con la API de Cloud SQL Admin, envía una solicitud DELETE al método blueGreenDeployments.delete:
DELETE https://sqladmin.googleapis.com/sql/v1beta4/ projects/PROJECT_ID/locations/REGION/ blueGreenDeployments/DEPLOYMENT_NAME
Reemplaza lo siguiente:
- PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
- REGION: Es la región de Google Cloud en la que se creó la implementación.
- DEPLOYMENT_NAME: Es el nombre de tu implementación azul-verde.
Esta acción quita la instancia de etapa de pruebas verde y restablece tu entorno a su estado original de una sola instancia sin tiempo de inactividad.
Caso 2: Borrar después del cambio
Después de un cambio y un período de verificación exitosos, puedes borrar la implementación junto con la instancia azul anterior para dejar de incurrir en cargos por dos instancias.
Console
-
En la consola de Google Cloud , ve a la página Instancias de Cloud SQL.
- Para abrir la página de Descripción general de una instancia, haz clic en su nombre.
- En la tarjeta Estado de la implementación azul-verde, haz clic en Detalles para abrir la página Resumen de la implementación.
- Haz clic en Borrar implementación.
- En el cuadro de diálogo ¿Borrar implementación?, ingresa el ID de la implementación en el campo ID de implementación para confirmar.
- Elige si quieres borrar o conservar la instancia azul anterior:
- Opción A (borra la implementación y la instancia azul anterior): Selecciona la casilla de verificación Borrar la instancia de origen anterior.
- Opción B (borrar solo los metadatos de la implementación): Deja sin marcar la casilla de verificación Borrar la instancia de origen anterior para conservar la instancia azul anterior como una instancia independiente.
- Haz clic en Borrar.
gcloud
Para borrar una implementación azul-verde con gcloud, ejecuta el comando blue-green-deployments delete.
Opción A: Borra la implementación y la instancia azul anterior
Para borrar los metadatos de la implementación y borrar automáticamente la instancia azul anterior, pasa la marca opcional --delete-old-source:
gcloud beta sql blue-green-deployments delete DEPLOYMENT_NAME \ --region=REGION \ --delete-old-source
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.
Cuando se te solicite, confirma que quieres borrar de forma permanente la instancia azul anterior.
Opción B: Borra solo los metadatos de la implementación (conserva la instancia azul anterior)
Si deseas mantener la instancia azul anterior en ejecución como una instancia independiente (por ejemplo, como copia de seguridad o para consultas analíticas históricas), omite la marca opcional --delete-old-source:
gcloud beta sql blue-green-deployments delete 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.
Este comando solo borra los metadatos de la implementación azul-verde, y deja ambas instancias como independientes hasta que borres manualmente la instancia azul anterior. Ambas instancias permanecerán activas en tu proyecto y se te seguirá facturando por ambas.
REST v1
Para borrar una implementación azul-verde con la API de Cloud SQL Admin, envía una solicitud DELETE al método blueGreenDeployments.delete.
Opción A: Borra la implementación y la instancia azul anterior
Para borrar los metadatos de la implementación y borrar automáticamente la instancia azul anterior, configura el parámetro de consulta deleteOldSource como true:
DELETE https://sqladmin.googleapis.com/v1/ projects/PROJECT_ID/locations/REGION/ blueGreenDeployments/DEPLOYMENT_NAME?deleteOldSource=true
Reemplaza lo siguiente:
- PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
- REGION: Es la región de Google Cloud en la que se creó la implementación.
- DEPLOYMENT_NAME: Es el nombre de tu implementación azul-verde.
Opción B: Borra solo los metadatos de la implementación (conserva la instancia azul anterior)
Si deseas mantener la instancia azul anterior en ejecución como una instancia independiente (por ejemplo, como copia de seguridad o para consultas analíticas históricas), omite el parámetro de consulta deleteOldSource:
DELETE https://sqladmin.googleapis.com/v1/ projects/PROJECT_ID/locations/REGION/ blueGreenDeployments/DEPLOYMENT_NAME
Reemplaza lo siguiente:
- PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
- REGION: Es la región de Google Cloud en la que se creó la implementación.
- DEPLOYMENT_NAME: Es el nombre de tu implementación azul-verde.
Esta solicitud solo borra los metadatos de la implementación azul-verde, y deja ambas instancias como independientes hasta que borres manualmente la instancia azul anterior. Ambas instancias permanecerán activas en tu proyecto y se te seguirá facturando por ambas.
REST v1beta4
Para borrar una implementación azul-verde con la API de Cloud SQL Admin, envía una solicitud DELETE al método blueGreenDeployments.delete.
Opción A: Borra la implementación y la instancia azul anterior
Para borrar los metadatos de la implementación y borrar automáticamente la instancia azul anterior, configura el parámetro de consulta deleteOldSource como true:
DELETE https://sqladmin.googleapis.com/sql/v1beta4/ projects/PROJECT_ID/locations/REGION/ blueGreenDeployments/DEPLOYMENT_NAME?deleteOldSource=true
Reemplaza lo siguiente:
- PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
- REGION: Es la región de Google Cloud en la que se creó la implementación.
- DEPLOYMENT_NAME: Es el nombre de tu implementación azul-verde.
Opción B: Borra solo los metadatos de la implementación (conserva la instancia azul anterior)
Si deseas mantener la instancia azul anterior en ejecución como una instancia independiente (por ejemplo, como copia de seguridad o para consultas analíticas históricas), omite el parámetro de consulta deleteOldSource:
DELETE https://sqladmin.googleapis.com/sql/v1beta4/ projects/PROJECT_ID/locations/REGION/ blueGreenDeployments/DEPLOYMENT_NAME
Reemplaza lo siguiente:
- PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
- REGION: Es la región de Google Cloud en la que se creó la implementación.
- DEPLOYMENT_NAME: Es el nombre de tu implementación azul-verde.
Esta solicitud solo borra los metadatos de la implementación azul-verde, y deja ambas instancias como independientes hasta que borres manualmente la instancia azul anterior. Ambas instancias permanecerán activas en tu proyecto y se te seguirá facturando por ambas.
¿Qué sigue?
- Revisa Acerca de las implementaciones azul-verde para comprender la arquitectura de implementación y los estados del ciclo de vida.
- Explora las actualizaciones locales de la versión principal.
- Obtén más información para configurar la alta disponibilidad.