Créer un cluster et son instance principale

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Console

1. Accédez à la page Clusters.

   accéder aux clusters

2. Cliquez sur Créer un cluster.

3. Choisissez une configuration de cluster. Pour en savoir plus sur la différence entre les configurations haute disponibilité et les configurations de base, consultez la section Nœuds et instances.

   Si vous ne savez pas si votre nouveau cluster a besoin d'instances de pool de lecture, choisissez l'une des configurations sans pool de lecture. Vous pourrez ajouter des instances de pool de lecture au cluster ultérieurement, si nécessaire.

4. Cliquez sur Continuer.

5. Dans la section Configurer votre cluster, dans le champ ID du cluster, saisissez un ID pour votre cluster.

6. Dans le champ Password (Mot de passe), saisissez un mot de passe initial pour le nouveau cluster. AlloyDB attribue le mot de passe fourni à l'utilisateur de la base de données postgres lors de la création du cluster.

7. Dans le champ Database version (Version de la base de données), sélectionnez la version majeure de PostgreSQL avec laquelle les serveurs de base de données du cluster doivent être compatibles.

8. Sélectionnez une région. Pour les charges de travail de développement et de bac à sable, envisagez la forme 1 vCPU (en preview), qui est disponible dans certaines régions. Pour en savoir plus, consultez la section Considérations à prendre en compte lorsque vous utilisez un seul vCPU.

9. Sélectionnez un chemin réseau.

10. Facultatif: Pour appliquer une plage d'adresses IP spécifique à ce cluster, au lieu d'autoriser AlloyDB à choisir une plage d'adresses IP, procédez comme suit:

    1. Cliquez sur Afficher l'option de plage d'adresses IP allouée.

    2. Dans la liste Plage d'adresses IP allouée, sélectionnez une plage d'adresses IP.

    Pour en savoir plus sur cette option, consultez la section Créer un cluster avec une plage d'adresses IP spécifique.

11. Facultatif: Pour chiffrer ce cluster à l'aide d'une clé de chiffrement gérée par le client (CMEK) au lieu du chiffrement géré par Google, procédez comme suit:

    1. Cliquez sur Options de chiffrement avancées.

    2. Sélectionnez Clé de chiffrement gérée par le client (CMEK).

    3. Dans le menu qui s'affiche, sélectionnez une clé gérée par le client.

       La console Google Cloud limite cette liste aux clés du même projet et de la même région que le nouveau cluster. Google Cloud Pour utiliser une clé qui ne figure pas dans cette liste, cliquez sur Vous ne trouvez pas votre clé ? Saisissez un nom de ressource de clé, puis saisissez le nom de la ressource de la clé dans la boîte de dialogue qui s'affiche.

       Notez que l'utilisation de CMEK avec AlloyDB nécessite une configuration supplémentaire. Pour en savoir plus, consultez Utiliser CMEK avec AlloyDB.

    4. Cliquez sur Continuer.

12. Configurez votre instance principale:

    1. Dans le champ ID d'instance, saisissez un ID pour votre instance principale.

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

    3. Sélectionnez un type de machine.

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

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

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

       1. Cliquez sur Ajouter une option.
       2. Dans la liste Nouveau flag de base de données, sélectionnez un flag.
       3. Indiquez une valeur pour l'indicateur.
       4. Cliquez sur OK.

13. Si vous avez choisi un type de cluster sans pools de lecture, cliquez sur Créer un cluster.

gcloud

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

1. Pour créer le cluster avec l'accès aux services privés ou Private Service Connect activé, utilisez la commande gcloud alloydb clusters create.

   Accès aux services privés

   gcloud alloydb clusters create CLUSTER_ID \
       --database-version=POSTGRES_VERSION \
       --password=PASSWORD \
       --region=REGION_ID \
       --project=PROJECT_ID \
       --network=NETWORK

   Private Service Connect

   gcloud alloydb clusters create CLUSTER_ID \
       --database-version=POSTGRES_VERSION \
       --password=PASSWORD \
       --region=REGION_ID \
       --project=PROJECT_ID \
       --enable-private-service-connect 

   Remplacez les éléments suivants :

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

   • VERSION: version majeure de PostgreSQL avec laquelle vous souhaitez que les serveurs de base de données du cluster soient compatibles. Choisissez l'une des options suivantes :

     • 14, pour la compatibilité avec PostgreSQL 14

     • 15, pour la compatibilité avec PostgreSQL 15, qui est la version PostgreSQL par défaut prise en charge

     • 16, pour la compatibilité avec PostgreSQL 16

   • PASSWORD: mot de passe à utiliser pour l'utilisateur postgres par défaut.

   • NETWORK (facultatif): nom du réseau VPC que vous avez configuré pour l'accès aux services privés à AlloyDB. Si vous omettez l'option --network, AlloyDB utilise le réseau default.

   • --enable-private-service-connect (facultatif): défini pour activer Private Service Connect comme méthode de connectivité pour le cluster et ses instances.

   • REGION_ID: région dans laquelle vous souhaitez placer le cluster.

   • PROJECT_ID: ID du projet dans lequel vous souhaitez placer le cluster.

   Cette commande lance une opération de longue durée et renvoie un ID d'opération.

2. Facultatif: Pour appliquer une plage d'adresses IP spécifique à ce cluster, au lieu d'autoriser AlloyDB à choisir une plage d'adresses IP, fournissez l'argument suivant:

   --allocated-ip-range-name=RANGE
   

   Remplacez RANGE par le nom de la plage d'adresses IP que vous souhaitez que ce cluster utilise pour l'accès aux services privés.

   Pour en savoir plus sur cette option, consultez la section Créer un cluster avec une plage d'adresses IP spécifique.

3. Facultatif: Pour chiffrer ce cluster à l'aide d'une clé de chiffrement gérée par le client (CMEK) au lieu du chiffrement géré par Google par défaut, fournissez les arguments suivants:

   --kms-key=KEY_ID \
   --kms-keyring=KEYRING_ID \
   --kms-location=LOCATION_ID \
   --kms-project=PROJECT_ID
   

   Remplacez les éléments suivants :

   • KEY_ID: ID de la clé CMEK à utiliser.

   • KEYRING_ID: ID du trousseau de clés de la clé.

   • LOCATION_ID: ID de la région du trousseau, qui doit être identique à celle du cluster.

   • PROJECT_ID: ID du projet du trousseau de clés.

4. Vérifiez que l'opération a réussi.

   gcloud alloydb operations describe OPERATION_ID \
       --region=REGION_ID \
       --project=PROJECT_ID

   Remplacez OPERATION_ID par l'ID d'opération renvoyé à l'étape précédente.

Après avoir créé le cluster principal, vous devez créer une instance principale.

Créer une instance principale

Pour créer une instance principale, utilisez la commande gcloud alloydb instances create.

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

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.

• 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 vCPU ou plus, utilisez le suffixe lssd pour activer le cache ultra-rapide.

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

  Pour la série de machines N2 basées sur l'architecture x86, utilisez le type de machine avec 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 dans laquelle vous souhaitez placer l'instance.

• CLUSTER_ID: ID du cluster que vous avez créé précédemment.

• PROJECT_ID: ID du projet dans lequel le cluster

• ALLOWED_PROJECT_LIST (facultatif): liste d'ID de projet ou de numéro de projet séparés par une virgule auxquels vous souhaitez autoriser l'accès à l'instance, si vous utilisez Private Service Connect.

Terraform

Pour créer un cluster, utilisez une ressource Terraform.

Voici un extrait de code permettant de créer un cluster basé sur l'exemple Cluster AlloyDB complet:

resource "google_alloydb_cluster" "cluster_abc" {
  cluster_id = "alloydb-cluster"
  location   = "us-central1"
  network_config {
    network = google_compute_network.default.id
  }
  database_version = "POSTGRES_15"

  initial_user {
    user     = "postgres"
    password = "postgres"
  }

  continuous_backup_config {
    enabled              = true
    recovery_window_days = 14
  }

  automated_backup_policy {
    location      = "us-central1"
    backup_window = "1800s"
    enabled       = true

    weekly_schedule {
      days_of_week = ["MONDAY"]

      start_times {
        hours   = 23
        minutes = 0
        seconds = 0
        nanos   = 0
      }
    }

    quantity_based_retention {
      count = 1
    }

    labels = {
      test = "alloydb-cluster-backup-policy-labels"
    }
  }

  labels = {
    test = "alloydb-cluster-labels"
  }
}

data "google_project" "project" {}

resource "google_compute_network" "default" {
  name = "alloydb-cluster-network"
}

Préparer Cloud Shell

Pour appliquer votre configuration Terraform dans un projet Google Cloud, préparez Cloud Shell comme suit:

1. Lancez Cloud Shell.

2. Définissez le projet Google Cloud par défaut dans lequel vous souhaitez appliquer vos configurations Terraform.

   Vous n'avez besoin d'exécuter cette commande qu'une seule fois par projet et vous pouvez l'exécuter dans n'importe quel répertoire.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   Les variables d'environnement sont remplacées si vous définissez des valeurs explicites dans le fichier de configuration Terraform.

Préparer le répertoire

Chaque fichier de configuration Terraform doit avoir son propre répertoire, également appelé module racine.

1. Dans Cloud Shell, créez un répertoire et un nouveau fichier dans ce répertoire. Le nom de fichier doit être un fichier TF, par exemple main.tf. Dans ce document, le fichier est appelé main.tf.

   mkdir DIRECTORY && cd DIRECTORY && touch main.tf

2. Copiez l'exemple de code dans le fichier main.tf que vous venez de créer. Vous pouvez également copier le code depuis GitHub. Cela est recommandé lorsque l'extrait Terraform fait partie d'une solution de bout en bout.
3. Examinez le fichier main.tf et modifiez les exemples de paramètres à appliquer à votre environnement.
4. Enregistrez les modifications.
5. Initialisez Terraform. Cette opération n'est à effectuer qu'une seule fois par répertoire.

   terraform init

   Facultatif: Pour utiliser la dernière version du fournisseur Google, incluez l'option -upgrade:

   terraform init -upgrade

Appliquer les modifications

1. Examinez la configuration pour vous assurer que les mises à jour Terraform correspondent à vos attentes:

   terraform plan

   Corrigez les modifications de la configuration si nécessaire.
2. Appliquez la configuration Terraform en exécutant la commande suivante et en saisissant yes lorsque vous y êtes invité:

   terraform apply

   Attendez que Terraform affiche le message Apply complete!.
3. Ouvrez votre projet Google Cloud pour afficher les résultats. Dans la console Google Cloud, accédez à vos ressources dans l'interface utilisateur pour vous assurer que Terraform les a créées ou mises à jour.

REST v1

Cet exemple crée un cluster. Le paramètre network est obligatoire. Pour obtenir la liste complète des paramètres de cet appel, consultez Méthode: projects.locations.clusters.create. Pour en savoir plus sur les paramètres de cluster, consultez Voir les paramètres des clusters et des instances.

N'incluez pas d'informations sensibles ou permettant d'identifier personnellement l'utilisateur dans l'ID de cluster, car les utilisateurs externes peuvent le voir. Vous n'avez pas besoin d'indiquer l'ID du projet dans le nom du cluster. Cet ajout s'effectue automatiquement le cas échéant, par exemple dans les fichiers journaux.

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

• CLUSTER_ID: ID du cluster que vous créez. Il doit commencer par une lettre minuscule et peut contenir des lettres minuscules, des chiffres et des traits d'union.
• PROJECT_ID: ID du projet dans lequel vous souhaitez placer le cluster.

• LOCATION_ID: ID de la région du cluster.

• NETWORK: nom du réseau VPC que vous avez configuré pour l'accès aux services privés à AlloyDB.

• DATABASE_VERSION: chaîne d'énumération de la version de base de données, par exemple POSTGRES_15.

• INITIAL_USERNAME: nom d'utilisateur à utiliser pour l'utilisateur postgres par défaut.

• INITIAL_USER_PASSWORD: mot de passe à utiliser pour l'utilisateur postgres par défaut.

Le corps de la requête JSON se présente comme suit:

{
  clusterId = "CLUSTER_ID"
  network = "projects/PROJECT_ID/global/networks/NETWORK"
  databaseVersion = "DATABASE_VERSION"

  initialUser {
    user     = "INITIAL_USERNAME"
    password = "INITIAL_USER_PASSWORD"
  }

  continuousBackupConfig {
    enabled              = true
    recoveryWindowDays = 14
  }

  weeklySchedule {
    daysOfWeek = ["MONDAY"]

      startTimes {
        hours   = 23
        minutes = 0
        seconds = 0
        nanos   = 0
      }
  }

    quantityBasedRetention {
      count = 1
    }

    labels = {
      test = "alloydb-cluster-full"
    }
  }
}

Pour envoyer votre requête, enregistrez le corps de la requête dans un fichier nommé request.json et utilisez la requête POST suivante:

  POST https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters