Mettre à niveau une instance vers la nouvelle architecture réseau

Important : La commande permettant de migrer les instances Cloud SQL vers la nouvelle architecture réseau est temporairement désactivée.

Cette page explique comment mettre à niveau vos instances Cloud SQL de l'ancienne architecture réseau vers la nouvelle.

Cette page de mise à niveau de l'architecture réseau Cloud SQL ne s'applique qu'à certaines instances Cloud SQL. Si vos instances Cloud SQL utilisent un projet de réseau cloud privé virtuel (VPC) créé avant août 2021, vous devez mettre à niveau l'architecture réseau Cloud SQL pour vos instances.

Présentation

Le tableau suivant montre les avantages de la nouvelle architecture réseau par rapport à l'ancienne :

Planifier votre mise à niveau

Avant de mettre à jour l'architecture réseau de vos instances Cloud SQL, planifiez la mise à niveau en fonction des contraintes de mise à niveau suivantes :

• Si vous mettez à niveau votre architecture réseau, votre instance peut être indisponible pendant quatre minutes en moyenne.

• Si une migration de données est en cours, vous ne pouvez pas mettre à niveau l'instance source vers la nouvelle architecture pendant la migration de données.

• Si vous vous connectez à une instance à partir d'une source externe, vérifiez que toutes les connexions d'appairage sont mises à jour pour permettre l'exportation de routes personnalisées.

• Si vous utilisez des périmètres de service, vérifiez que le projet hôte du VPC partagé est inclus. Si ce projet n'est pas inclus, la migration échoue.

• Vous ne pouvez pas mettre à niveau l'architecture réseau d'instances sur un réseau comportant plus de 300 instances Cloud SQL.

• Si votre réseau comprend au moins deux instances utilisant des adresses IP privées dans la même région, Cloud SQL doit utiliser une ou plusieurs plages /24 supplémentaires de la plage d'adresses IP d'accès aux services privés allouée pour héberger les instances dans la nouvelle architecture réseau. Cette consommation supplémentaire est temporaire et est supprimée lors d'un événement de maintenance Cloud SQL ultérieur.

Planifier la mise à niveau de toutes les instances Clud SQL d'un projet réseau

Vos instances Cloud SQL peuvent résider dans le même projet que le réseau VPC ou dans un projet distinct. Le projet qui héberge le réseau VPC est le projet réseau.

Un projet réseau peut fonctionner en mode double pile, ce qui signifie qu'il peut héberger des instances Cloud SQL simultanément, en utilisant à la fois l'ancienne et la nouvelle architecture réseau. Cela se produit lorsqu'au moins une instance du projet utilise l'ancienne architecture. Par conséquent, Cloud SQL ne peut pas mettre à niveau le projet vers la nouvelle architecture.

Pour interroger l'architecture réseau de toutes les instances d'un projet, vous pouvez utiliser la gcloud CLI ou l'API.

Remarques concernant les projets à double pile

Lorsque vous utilisez des projets à double pile, tenez compte des points suivants :

• Mettre à niveau une instance de manière implicite : lorsque vous modifiez le réseau privé d'une instance ou que vous activez l'adresse IP privée dans un projet à double pile, Cloud SQL peut mettre à niveau l'instance vers la nouvelle architecture réseau de manière implicite.
• Aucun rétrogradation de l'architecture : les modifications du réseau ne rétrogradent jamais l'architecture réseau d'une instance.
• Refuser les demandes : si une modification du réseau nécessite une rétrogradation pour être effectuée, Cloud SQL refuse la demande.
• Les nouvelles instances ne peuvent pas utiliser les plages d'adresses IP de l'ancienne architecture réseau : lorsqu'un projet est en mode double pile, vous ne pouvez pas créer d'instances qui utilisent des plages d'adresses IP associées à des connexions de service de l'ancienne architecture réseau.

• Application de la nouvelle architecture réseau : vous pouvez forcer une instance à utiliser la nouvelle architecture réseau lorsque vous créez l'instance ou que vous modifiez sa configuration réseau. Lorsque vous utilisez l'indicateur --enforce-new-network-architecture pour créer ou mettre à jour l'instance, celle-ci est placée dans un sous-réseau distinct de celui des instances qui utilisent l'ancienne architecture réseau. Cette séparation est permanente et persiste même après la mise à niveau des instances de l'ancienne architecture réseau vers la nouvelle architecture réseau.

  Pour en savoir plus sur l'attribution d'adresses IP et les sous-réseaux, consultez Plages d'adresses IP allouées.

Pour éviter d'éventuels conflits et assurer une mise à niveau fluide du réseau, nous vous recommandons de prévoir de mettre à niveau toutes les instances du projet vers la nouvelle architecture.

Mettre à niveau l'architecture réseau Cloud SQL

Pour mettre à niveau l'architecture réseau de vos instances Cloud SQL, procédez comme suit :

1. Vérifiez l'architecture réseau d'une seule instance Cloud SQL ou de plusieurs instances Cloud SQL.
2. Mettez à niveau l'architecture réseau d'une instance Cloud SQL.

Vérifier l'architecture réseau d'une seule instance Cloud SQL

Pour vérifier l'architecture réseau actuelle d'une seule instance, utilisez la commande gcloud sql instances describe ou la méthode 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)
  ...
}

Vérifier l'architecture réseau de plusieurs instances Cloud SQL

Pour vérifier l'architecture réseau de plusieurs instances dans un projet, utilisez la commande gcloud sql instances list ou la méthode 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)
  ...
}

Mettre à niveau l'architecture réseau d'une seule instance Cloud SQL

Pour mettre à niveau l'architecture réseau pour une seule instance, utilisez la commandegcloud sql instances patch, la méthode instance.update ou la méthode 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
  ...
}

Questions fréquentes

Cette section fournit des réponses aux questions fréquentes sur la mise à niveau de votre architecture réseau Cloud SQL.

• Quel est l'impact de la mise à niveau sur mon instance Cloud SQL ?
• Toutes les fonctionnalités fonctionnent-elles de la même manière après la mise à niveau ?
• Quelles instances utilisent l'ancienne architecture réseau ?
• Toutes les nouvelles instances Cloud SQL sont-elles créées dans la nouvelle architecture réseau ?
• Est-il possible de mettre à jour toutes les instances d'un projet à l'aide d'une seule commande ?
• L'instance répliquée est-elle automatiquement mise à niveau si je mets à niveau l'instance principale ?
• J'ai reçu une notification indiquant que l'architecture réseau de mes instances Cloud SQL allait être mise à niveau. Que dois-je faire ?
• Lorsque j'essaie de mettre à niveau mon instance, le message d'erreur "En dehors de la plage d'adresses IP réservées" s'affiche. Que dois-je faire ?

Quel est l'impact de la mise à niveau sur mon instance Cloud SQL ?

Lors de la mise à niveau de votre architecture réseau, l'instance Cloud SQL est à l'état MAINTENANCE. Dans cet état, l'instance subit en moyenne jusqu'à quatre minutes de temps d'arrêt. Aucune modification supplémentaire de l'instance n'est autorisée tant que la mise à niveau n'est pas terminée. Les autres instances de votre projet ou de votre réseau ne sont pas affectées par la mise à niveau.

Toutes les fonctionnalités fonctionnent-elles de la même manière après la mise à niveau ?

Toutes les fonctionnalités de votre instance Cloud SQL fonctionnent de la même manière dans la nouvelle architecture que dans l'ancienne. Après avoir mis à niveau une instance pour utiliser la nouvelle architecture réseau, si vous souhaitez changer le réseau de cette instance, assurez-vous que toutes les instances du réseau de destination sont également mises à niveau vers la nouvelle architecture réseau.

Quelles instances utilisent l'ancienne architecture réseau ?

Tous les projets créés après août 2021 utilisent automatiquement la nouvelle architecture réseau. Les projets existants peuvent contenir des instances Cloud SQL créées avant août 2021 et utilisant toujours l'ancienne architecture réseau. Par conséquent, toutes les instances d'un projet existant doivent être mises à niveau avant que les nouvelles instances de ce projet puissent commencer à utiliser la nouvelle architecture réseau.

Toutes les nouvelles instances Cloud SQL sont-elles créées dans la nouvelle architecture réseau ?

Par défaut, les instances Cloud SQL créées dans des projets créés après août 2021 utilisent la nouvelle architecture réseau.

Si vous souhaitez créer une instance dans un projet créé avant août 2021 et utiliser la nouvelle architecture de réseau, vous avez les options suivantes :

• Mettre à jour toutes les instances existantes : mettez à jour toutes les instances existantes du projet vers la nouvelle architecture réseau. Si vous utilisez un VPC partagé, vous devez mettre à jour toutes les instances des projets qui participent au VPC partagé. Une fois que vous avez mis à jour toutes les instances existantes du projet, attendez plusieurs heures avant d'en créer d'autres. Les nouvelles instances que vous créez dans le projet utiliseront alors la nouvelle architecture réseau.

• Appliquer l'utilisation de la nouvelle architecture réseau : vous pouvez forcer Cloud SQL à utiliser la nouvelle architecture réseau en utilisant le champ sqlNetworkArchitecture dans l'API ou l'indicateur --enforce-new-network-architecture dans la CLI gcloud lorsque vous créez une instance ou modifiez la configuration du réseau IP privé d'une instance existante. Toutefois, lorsque vous appliquez la nouvelle architecture réseau aux instances avant qu'un projet ne soit entièrement mis à niveau, il est possible que la création d'instances échoue si l'espace d'adresses IP disponible n'est pas suffisant. Pour en savoir plus sur l'allocation de plages d'adresses IP, consultez Plages d'adresses IP allouées.

Si des instances utilisant l'ancienne architecture réseau ont été supprimées récemment, vous devez attendre quatre jours avant de pouvoir créer une instance avec la nouvelle architecture réseau. Ce délai permet de restaurer une instance supprimée.

Est-il possible de mettre à jour toutes les instances d'un projet à l'aide d'une seule commande ?

Non, la mise à niveau vers la nouvelle architecture réseau est basée sur chaque instance.

L'instance répliquée est-elle automatiquement mise à niveau si je mets à niveau l'instance principale ?

Non, la mise à niveau vers la nouvelle architecture réseau est basée sur chaque instance individuelle. Chaque instance répliquée est traitée comme une instance distincte et doit être mise à jour séparément. Cela signifie que si l'instance principale est mise à niveau et que l'instance répliquée utilise l'ancienne architecture réseau, celle-ci n'est pas affectée. L'inverse est également vrai. Si vous mettez à niveau une instance répliquée, l'instance principale n'est pas affectée.

J'ai reçu une notification indiquant que l'architecture réseau de mes instances Cloud SQL allait être mise à niveau. Que dois-je faire ?

Aucune action spéciale n'est requise de votre part.

Dans certains cas, lorsque la mise à niveau automatique a lieu sur un réseau privé, la demande est temporairement refusée. Pour contourner ce problème, vous pouvez mettre à niveau vous-même l'architecture réseau de votre instance en suivant la procédure décrite dans Mettre à niveau l'architecture réseau d'une seule instance Cloud SQL.

Lorsque j'essaie de mettre à niveau mon instance, le message d'erreur "En dehors de la plage d'adresses IP réservées" s'affiche. Que dois-je faire ?

Pour utiliser des instances Cloud SQL dans un réseau VPC avec une adresse IP privée, allouez des plages d'adresses IP lorsque vous configurez l'accès aux services privés pour le réseau VPC.

Par exemple, si une plage d'adresses IP allouée est modifiée ou supprimée, vous pouvez rencontrer une erreur semblable à celle-ci :

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.

Dans cet exemple, la plage d'adresses IP allouée d'origine est nommée google-managed-services-VPC_NETWORK_NAME, et la plage d'adresses IP allouée d'origine est 10.0.0.0/16. Vous créez ensuite une instance avec une adresse IP privée de 10.0.0.1. Si la plage d'adresses IP de google-managed-services-VPC_NETWORK_NAME est supprimée ou mise à jour pour faire référence à une plage de 10.1.0.0/16, cette plage ne couvre pas l'adresse IP privée 10.0.0.1 de l'instance. Ensuite, lorsque vous essayez de mettre à niveau l'architecture réseau de votre instance, vous rencontrez l'erreur outside the reserved IP address range.

Pour résoudre ce problème, suivez la procédure décrite dans la section Configurer l'accès aux services privés pour Cloud SQL. Réallouez une plage d'adresses IP incluant l'adresse IP de votre instance dans les plages allouées pour l'accès aux services privés. Vous pouvez au moins allouer la plage d'adresses IP signalée dans votre message d'erreur (dans l'exemple précédent, 10.0.0.0/24).

Ensuite, relancez la mise à niveau de l'architecture réseau.

Étape suivante

• Apprenez-en plus sur Private Service Connect.
• Apprenez-en plus sur Assured Workloads.
• Découvrez comment configurer l'accès privé aux services pour Cloud SQL.
• Apprenez-en plus sur Database Migration Service vers AlloyDB pour PostgreSQL