Cette page explique comment faire évoluer une instance AlloyDB. Vous pouvez effectuer un scaling vertical des instances principales et des instances de pool de lecture en modifiant le type de machine de l'instance, et un scaling horizontal des instances de pool de lecture en modifiant le nombre de nœuds de l'instance.
Avant de commencer
- Le projet Google Cloud que vous utilisez doit avoir été autorisé à accéder à AlloyDB.
- Vous devez disposer de l'un des rôles IAM suivants dans le projet Google Cloud que vous utilisez :
roles/alloydb.admin
(rôle IAM prédéfini "AlloyDB Admin")roles/owner
(rôle IAM de base Propriétaire)roles/editor
(rôle IAM de base Éditeur)
Si vous ne disposez d'aucun de ces rôles, contactez l'administrateur de votre organisation pour demander l'accès.
Évoluer le type de machine d'une instance
Console
Dans la console Google Cloud, accédez à la page Clusters.
Cliquez sur un cluster dans la colonne Nom de la ressource.
Sur la page Présentation, accédez à la section Instances de votre cluster, puis cliquez sur Modifier l'instance principale ou Modifier le pool de lecture.
Notez que cette action n'est pas disponible si la page indique que l'état du cluster est Maintenance. L'action redevient disponible une fois que l'état Status (État) passe à Ready (Prêt).
Sélectionnez un type de machine.
Cliquez sur Mettre à jour l'instance ou Mettre à jour le pool de lecture.
gcloud
Pour utiliser gcloud CLI, vous pouvez installer et initialiser Google Cloud CLI ou utiliser Cloud Shell.
Utilisez la commande gcloud alloydb instances
update
pour modifier le type de machine de l'instance principale.
gcloud alloydb instances update INSTANCE_ID \
--cpu-count=CPU_COUNT \
--region=REGION_ID \
--cluster=CLUSTER_ID \
--project=PROJECT_ID
Remplacez les éléments suivants :
INSTANCE_ID
: ID de l'instance que vous mettez à jour.CPU_COUNT
: nombre de processeurs virtuels souhaités pour l'instance. Les valeurs valides sont les suivantes :2
: 2 vCPU, 16 Go de RAM4
: 4 vCPU, 32 Go de RAM8
: 8 vCPU, 64 Go de RAM16
: 16 vCPU, 128 Go de RAM32
: 32 processeurs virtuels, 256 Go de RAM64
: 64 vCPU, 512 Go de RAM96
: 96 vCPU, 768 Go de RAM128
: 128 vCPU, 864 Go de RAM
REGION_ID
: région où se trouve l'instance.CLUSTER_ID
: ID du cluster dans lequel se trouve l'instance.PROJECT_ID
: ID du projet dans lequel le cluster est placé.
Si la commande renvoie un message d'erreur incluant la phrase invalid cluster state MAINTENANCE
, cela signifie que le cluster est en cours de maintenance de routine. Cela interdit temporairement la reconfiguration de l'instance.
Exécutez à nouveau la commande une fois que le cluster est de nouveau dans l'état READY
.
Pour vérifier l'état du cluster, consultez Afficher les détails du cluster.
Évoluer le nombre de nœuds d'une instance de pool de lecture
AlloyDB vous permet d'ajuster le nombre de nœuds dans une instance de pool de lecture sans temps d'arrêt au niveau de l'instance. Lorsque vous augmentez le nombre de nœuds, les connexions client ne sont pas affectées.
Lorsque vous diminuez le nombre de nœuds, tous les clients connectés à un nœud en cours d'arrêt peuvent se reconnecter aux autres nœuds à l'aide du point de terminaison de l'instance.
Console
Dans la console Google Cloud, accédez à la page Clusters.
Cliquez sur un cluster dans la colonne Nom de la ressource.
Sur la page Présentation, accédez à la section Instances de votre cluster, puis cliquez sur Modifier le pool de lecture.
Notez que cette action n'est pas disponible si la page indique que l'état du cluster est Maintenance. L'action sera de nouveau disponible une fois que l'état Status (État) sera défini sur Ready (Prêt).
Dans le champ Nombre de nœuds, saisissez un nombre de nœuds. Remarque:Vous pouvez avoir jusqu'à 20 nœuds dans toutes les instances de pool de lecture d'un cluster.
Cliquez sur Mettre à jour le pool de lecture.
gcloud
Pour utiliser gcloud CLI, vous pouvez installer et initialiser Google Cloud CLI ou utiliser Cloud Shell.
Utilisez la commande gcloud alloydb instances
update
pour modifier le nombre de nœuds dans une instance de pool de lecture.
gcloud alloydb instances update INSTANCE_ID \
--read-pool-node-count=NODE_COUNT \
--region=REGION_ID \
--cluster=CLUSTER_ID \
--project=PROJECT_ID
INSTANCE_ID
: ID de l'instance de pool de lecture.NODE_COUNT
: nombre de nœuds dans l'instance de pool de lecture. Spécifiez un nombre compris entre1
et20
, inclus. Notez que vous ne pouvez pas avoir plus de 20 nœuds dans l'ensemble des instances de pool de lecture d'un cluster.REGION_ID:
Région dans laquelle se trouve l'instance.CLUSTER_ID
: ID du cluster dans lequel l'instance est placée.PROJECT_ID
: ID du projet dans lequel le cluster est placé.
Si la commande renvoie un message d'erreur incluant la phrase invalid cluster state MAINTENANCE
, cela signifie que le cluster est en cours de maintenance de routine. Cela interdit temporairement la reconfiguration de l'instance.
Exécutez à nouveau la commande une fois que le cluster est de nouveau dans l'état READY
. Pour vérifier l'état du cluster, consultez Afficher les détails du cluster.