Actualiza una instancia a la nueva arquitectura de red

En esta página, se describe cómo actualizar las instancias de Cloud SQL de la arquitectura de red anterior a la nueva.

Esta página de actualización de la arquitectura de red de Cloud SQL solo se aplica a algunas instancias de Cloud SQL. Si tus instancias de Cloud SQL usan un proyecto de red de nube privada virtual (VPC) que se creó antes de agosto de 2021, debes actualizar la arquitectura de red de Cloud SQL para tus instancias.

Descripción general

En la siguiente tabla, se muestran los beneficios de la nueva arquitectura de red en comparación con la arquitectura de red anterior:

Planifica la actualización

Antes de actualizar la arquitectura de red de tus instancias de Cloud SQL, planifica la actualización de acuerdo con las siguientes restricciones de actualización:

• Si actualizas la arquitectura de tu red, hay hasta 4 minutos de tiempo de inactividad para la instancia de base de datos.

• Si hay una migración de datos en curso, no puedes actualizar la instancia de origen a la arquitectura nueva durante la migración de datos.

• Si te conectas a una instancia desde una fuente externa, verifica que todas las conexiones de intercambio de tráfico estén actualizadas para habilitar la exportación de rutas personalizadas.

• No puedes actualizar la arquitectura de red de las instancias en una red con más de 300 instancias de Cloud SQL.

• Si tu red incluye dos o más instancias que usan direcciones IP privadas en la misma región, Cloud SQL debe usar un rango (o rangos) adicional /24 del rango de direcciones IP de acceso privado a los servicios asignados para alojar las instancias en la nueva arquitectura de red. Este consumo adicional es temporal y se quita durante un evento de mantenimiento posterior de Cloud SQL.

Planifica la actualización de todas las instancias de Cloud SQL en un proyecto de red

Tus instancias de Cloud SQL pueden estar en el mismo proyecto que la red de VPC o pueden estar alojadas en un proyecto independiente. El proyecto que aloja la red de VPC es el proyecto de red.

Si al menos una instancia de Cloud SQL dentro de un proyecto de red usa la arquitectura de red anterior, todo el proyecto usa la arquitectura de red anterior. En este caso, tu proyecto no se actualiza por completo a la arquitectura de red nueva.

Puedes usar la gcloud CLI o la API de Cloud SQL Admin para consultar la arquitectura de red de todas las instancias de Cloud SQL dentro de un proyecto.

Cuando modificas la red privada de una instancia o habilitas una IP privada para una instancia, no puedes modificar la arquitectura de red en la misma solicitud. Si lo haces, se rechaza la solicitud. Para evitar esto, te recomendamos que actualices todas las instancias de un proyecto de red antes de modificar el proyecto de red.

Actualiza la arquitectura de red de Cloud SQL

Para actualizar la arquitectura de red de las instancias de Cloud SQL, haz lo siguiente:

1. Verifica la arquitectura de red de una sola instancia de Cloud SQL o de varias instancias de Cloud SQL.
2. Actualiza la arquitectura de red de una instancia de Cloud SQL.

Verifica la arquitectura de red de una sola instancia de Cloud SQL

Para verificar la arquitectura de red actual de una sola instancia, usa el comando gcloud sql instances describe o el método instances.get.

   gcloud sql instances describe INSTANCE_NAME
   

   name: INSTANCE_NAME
   project: PROJECT_ID
   ...
   sqlNetworkArchitecture: OLD_NETWORK_ARCHITECTURE
  

   name: INSTANCE_NAME
   project: PROJECT_ID
   ...
   sqlNetworkArchitecture: NEW_NETWORK_ARCHITECTURE
  

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

{
  "kind": sql#instance
  "name": INSTANCE_NAME
  "project": PROJECT_ID
  "sqlNetworkArchitecture": enum (SqlNetworkArchitecture)
  ...
}

GET https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

{
  "kind": sql#instance
  "name": INSTANCE_NAME
  "project": PROJECT_ID
  "sqlNetworkArchitecture": enum (SqlNetworkArchitecture)
  ...
}

Verifica la arquitectura de red de varias instancias de Cloud SQL

Para verificar la arquitectura de red de varias instancias de un proyecto, usa el comando gcloud sql instances list o el método instance.list.

gcloud sql instances list --show-sql-network-architecture

NAME        DATABASE_VERSION LOCATION   ...     SQL_NETWORK_ARCHITECTURE
instance_1  POSTGRES_13      asia-northeast1-b  OLD_NETWORK_ARCHITECTURE
instance_2  MYSQL_5_7        europe-west1-d     NEW_NETWORK_ARCHITECTURE
...

LIST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

curl -X LIST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method LIST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances" | Select-Object -Expand Content

{
  "kind": sql#instance
  "name": INSTANCE_NAME
  "project": PROJECT_ID
  "sqlNetworkArchitecture": enum (SqlNetworkArchitecture)
  ...
}

LIST https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

curl -X LIST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method LIST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances" | Select-Object -Expand Content

{
  "kind": sql#instance
  "name": INSTANCE_NAME
  "project": PROJECT_ID
  "sqlNetworkArchitecture": enum (SqlNetworkArchitecture)
  ...
}

Actualiza la arquitectura de red de una sola instancia de Cloud SQL

Para actualizar la arquitectura de red de una sola instancia, usa el comando gcloud sql instances patch, el método instance.update o el método instance.patch.

gcloud sql instances patch INSTANCE_NAME --upgrade-sql-network-architecture

operation_id

operation_id

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

{
  "kind": sql#instance,
  "targetLink": string,
  "status": enum (SqlOperationStatus),
  "name": string,
  "insertTime": string,
  "startTime": string,
  "endTime": string
  ...
}

operation_id

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

{
  "kind": sql#instance,
  "targetLink": string,
  "status": enum (SqlOperationStatus),
  "name": string,
  "insertTime": string,
  "startTime": string,
  "endTime": string
  ...
}

Preguntas frecuentes

En esta sección, se proporcionan respuestas a las preguntas frecuentes sobre la actualización de la arquitectura de red de Cloud SQL.

• ¿Cuál es el impacto de la actualización en mi instancia de Cloud SQL?
• ¿Todas las funciones operan de la misma manera después de la actualización?
• ¿Qué instancias usa la arquitectura de red anterior?
• ¿Se crean todas las instancias de Cloud SQL nuevas en la arquitectura de red nueva?
• ¿Es posible actualizar todas las instancias de un proyecto con un solo comando?
• ¿La réplica se actualiza automáticamente si actualizo la instancia principal?
• Recibí una notificación en la que se indica que se actualizará la arquitectura de red de mis instancias de Cloud SQL. ¿Qué debo hacer?
• ¿Por qué no puedo actualizar la arquitectura de red de mi instancia zonal?
• Cuando intento actualizar mi instancia, recibo el error “fuera del rango de direcciones IP reservadas”. ¿Qué debo hacer?

¿Cuál es el impacto de la actualización en mi instancia de Cloud SQL?

Cuando actualizas la arquitectura de tu red, la instancia de Cloud SQL tiene el estado MAINTENANCE. En este estado, la instancia experimenta hasta cuatro minutos de tiempo de inactividad en promedio. No se permiten cambios adicionales en la instancia hasta que se complete la actualización. Otras instancias en tu proyecto o red afectadas por la actualización.

¿Todas las funciones operan de la misma manera después de la actualización?

Todas las funciones de tu instancia de Cloud SQL operan de la misma manera en la arquitectura nueva que en la anterior. Después de actualizar una instancia para usar la nueva arquitectura de red, si deseas cambiar la red de esa instancia, asegúrate de que todas las instancias en la red de destino también se actualicen a la nueva arquitectura de red.

¿Qué instancias usa la arquitectura de red anterior?

Cualquier proyecto nuevo que se haya creado después de agosto de 2021 usará automáticamente la arquitectura de red nueva. Los proyectos existentes pueden contener instancias de Cloud SQL que tienen más de dos años y aún usan la arquitectura de red anterior. Por lo tanto, todas las instancias dentro de un proyecto existente deben actualizarse antes de que cualquier instancia nueva en ese proyecto pueda comenzar a usar la nueva arquitectura de red.

¿Se crean todas las instancias de Cloud SQL nuevas en la arquitectura de red nueva?

De forma predeterminada, las instancias nuevas de Cloud SQL que se crean en proyectos creados después de agosto de 2021 usan la arquitectura de red nueva. Si deseas crear una instancia en un proyecto creado antes de agosto de 2021 y usar la nueva arquitectura de red, debes hacer lo siguiente:

1. Actualiza todas las instancias existentes en ese proyecto a la arquitectura de red nueva.

2. Si tienes un contrato de asistencia de Google Cloud, crea una solicitud de asistencia para cambiar la arquitectura de red predeterminada del proyecto a la nueva arquitectura.

3. Si no tienes un contrato de asistencia, crea tu instancia y, luego, actualízala a la nueva arquitectura de red.

Una vez que se cambia el valor predeterminado del proyecto, puedes crear instancias con la arquitectura de red nueva en ese proyecto.

Si no cambias la arquitectura de red predeterminada de tu proyecto, todas las instancias nuevas de ese proyecto usarán la arquitectura de red anterior. Luego, debes actualizar cada una de estas instancias a la nueva arquitectura de red de forma individual.

¿Es posible actualizar todas las instancias de un proyecto con un solo comando?

No, la actualización a la nueva arquitectura de red se basa en cada instancia.

¿La réplica se actualiza automáticamente si actualizo la instancia principal?

No, la actualización a la nueva arquitectura de red se basa en cada instancia individual. Cada réplica se trata como una instancia independiente y debe actualizarse por separado. Esto significa que, si la instancia principal se actualiza y la réplica usa la arquitectura de red anterior, la réplica no se ve afectada. Lo contrario también es verdadero. Si actualizas una réplica, la instancia principal no se verá afectada.

Recibí una notificación en la que se indica que se actualizará la arquitectura de red de mis instancias de Cloud SQL. ¿Qué debo hacer?

No es necesario que realices ninguna acción.

En algunas instancias, cuando la actualización automática se realiza en una red privada, la solicitud se rechaza de forma temporal. Como solución alternativa, puedes actualizar la arquitectura de red de tu instancia; para ello,, sigue el procedimiento en Actualiza la arquitectura de red de una sola instancia de Cloud SQL.

¿Por qué no puedo actualizar la arquitectura de red de mi instancia zonal?

Si la instancia está configurada con disponibilidad zonal y omitió su último evento de mantenimiento programado, es posible que tu instancia no admita la actualización a la nueva arquitectura de red. Para solucionar este problema, habilita la alta disponibilidad en tu instancia y, luego, actualiza la arquitectura de red. Después de la actualización, puedes volver a cambiar la configuración de la instancia a la disponibilidad zonal.

Cuando intento actualizar mi instancia, recibo el error “fuera del rango de direcciones IP reservadas”. ¿Qué debo hacer?

Para usar instancias de Cloud SQL en una red de VPC con IP privada, asigna rangos de direcciones IP cuando configures el acceso privado a los servicios para la red de VPC.

Por ejemplo, si se cambia o borra un rango de direcciones IP asignadas, es posible que veas un error similar al siguiente:

Network architecture upgrade not allowed for private-ip instance PROJECT_ID:INSTANCE_NAME
whose IP address range 10.0.0.0/24 is outside the reserved IP address range for
private services access. Re-allocate the IP address range for private services access and retry.

En este ejemplo, el rango de direcciones IP asignado original tiene el nombre google-managed-services-VPC_NETWORK_NAME y el rango de direcciones IP asignado original es 10.0.0.0/16. Luego, creas una instancia con una dirección IP privada de 10.0.0.1. Si se borra el rango de direcciones IP de google-managed-services-VPC_NETWORK_NAME o se actualiza para hacer referencia a un rango de 10.1.0.0/16, este rango no abarca la dirección IP privada de la instancia 10.0.0.1. Luego, cuando intentes actualizar la arquitectura de red de la instancia, verás el error outside the reserved IP address range.

A fin de resolver este problema, sigue el procedimiento en Configura el acceso privado a servicios para Cloud SQL. Reasigna un rango de direcciones IP que incluya la dirección IP de tu instancia en los rangos asignados para el acceso privado a servicios. Como mínimo, puedes asignar el rango de direcciones IP informado en el mensaje de error (en el ejemplo anterior, 10.0.0.0/24).

Luego, vuelve a intentar la actualización de la arquitectura de red.

¿Qué sigue?

• Obtén más información sobre Private Service Connect
• Obtén más información sobre Assured Workloads
• Obtén más información para Configurar el acceso a servicios privados para Cloud SQL
• Obtén más información sobre el Servicio de migración de bases de datos a AlloyDB para PostgreSQL