Évoluer une instance

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

  1. Dans la console Google Cloud, accédez à la page Clusters.

    accéder aux clusters

  2. Cliquez sur un cluster dans la colonne Nom de la ressource.

  3. 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).

  4. Sélectionnez l'une des séries de machines suivantes:

    • C4A (série de machines Google Axion) (preview)
    • N2 (série de machines x86) Il s'agit de la série de machines par défaut.

  5. Sélectionnez un type de machine.

  6. 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 \
--machine-type=MACHINE_TYPE \
--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 N2 que vous souhaitez pour l'instance. N2 est la valeur par défaut. Les valeurs valides sont les suivantes:

    • 2: 2 vCPU, 16 Go de RAM
    • 4: 4 vCPU, 32 Go de RAM
    • 8: 8 vCPU, 64 Go de RAM
    • 16: 16 vCPU, 128 Go de RAM
    • 32: 32 processeurs virtuels, 256 Go de RAM
    • 64: 64 vCPU, 512 Go de RAM
    • 96: 96 vCPU, 768 Go de RAM
    • 128: 128 vCPU, 864 Go de RAM

  • MACHINE_TYPE: ce paramètre est facultatif lorsque vous déployez des machines N2. Pour déployer la série de machines C4A basée sur Axion (Preview) ou pour migrer entre les machines C4A et N2, choisissez ce paramètre avec les valeurs suivantes.

    Lorsque vous utilisez MACHINE_TYPE et CPU_COUNT ensemble, les valeurs de CPU_COUNT et MACHINE_TYPE doivent correspondre, sinon une erreur s'affiche.

    Pour les séries de machines C4A basées sur Axion, choisissez le type de machine avec les valeurs suivantes:

    • c4a-highmem-1
    • c4a-highmem-4-lssd
    • c4a-highmem-8-lssd
    • c4a-highmem-16-lssd
    • c4a-highmem-32-lssd
    • c4a-highmem-48-lssd
    • c4a-highmem-64-lssd
    • c4a-highmem-72-lssd

    Pour déployer C4A avec 4 processeurs virtuels ou plus, utilisez le suffixe lssd pour activer le cache ultra-rapide.

    Pour en savoir plus sur l'utilisation de la série de machines basée sur Axion C4A, y compris le type de machine à un vCPU, consultez la section Considérations à prendre en compte lors de l'utilisation de la série de machines basée sur Axion C4A.

    Pour la série de machines N2 basées sur l'architecture x86, utilisez les valeurs suivantes:

    • N2-highmem-2
    • N2-highmem-4
    • N2-highmem-8
    • N2-highmem-16
    • N2-highmem-32
    • N2-highmem-64
    • N2-highmem-96
    • N2-highmem-128

  • 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

  1. Dans la console Google Cloud, accédez à la page Clusters.

    accéder aux clusters

  2. Cliquez sur un cluster dans la colonne Nom de la ressource.

  3. 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 État passera à Prêt.

  4. 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.

  5. 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 du pool de lecture.

  • NODE_COUNT: nombre de nœuds dans l'instance de pool de lecture. Spécifiez un nombre compris entre 1 et 20, 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.