Créer une instance de pool de lecture dans un cluster AlloyDB

Cette page explique comment créer une instance de pool de lecture dans un cluster AlloyDB pour PostgreSQL.

Avant de commencer

  • Le projet Google Cloud que vous utilisez doit avoir été activé pour 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 d'administrateur AlloyDB)
    • 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.

Créer une instance de pool de lecture

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. Accédez à la section Instances de votre cluster, puis cliquez sur Ajouter un pool de lecture.

  4. Configurez votre instance de pool de lecture :

    1. Dans le champ ID de l'instance de pool de lecture, saisissez un ID pour l'instance de pool de lecture.

    2. Dans le champ Nombre de nœuds, saisissez le nombre de nœuds.

      Le nombre de nœuds dans une instance de pool de lecture détermine la capacité de calcul globale de l'instance.

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

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

    4. Sélectionnez un type de machine.

      • C4A est compatible avec les types ou formes de machines 1, 4, 8, 16, 32, 48, 64 et 72.
      • N2 est compatible avec les types ou formes de machines 2, 4, 8, 16, 32, 64, 96 et 128.

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

      1. Facultatif : Pour connecter vos applications et clients via l'Internet public, cliquez sur Activer l'adresse IP publique dans Connectivité de l'adresse IP publique. L'activation de l'adresse IP publique peut nécessiter une configuration supplémentaire pour garantir une connexion sécurisée. Pour en savoir plus, consultez Se connecter à l'aide d'une adresse IP publique.

      Par défaut, l'adresse IP privée est toujours activée. Pour en savoir plus, consultez Activer l'accès aux services privés.

      1. Facultatif : Pour activer et utiliser le pool de connexions géré, cochez la case Activer le pool de connexions géré sous Pool de connexions géré. Pour en savoir plus, consultez Configurer le pooling de connexions géré.

      2. Choisissez les paramètres de sécurité de votre réseau. Pour sécuriser vos données, nous vous recommandons d'utiliser le chiffrement mTLS avec les connecteurs AlloyDB ou le chiffrement SSL.

      Lorsque vous modifiez vos paramètres de sécurité, votre instance peut être utilisée, mais les connexions non conformes existantes sont supprimées.

    5. Facultatif : Définissez des indicateurs personnalisés pour votre instance. Pour chaque signalement, procédez comme suit :

      1. Cliquez sur Options de configuration avancées.
      2. Cliquez sur Ajouter une option de base de données.
      3. Sélectionnez un indicateur dans la liste Nouvel indicateur de base de données.
      4. Indiquez une valeur pour l'option.
      5. Cliquez sur OK.

  5. Cliquez sur Ajouter un pool de lecture.

gcloud

Pour utiliser la gcloud CLI, vous pouvez installer et initialiser Google Cloud CLI, ou utiliser Cloud Shell.

Utilisez la commande gcloud alloydb instances create pour créer une instance de pool de lecture.

gcloud alloydb instances create INSTANCE_ID \
 --instance-type=READ_POOL \
 --read-pool-node-count=NODE_COUNT \
 --region=REGION_ID \
 --cluster=CLUSTER_ID \
 --cpu-count=CPU_COUNT \
 --machine-type=MACHINE_TYPE \
 --project=PROJECT_ID

Remplacez les éléments suivants :

  • INSTANCE_ID : ID de l'instance que vous créez. Il doit commencer par une lettre minuscule et peut contenir des lettres minuscules, des chiffres et des traits d'union.

  • NODE_COUNT : nombre de nœuds dans l'instance. Spécifiez un nombre compris entre 1 et 20 (inclus). Notez que vous ne pouvez pas avoir plus de 20 nœuds dans toutes les instances de pool de lecture d'un cluster.

  • REGION_ID : région dans laquelle vous souhaitez placer l'instance.

  • CLUSTER_ID : ID du cluster dans lequel vous souhaitez placer l'instance.

  • CPU_COUNT : nombre de processeurs virtuels souhaité pour l'instance.

    • Vous devez spécifier cpu_count ou machine_type.
    • Si seul cpu_count est fourni, une instance N2 est créée avec les spécifications suivantes :
      • 2 : 2 processeurs virtuels, 16 Go de RAM
      • 4 : 4 processeurs virtuels, 32 Go de RAM
      • 8 : 8 processeurs virtuels, 64 Go de RAM
      • 16 : 16 vCPU, 128 Go de RAM
      • 32 : 32 processeurs virtuels, 256 Go de RAM
      • 64 : 64 vCPUs, 512 Go de RAM
      • 96 : 96 vCPU, 768 Go de RAM
      • 128 : 128 vCPU, 864 Go de RAM
    • Si machine_type et cpu_count sont fournis, la valeur cpu_count doit correspondre au nombre de vCPU spécifié dans machine_type. Par exemple, si machine_type est défini sur n2-highmem-4, vous devez définir cpu_count sur 4.

  • MACHINE_TYPE : type de machine de l'instance.

    • Pour la série de machines C4A basée sur Axion, les valeurs valides sont les 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 la série de machines N2, les valeurs valides sont les 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

    • Lorsque vous utilisez machine_type et cpu_count ensemble, les valeurs de cpu_count et machine_type doivent correspondre. Par exemple, si machine_type est défini sur n2-highmem-4, vous devez définir cpu_count sur 4.

  • PROJECT_ID : ID du projet dans lequel le cluster est placé.

Pour créer une instance de pool de lecture pour un cluster compatible avec Private Service Connect, ajoutez l'indicateur --allowed-psc-projects afin de définir une liste d'ID de projet ou de [numéros de projet](/resource-manager/docs/creating-managing-projects#identifying_projects) séparés par une virgule auxquels vous souhaitez autoriser l'accès à l'instance (par exemple, my-project-1, 12345,my-project-n).

gcloud alloydb instances create INSTANCE_ID \
 --instance-type=READ_POOL \
 --region=REGION_ID \
 --cluster=CLUSTER_ID \
 --cpu-count=CPU_COUNT \
 --machine-type=MACHINE_TYPE \
 --project=PROJECT_ID \
 --allowed-psc-projects=ALLOWED_PROJECT_LIST

Remplacez les éléments suivants :

  • ALLOWED_PROJECT (facultatif) : liste des ID ou numéros de projets séparés par une virgule auxquels vous souhaitez autoriser l'accès à l'instance (par exemple, my-project-1, 12345, my-project-n). Vous devez définir une liste de projets ou de numéros autorisés si votre cluster utilise Private Service Connect comme méthode de connexion à l'instance.

Pour activer le pooling de connexions géré dans votre instance de pool de lecture, ajoutez le flag --enable-connection-pooling à la commande gcloud alloydb instances create :

gcloud alloydb instances create INSTANCE_ID \
 --instance-type=READ_POOL \
 --region=REGION_ID \
 --cluster=CLUSTER_ID \
 --cpu-count=CPU_COUNT \
 --machine-type=MACHINE_TYPE \
 --project=PROJECT_ID \
 --enable-connection-pooling

Pour créer une instance de pool de lecture pour un cluster avec adresse IP publique activée, ajoutez le paramètre --assign-inbound-public-ip=ASSIGN_IPV4.

gcloud alloydb instances create INSTANCE_ID \
 --instance-type=READ_POOL \
 --region=REGION_ID \
 --cluster=CLUSTER_ID \
 --cpu-count=CPU_COUNT \
 --machine-type=MACHINE_TYPE \
 --project=PROJECT_ID \
 --assign-inbound-public-ip=ASSIGN_IPV4

Vous pouvez également transmettre la liste des blocs CIDR séparés par une virgule, par exemple 64.233.160.0/16, au paramètre --authorized-external-networks pour définir les réseaux externes autorisés sur votre instance.

Étapes suivantes