Lire les considérations sur les répliques

• Une réplique en lecture peut exister dans la même région que votre instance de base de données source ou dans une région différente, ce qui permet de répliquer vos données entre les régions.

• Une réplique en lecture doit être de la même version majeure que son instance de base de données source.

• Les sauvegardes sont désactivées sur les répliques en lecture. Les sauvegardes sont effectuées uniquement sur les instances de la base de données source.

• La réplication en lecture n'est pas prise en charge dans ou en dehors des régions compatibles EU Cloud (actuellement, eu-de). Elle est prise en charge dans ces régions.

• Il y a une limite de cinq répliques de lecture par instance source.

• La réplique de lecture ne participe pas aux élections de l'instance de la base de données source et le basculement vers la réplique de lecture n'est pas automatisé. La promotion du réplica en lecture vers un déploiement complet est une tâche manuelle, initiée par l'utilisateur.

• La taille minimale d'une réplique en lecture est de 2 Go de RAM et 20 Go de disque. Cela est vrai même si le déploiement de l'instance de la base de données source est plus petit.

• Les répliques de lecture ne s'adaptent pas automatiquement à l'instance de la base de données source. Si la quantité de données stockées dépasse le disque alloué à vos déploiements, mettez le disque à l'échelle des répliques de lecture, puis de l'instance de la base de données source. La mise à l'échelle de la réplique de lecture en premier permet de ne pas manquer d'espace sur les répliques de lecture. Si vous avez dimensionné le disque de l'instance de la base de données source en fonction des performances et non de l'espace, il n'est pas nécessaire de dimensionner les répliques de lecture.

• La réplication est asynchrone et peut générer un décalage. Par défaut, il n'y a aucune communication entre le maître et la réplique en matière de cohérence. Il est possible qu'une réplique de lecture prenne suffisamment de retard pour devoir être resynchronisée. Le délai de réplication peut être plus important lorsque la réplique se trouve dans une région géographiquement éloignée de l'instance de la base de données source.

• Une réplique en lecture est un déploiement avec un seul membre de données et n'a pas de haute disponibilité interne. Elle est sujette à des interruptions temporaires et à des temps d'indisponibilité durant la maintenance. Si vos applications reposent sur des répliques de lecture, assurez-vous de disposer d'une logique permettant de réessayer les requêtes qui ont échoué ou d'équilibrer la charge sur plusieurs répliques de lecture.

Le maître

Dans l'onglet Répliques en lecture d' un déploiement Databases for MySQL, avant qu'aucune réplique en lecture ne soit provisionnée, le volet central indique qu'aucune réplique en lecture n'existe et propose un bouton Créer.

Si un déploiement est un leader et qu'un réplica en lecture lui est déjà attaché, le volet Réplication contient une liste des déploiements de répliques et un lien vers chacun d'entre eux.

Provisionnement d'un réplica en lecture

Vous pouvez fournir une réplique en lecture à partir de l'onglet Répliques en lecture du leader en cliquant sur Créer une réplique en lecture. L'instance source est automatiquement définie. Le nom du réplica de lecture est généré automatiquement dans le champ Nom du service, mais vous pouvez le renommer librement. Vous pouvez choisir la région dans laquelle effectuer le déploiement, ainsi que son allocation de mémoire initiale. La taille du disque, la version et les points d'extrémité publics ou privés sont automatiquement configurés pour correspondre aux paramètres du déploiement de l'instance de la base de données source.

Si vous utilisez Key Protect, le mode BYOK (Bring Your Own Key (BYOK)) est pris en charge uniquement lors de la mise à disposition à partir de l'interface de ligne de commande et de l'API. Dans le cas contraire, la réplique de lecture est cryptée avec une clé générée.

ibmcloud resource service-instance-create <replica_name> databases-for-mysql standard <region> \
-p \ '{
  "remote_leader_id": "crn:v1:bluemix:public:databases-for-mysql:us-south:a/54e8ffe85dcedf470db5b5ee6ac4a8d8:1b8f53db-fc2d-4e24-8470-f82b15c71819::",
  "members_memory_allocation_mb": "2048",
  "members_disk_allocation_mb": "10240"
}'

curl -X POST \
  https://resource-controller.cloud.ibm.com/v2/resource_instances \
  -H 'Authorization: Bearer <>' \
  -H 'Content-Type: application/json' \
    -d '{
    "name": "<replica_name>",
    "target": "<region>",
    "resource_group": "<your_resource_group_id>",
    "resource_plan_id": "databases-for-mysql-standard",
    "remote_leader_id": "crn:v1:bluemix:public:databases-for-mysql:us-south:a/54e8ffe85dcedf470db5b5ee6ac4a8d8:1b8f53db-fc2d-4e24-8470-f82b15c71819::",
    "members_memory_allocation_mb": "2048",
    "members_disk_allocation_mb": "10240"
  }'

La réplique de la lecture

Dans l'onglet Répliques en lecture d'une réplique en lecture, le volet Réplication contient son nom et sa région, ainsi que le nom et la région de son instance de base de données source. Il dispose également de boutons permettant de resynchroniser la réplique de lecture et de la promouvoir.

mysql> SHOW SLAVE STATUS \G

Resynchronisation d'une réplique en lecture

Si vous devez resynchroniser un réplica en lecture, cliquez sur le bouton Resynchroniser le réplica en lecture. La resynchronisation est une opération perturbatrice et l'exécution d'une resynchronisation détruit et reconstruit les données dans la réplique de lecture. Le réplica en lecture n'est pas en mesure d'effectuer d'autres opérations ou d'exécuter des requêtes pendant qu'une resynchronisation est en cours. Les requêtes ne sont pas redirigées vers l'instance de la base de données source, de sorte que toute connexion à la réplique de lecture échoue jusqu'à ce que la resynchronisation soit terminée.

Le temps nécessaire à la resynchronisation d'une réplique de lecture est variable, mais le processus peut être très long.

Pour démarrer une resynchronisation via l'interface de ligne de commande, utilisez la commande cdb read-replica-resync.

ibmcloud cdb read-replica-resync <deployment name>

Pour démarrer une resynchronisation via l'API, envoyez une demande POST au noeud final /deployments/{id}/remotes/resync.

curl -X POST \
  https://api.{region}.databases.cloud.ibm.com/v4/ibm/deployments/{id}/remotes/resync \
  -H 'Authorization: Bearer <>'

Promouvoir une réplique de lecture

Une réplique en lecture peut être promue à un cluster indépendant qui peut accepter des opérations d'écriture aussi bien que des opérations de lecture. En cas d'incident sur l'instance de la base de données source, le réplica de lecture peut être promu en cluster autonome et commencer à accepter les écritures de votre application.

Pour promouvoir un réplica en lecture à partir de l'interface utilisateur, cliquez sur le bouton Promouvoir le réplica en lecture.

Lors de la promotion, le réplica en lecture met fin à sa connexion à l'instance de la base de données source et devient un déploiement autonome sur le site Databases for MySQL. Le déploiement peut commencer à accepter et exécuter des opérations de lecture et d'écriture, les sauvegardes sont activées, et il émet son propre nom d'administrateur. Un nouveau membre de données est ajouté pour que le déploiement devienne un cluster avec trois membres de données. Cela augmente le coût car il est facturé au même taux de consommation par membre, mais le déploiement compte trois membres au lieu d'un.

Lorsque vous promouvez un réplica en lecture, vous pouvez ignorer la sauvegarde initiale qui serait normalement effectuée lors de la promotion. Lorsque vous ignorez la sauvegarde initiale, votre réplique devient disponible plus rapidement, mais aucune sauvegarde n'est disponible immédiatement. Vous pouvez lancer une sauvegarde à la demande une fois la promotion terminée.

Une fois qu'une réplique de lecture est promue à un déploiement indépendant, il n'est pas possible de la ramener à une réplique de lecture ou de la faire rejoindre une instance de base de données source.

Pour effectuer la promotion via l'interface de ligne de commande, utilisez la commande cdb read-replica-promote.

ibmcloud cdb read-replica-promote <deployment name>

Pour effectuer la promotion via l'API, envoyez une demande POST au noeud final /deployments/{id}/remotes/promotion.

curl -X POST \
  https://api.{region}.databases.cloud.ibm.com/v4/ibm/deployments/{id}/remotes/promotion \
  -H 'Authorization: Bearer <>'  \
 -H 'Content-Type: application/json' \
 -d '{"promotion": {}}' \

Pour effectuer la promotion et ignorer la sauvegarde initiale après la promotion, définissez également skip_initial_backup dans le corps JSON.

curl -X POST \
  https://api.{region}.databases.cloud.ibm.com/v4/ibm/deployments/{id}/remotes/promotion \
  -H 'Authorization: Bearer <>'  \
 -H 'Content-Type: application/json' \
 -d '{"promotion": {"skip_initial_backup": true}}' \