Créer et gérer des clusters AlloyDB Express

Ce document explique comment créer, modifier, afficher, supprimer et mettre à niveau des clusters et des instances AlloyDB Express, et comment s'y connecter.

Pour en savoir plus sur les différences entre les fonctionnalités d'AlloyDB Express et celles d'AlloyDB, consultez la présentation d'AlloyDB Express. Pour créer un cluster AlloyDB, consultez Créer un cluster et son instance principale.

Avant de commencer

Avant de créer ou de gérer des clusters AlloyDB Express, remplissez les conditions préalables suivantes :

  • Activez l'API AlloyDB et les autres API requises dans votre projet Google Cloud afin que votre projet soit autorisé à accéder à AlloyDB.
  • Si vous utilisez le serveur MCP AlloyDB distant, configurez votre client MCP pour qu'il se connecte au point de terminaison du serveur MCP global (https://alloydb.googleapis.com/mcp) ou à un point de terminaison régional (https://alloydb.REGION_ID.rep.googleapis.com/mcp). Les points de terminaison régionaux sont actuellement en version preview.

Rôles requis

Pour obtenir les autorisations nécessaires pour créer et gérer des clusters et des instances AlloyDB Express, demandez à votre administrateur de vous accorder les rôles IAM suivants sur votre projet :

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Créer un cluster et une instance AlloyDB Express

Vous pouvez créer un cluster AlloyDB Express et son instance principale à l'aide de la console Google Cloud , de la Google Cloud CLI, de l'API REST AlloyDB ou du serveur MCP distant AlloyDB.

Un cluster AlloyDB Express est compatible avec PostgreSQL 18 et contient une seule instance principale zonale qui démarre avec 1 processeur virtuel (4 Go de RAM) et effectue un scaling automatique du stockage jusqu'à 20 Go. Si vous prévoyez de mettre à niveau une instance de 1 vCPU vers AlloyDB ultérieurement sans la redimensionner à 2 vCPU, créez votre cluster dans une région qui accepte également la série de machines C4A.

Les paramètres de connectivité par défaut dépendent de l'outil que vous utilisez :

  • Google Cloud  : active par défaut le DNS public sur l'instance principale et Private Service Connect sur le cluster. Vous pouvez configurer les projets de consommateur Private Service ConnectGoogle Cloud ultérieurement en modifiant les paramètres de connectivité de l'instance.

  • gcloud CLI, API REST et serveur MCP distant AlloyDB : n'active que Private Service Connect sur le cluster par défaut. Lorsque vous créez l'instance principale, activez le DNS public si vous souhaitez vous connecter via un DNS public, et ajoutez à la liste d'autorisation les projets clientsGoogle Cloud dans lesquels vous souhaitez créer des points de terminaison Private Service Connect pour l'instance.

Console

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

    Accéder à la page "Premiers pas"

    Si votre projet Google Cloud comporte déjà des clusters et que vous commencez à partir de la page Clusters, cliquez sur Créer un cluster dans la barre d'outils pour ouvrir la page Sélectionner une configuration. Les deux pages affichent des fiches de configuration de cluster prédéfinies (AlloyDB Express, Production (zone unique) et Production (multizone)).

  2. Dans la fiche AlloyDB Express, cliquez sur Créer un cluster pour ouvrir le volet Créer un cluster AlloyDB Express.

  3. Dans le volet Créer un cluster AlloyDB Express, configurez votre cluster :

    • Dans le champ ID de cluster, saisissez un ID pour votre cluster ou conservez l'ID par défaut.
    • Dans le champ Mot de passe, saisissez un mot de passe pour l'utilisateur postgres par défaut, ou cliquez sur Générer pour générer un mot de passe. Vous pouvez modifier le mot de passe ultérieurement sur la page Utilisateurs.
    • Dans le champ Région, sélectionnez une région compatible pour votre cluster. Si vous prévoyez de mettre à niveau une instance de 1 vCPU vers AlloyDB ultérieurement sans la redimensionner à 2 vCPU, sélectionnez une région compatible avec la série de machines C4A.

  4. Cliquez sur Créer un cluster.

    La console Google Cloud crée votre cluster AlloyDB Express et son instance principale à 1 vCPU, avec Private Service Connect et le DNS public activés par défaut, puis ouvre AlloyDB Studio pour vous permettre d'interroger votre base de données.

    Vous ne pouvez pas modifier les paramètres de connectivité lors de la création du cluster dans la consoleGoogle Cloud , mais vous pouvez mettre à jour les réseaux externes autorisés ou les paramètres Private Service Connect ultérieurement en modifiant les paramètres de connectivité de l'instance.

gcloud

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

  1. Pour créer un cluster AlloyDB Express, exécutez la commande gcloud beta alloydb clusters create avec l'option --enable-express :

    gcloud beta alloydb clusters create CLUSTER_ID \
    --region=REGION_ID \
    --password=PASSWORD \
    --enable-express \
    --project=PROJECT_ID

    Remplacez les éléments suivants :

    • CLUSTER_ID : ID du cluster que vous souhaitez créer. L'ID doit commencer par une lettre minuscule et peut contenir des lettres minuscules, des chiffres et des traits d'union.
    • REGION_ID : région compatible dans laquelle vous souhaitez créer le cluster. Si vous prévoyez de mettre à niveau une instance de 1 vCPU vers AlloyDB ultérieurement sans la redimensionner à 2 vCPU, choisissez une région qui est également compatible avec la série de machines C4A.
    • PASSWORD : mot de passe initial de l'utilisateur de base de données postgres par défaut.
    • PROJECT_ID : ID du projetGoogle Cloud dans lequel vous souhaitez créer le cluster.

  2. Pour créer l'instance principale dans votre cluster AlloyDB Express, exécutez la commande gcloud beta alloydb instances create et choisissez vos options de connectivité :

    • DNS public uniquement : spécifiez --enable-public-dns et omettez --allowed-psc-projects.
    • Private Service Connect uniquement : omettez --enable-public-dns et spécifiez --allowed-psc-projects=ALLOWED_PROJECT_ID pour autoriser les connexions Private Service Connect à partir de votre projet client Google Cloud .
    • DNS public et Private Service Connect : spécifiez à la fois --enable-public-dns et --allowed-psc-projects=ALLOWED_PROJECT_ID.
    gcloud beta alloydb instances create INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --instance-type=PRIMARY \
    --cpu-count=1 \
    --enable-public-dns \
    --allowed-psc-projects=ALLOWED_PROJECT_ID \
    --project=PROJECT_ID

    Remplacez les éléments suivants :

    • INSTANCE_ID : ID de l'instance principale que vous souhaitez créer.
    • ALLOWED_PROJECT_ID (facultatif) : liste d'ID ou de numéros de projets Google Cloud séparés par une virgule, autorisés à créer des points de terminaison Private Service Connect vers cette instance. Omettez --allowed-psc-projects si vous ne configurez que le DNS public.

REST

  1. Pour créer un cluster AlloyDB Express, envoyez une requête POST au point de terminaison projects.locations.clusters.create avec expressConfig.enabled défini sur true.

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

    • PROJECT_ID : ID de votre projetGoogle Cloud .
    • REGION_ID : région compatible dans laquelle vous souhaitez créer le cluster. Si vous prévoyez de mettre à niveau une instance de 1 vCPU vers AlloyDB ultérieurement sans la redimensionner à 2 vCPU, choisissez une région qui est également compatible avec la série de machines C4A.
    • CLUSTER_ID : ID du cluster que vous souhaitez créer.
    • INITIAL_USERNAME : nom de l'utilisateur initial de la base de données (par exemple, postgres).
    • INITIAL_USER_PASSWORD : mot de passe de l'utilisateur de la base de données initiale.

    Méthode HTTP et URL :

    POST https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters?clusterId=CLUSTER_ID

    Corps JSON de la requête :

    {
  "databaseVersion": "POSTGRES_18",
  "expressConfig": {
    "enabled": true
  },
  "initialUser": {
    "user": "INITIAL_USERNAME",
    "password": "INITIAL_USER_PASSWORD"
  }
}

  2. Une fois l'opération de création du cluster terminée, créez l'instance principale en envoyant une requête POST au point de terminaison projects.locations.clusters.instances.create avec machineConfig.cpuCount défini sur 1 (la spécification de toute valeur autre que 1 échoue lors de la création). Choisissez vos champs de connectivité dans le corps de la requête :

    • DNS public uniquement : définissez "networkConfig": {"publicDnsEnabled": true} et omettez "pscInstanceConfig".
    • Private Service Connect uniquement : omettez "publicDnsEnabled" (qui est défini par défaut sur false) et définissez "pscInstanceConfig": {"allowedConsumerProjects": ["ALLOWED_PROJECT_ID"]}.
    • DNS public et Private Service Connect : incluez à la fois "networkConfig": {"publicDnsEnabled": true} et "pscInstanceConfig": {"allowedConsumerProjects": ["ALLOWED_PROJECT_ID"]}.

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

    • INSTANCE_ID : ID de l'instance principale que vous souhaitez créer.
    • ALLOWED_PROJECT_ID (facultatif) : ID ou numéros des projets autorisés à créer des points de terminaison Private Service Connect vers cette instance.Google Cloud

    Méthode HTTP et URL :

    POST https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances?instanceId=INSTANCE_ID

    Corps JSON de la requête :

    {
  "instanceType": "PRIMARY",
  "availabilityType": "ZONAL",
  "machineConfig": {
    "cpuCount": 1
  },
  "networkConfig": {
    "publicDnsEnabled": true
  },
  "pscInstanceConfig": {
    "allowedConsumerProjects": [
      "ALLOWED_PROJECT_ID"
    ]
  }
}

MCP

Vous pouvez utiliser un client MCP ou appeler directement le serveur MCP distant AlloyDB pour créer un cluster AlloyDB Express et son instance principale.

Dans un client MCP, vous pouvez utiliser une seule requête pour créer à la fois le cluster AlloyDB Express et son instance principale. Votre client MCP appelle automatiquement create_cluster, interroge get_operation et appelle create_instance :

Create an AlloyDB Express cluster named CLUSTER_ID in REGION_ID with a primary instance named INSTANCE_ID.

Pour exécuter chaque étape individuellement ou appeler directement les outils MCP, procédez comme suit :

  1. Pour créer un cluster AlloyDB Express, saisissez une requête dans votre client MCP ou appelez l'outil MCP create_cluster avec express_config.enabled défini sur true.

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

    Dans votre client MCP, vous pouvez saisir un prompt semblable à celui-ci :

    Create an AlloyDB Express cluster named CLUSTER_ID in REGION_ID.

    Paramètres d'appel d'outil :

    {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "create_cluster",
    "arguments": {
      "parent": "projects/PROJECT_ID/locations/REGION_ID",
      "cluster_id": "CLUSTER_ID",
      "express_config": {
        "enabled": true
      }
    }
  }
}

    Pour rendre Private Service Connect accessible depuis un réseau VPC, ajoutez les projetsGoogle Cloud clients à la liste d'autorisation dans "psc_instance_config" lorsque vous créez ou mettez à jour l'instance principale.

  2. L'outil create_cluster renvoie une opération de longue durée. Interrogez l'état de l'opération à l'aide de l'outil MCP get_operation jusqu'à ce que done soit défini sur true et que le cluster soit à l'état READY.

  3. Pour créer l'instance principale dans votre cluster AlloyDB Express, saisissez une requête dans votre client MCP ou appelez l'outil MCP create_instance. Choisissez vos paramètres de connectivité :

    • DNS public uniquement : définissez "public_dns_enabled": true et omettez "psc_instance_config".

    • Private Service Connect uniquement : omettez "public_dns_enabled" (qui est défini par défaut sur false) et définissez "psc_instance_config" avec "allowed_consumer_projects" (ou "psc_auto_connections" en spécifiant "consumer_project" et "consumer_network").

    • DNS public et Private Service Connect : définissez à la fois "public_dns_enabled": true et "psc_instance_config".

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

    • INSTANCE_ID : ID de l'instance principale que vous souhaitez créer.

    • ALLOWED_PROJECT_ID (facultatif) :Google Cloud ID ou numéros des projets autorisés à créer des points de terminaison Private Service Connect vers cette instance.

    Dans votre client MCP, vous pouvez saisir un prompt semblable à celui-ci :

    Please create a primary instance named INSTANCE_ID in my AlloyDB Express cluster CLUSTER_ID.

    Paramètres d'appel d'outil :

    {
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "create_instance",
    "arguments": {
      "parent": "projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID",
      "instance_id": "INSTANCE_ID",
      "type": "PRIMARY",
      "public_dns_enabled": true,
      "psc_instance_config": {
        "allowed_consumer_projects": [
          "ALLOWED_PROJECT_ID"
        ]
      }
    }
  }
}

  4. Interrogez l'opération de création d'instance à l'aide de l'outil MCP get_operation jusqu'à ce que done soit défini sur true et que l'instance soit à l'état READY.

Se connecter à une instance AlloyDB Express

AlloyDB Express est compatible avec les options de connectivité de base de données entrantes suivantes :

  • DNS public (par défaut) : fournit un nom DNS routable publiquement (networkInfo.publicDnsName) pour vous permettre de vous connecter à partir de clients situés en dehors d'un réseau VPC.
  • Private Service Connect : vous permet de vous connecter en mode privé à votre instance depuis votre réseau VPC via des points de terminaison Private Service Connect, sans exposer votre base de données à l'Internet public.

Se connecter via un DNS public

Lorsque vous vous connectez via un DNS public depuis l'extérieur d'un réseau VPC, vous pouvez effectuer l'une des opérations suivantes :

Se connecter directement à l'aide d'un client PostgreSQL

Par défaut, le point de terminaison DNS public rejette toutes les adresses IP clientes directes. Vous devez ajouter vos blocs CIDR clients à la liste d'autorisation avant de vous connecter directement à psql.

  1. Configurez les réseaux externes autorisés sur votre instance principale.

    Vous ne pouvez pas ajouter ni supprimer de réseaux externes autorisés individuellement. Chaque mise à jour écrase la liste existante. Fournissez une liste d'éléments séparés par une virgule de tous les blocs CIDR que vous souhaitez autoriser.

    Console

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

      accéder aux clusters

    2. Dans la colonne Nom de la ressource, cliquez sur le nom de votre cluster AlloyDB Express.

    3. Sur la page Présentation, accédez à Instances de votre cluster, recherchez votre instance principale, puis cliquez sur  Actions sur l'instance > Modifier (ou accédez à Connectivité dans le menu de navigation, puis cliquez sur Modifier).

    4. Sous Connectivité, assurez-vous que la connectivité publique est activée.

    5. Sous Réseaux externes autorisés, saisissez une liste de plages CIDR IPv4 séparées par une virgule (par exemple, 203.0.113.0/24) ou cliquez sur Utiliser mon adresse IP pour ajouter l'adresse IPv4 /32 de votre machine actuelle.

    6. Cliquez sur Mettre à jour l'instance.

    gcloud

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

    Exécutez la commande gcloud alloydb instances update avec l'option --authorized-external-networks :

    gcloud alloydb instances update INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --authorized-external-networks=CIDR_RANGE1,CIDR_RANGE2 \
    --project=PROJECT_ID

    Remplacez les éléments suivants :

    • INSTANCE_ID : ID de votre instance principale AlloyDB Express.
    • CLUSTER_ID : ID de votre cluster AlloyDB Express.
    • REGION_ID : région où se trouve votre cluster.
    • CIDR_RANGE1, CIDR_RANGE2 : liste de plages d'adresses IPv4 séparées par une virgule, en notation CIDR (par exemple, 203.0.113.0/24).
    • PROJECT_ID : ID de votre projetGoogle Cloud .

    REST

    Envoyez une requête PATCH au point de terminaison projects.locations.clusters.instances.patch avec updateMask=networkConfig.authorizedExternalNetworks.

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

    • PROJECT_ID : ID de votre projetGoogle Cloud .
    • REGION_ID : région où se trouve votre cluster.
    • CLUSTER_ID : ID de votre cluster AlloyDB Express.
    • INSTANCE_ID : ID de votre instance principale AlloyDB Express.
    • CIDR_RANGE1, CIDR_RANGE2 : plages d'adresses IPv4 au format CIDR (par exemple, 203.0.113.0/24).

    Méthode HTTP et URL :

    PATCH https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID?updateMask=networkConfig.authorizedExternalNetworks

    Corps JSON de la requête :

    {
  "networkConfig": {
    "authorizedExternalNetworks": [
      {
        "cidrRange": "CIDR_RANGE1"
      },
      {
        "cidrRange": "CIDR_RANGE2"
      }
    ]
  }
}

    MCP

    Saisissez une requête dans votre client MCP ou appelez l'outil MCP update_instance avec le champ authorized_external_networks.

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

    • PROJECT_ID : ID de votre projetGoogle Cloud .

    • REGION_ID : région où se trouve votre cluster.

    • CLUSTER_ID : ID de votre cluster AlloyDB Express.

    • INSTANCE_ID : ID de votre instance principale AlloyDB Express.

    • CIDR_RANGE1, CIDR_RANGE2 : plages d'adresses IPv4 au format CIDR, par exemple 203.0.113.0/24.

    Dans votre client MCP, vous pouvez saisir un prompt semblable à celui-ci :

    Please update the AlloyDB instance INSTANCE_ID in cluster CLUSTER_ID to allow external connections from CIDR_RANGE1.

    Paramètres d'appel d'outil :

    {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "update_instance",
    "arguments": {
      "instance": "projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID",
      "authorized_external_networks": [
        "CIDR_RANGE1",
        "CIDR_RANGE2"
      ]
    }
  }
}

  2. Récupérez le nom DNS public de votre instance :

    Console

    1. Dans la console Google Cloud , accédez à la page Clusters et cliquez sur le nom de votre cluster AlloyDB Express.
    2. Accédez à Connectivité (ou affichez la fiche de l'instance principale sur la page Présentation) et copiez le nom DNS public de l'instance.

    gcloud

    Exécutez la commande gcloud beta alloydb instances describe pour récupérer la valeur networkInfo.publicDnsName :

    gcloud beta alloydb instances describe INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --format="value(networkInfo.publicDnsName)" \
    --project=PROJECT_ID

    Le résultat utilise le format suivant :

    IDENTIFIER.IDENTIFIER.REGION_ID.alloydb.s.cloud.goog

    Dans ce résultat, IDENTIFIER est un identifiant alphanumérique généré par le système.

    REST

    Envoyez une requête GET au point de terminaison projects.locations.clusters.instances.get et lisez le champ networkInfo.publicDnsName de la réponse :

    GET https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID

    MCP

    Saisissez un prompt dans votre client MCP ou appelez l'outil MCP get_instance, puis lisez le champ networkInfo.publicDnsName de la réponse.

    Dans votre client MCP, vous pouvez saisir un prompt semblable à celui-ci :

    Please get the public DNS name of the AlloyDB instance INSTANCE_ID in cluster CLUSTER_ID.

    Paramètres d'appel d'outil :

    {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_instance",
    "arguments": {
      "name": "projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID"
    }
  }
}

  3. Connectez-vous à votre base de données à l'aide d'un URI de connexion PostgreSQL standard et du nom DNS public de votre instance :

    psql postgresql://USERNAME@PUBLIC_DNS_NAME/DATABASE_NAME

    Remplacez les éléments suivants :

    • USERNAME : nom d'utilisateur de la base de données PostgreSQL (par exemple, postgres).
    • PUBLIC_DNS_NAME : nom DNS public de votre instance AlloyDB Express (par exemple, 1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d.a.us-central1.alloydb.s.cloud.goog).
    • DATABASE_NAME : nom de la base de données à laquelle se connecter (la base de données par défaut est postgres).

  4. Lorsque vous y êtes invité, saisissez le mot de passe de l'utilisateur de la base de données.

Se connecter à l'aide de la gcloud CLI ou du proxy d'authentification

Pour vous connecter via un DNS public sans configurer de réseaux externes autorisés, vous pouvez utiliser la commande gcloud beta alloydb connect ou le client proxy d'authentification autonome (alloydb-auth-proxy) avec l'option --public-ip. Bien qu'AlloyDB Express affiche un nom DNS public plutôt qu'une adresse IP publique, le plan de contrôle provisionne une connexion publique sous-jacente pour l'instance que le proxy d'authentification résout automatiquement lorsque vous spécifiez --public-ip.

Pour démarrer une instance de proxy d'authentification locale et ouvrir une session psql à l'aide de la gcloud CLI, exécutez la commande gcloud beta alloydb connect avec l'option --public-ip :

gcloud beta alloydb connect INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --public-ip \
    --user=USERNAME \
    --database=DATABASE_NAME \
    --project=PROJECT_ID

Remplacez les éléments suivants :

  • INSTANCE_ID : ID de votre instance principale AlloyDB Express.
  • CLUSTER_ID : ID de votre cluster AlloyDB Express.
  • REGION_ID : région où se trouve votre cluster.
  • USERNAME : nom d'utilisateur de la base de données (par défaut : postgres).
  • DATABASE_NAME : nom de la base de données (par défaut : postgres).
  • PROJECT_ID : ID de votre projet Google Cloud .

Pour en savoir plus sur la connexion avec la gcloud CLI, y compris l'authentification IAM de base de données (--auto-iam-authn), consultez Se connecter à l'aide de la gcloud CLI.

Vous pouvez également télécharger et exécuter le client proxy d'authentification autonome avec l'option --public-ip :

./alloydb-auth-proxy \
    "projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID" \
    --public-ip

Pour en savoir plus sur le téléchargement, la configuration et la connexion via le client proxy d'authentification autonome, consultez Se connecter à l'aide du proxy d'authentification AlloyDB.

Se connecter via Private Service Connect

Pour une connectivité privée depuis votre réseau VPC sans exposer votre base de données à l'Internet public, vous pouvez configurer Private Service Connect sur votre instance AlloyDB Express. Vous pouvez vous connecter à un point de terminaison Private Service Connect directement depuis un client de votre réseau VPC ou à l'aide du proxy d'authentification. Pour en savoir plus sur la connexion à Private Service Connect, consultez Se connecter à une instance à l'aide de Private Service Connect.

Lorsque vous suivez ces instructions pour AlloyDB Express, créez votre cluster et votre instance principale zonale à 1 vCPU comme décrit dans Créer un cluster et une instance AlloyDB Express avec Private Service Connect activé. AlloyDB Express est compatible avec la connectivité Private Service Connect entrante vers une seule instance principale zonale.

Modifier une instance AlloyDB Express

Vous pouvez modifier le nombre de processeurs (1 ou 2 vCPU) ou les indicateurs de base de données d'une instance principale AlloyDB Express.

Console

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

    accéder aux clusters

  2. Dans la colonne Nom de la ressource, cliquez sur le nom de votre cluster AlloyDB Express.

  3. Sur la page Présentation, dans la section Instances dans votre cluster, recherchez votre instance principale, puis cliquez sur Modifier l'instance principale (ou cliquez sur  Actions sur l'instance > Modifier).

  4. Sur la page Modifier l'instance principale, modifiez les paramètres de l'instance :

    • Sous Machine, dans la liste Type de machine, sélectionnez 1 vCPU, 4 Go ou 2 vCPU, 8 Go.
    • Facultatif : pour configurer des indicateurs de base de données, développez Indicateurs (ou cliquez sur Afficher les options avancées, puis développez Indicateurs) et cliquez sur Ajouter un indicateur. Sélectionnez un indicateur de base de données dans la liste Nouveau flag de base de données, indiquez une valeur, puis cliquez sur OK.

  5. Cliquez sur Mettre à jour l'instance.

gcloud

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

Pour faire évoluer l'instance en modifiant son nombre de processeurs (1 ou 2) ou pour mettre à jour ses indicateurs de base de données, exécutez la commande gcloud alloydb instances update :

gcloud alloydb instances update INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --cpu-count=CPU_COUNT \
    --database-flags=FLAGS \
    --project=PROJECT_ID

Remplacez les éléments suivants :

  • INSTANCE_ID : ID de votre instance principale AlloyDB Express.
  • CLUSTER_ID : ID de votre cluster AlloyDB Express.
  • REGION_ID : région où se trouve votre cluster.
  • CPU_COUNT : nombre de processeurs virtuels pour l'instance (1 pour 1 processeur virtuel, 4 Go de RAM ou 2 pour 2 processeurs virtuels, 8 Go de RAM).
  • FLAGS (facultatif) : liste d'indicateurs et de valeurs de base de données séparés par une virgule, au format FLAG_NAME=VALUE. Si vous ne mettez à jour que le nombre de processeurs, omettez l'option --database-flags. Pour en savoir plus sur les options compatibles, consultez la section Options de base de données compatibles.
  • PROJECT_ID : ID de votre projetGoogle Cloud .
  • --enable-public-dns ou --no-enable-public-dns : active ou désactive le DNS public pour l'instance. Cette option n'est disponible que dans gcloud beta (gcloud beta alloydb instances update).
  • --allowed-psc-projects=[ALLOWED_PSC_PROJECTS,...] : met à jour la liste d'ID ou de numéros de projets client Google Cloud autorisés à créer des points de terminaison Private Service Connect vers l'instance, séparés par une virgule.

REST

Pour mettre à jour le nombre de processeurs ou les indicateurs de base de données d'une instance principale AlloyDB Express, envoyez une requête PATCH au point de terminaison projects.locations.clusters.instances.patch et spécifiez les champs que vous mettez à jour dans le paramètre de requête updateMask.

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

  • PROJECT_ID : ID de votre projetGoogle Cloud .
  • REGION_ID : région où se trouve votre cluster.
  • CLUSTER_ID : ID de votre cluster AlloyDB Express.
  • INSTANCE_ID : ID de votre instance principale AlloyDB Express.
  • CPU_COUNT : nombre de processeurs virtuels pour l'instance (1 ou 2).
  • FLAG_NAME et FLAG_VALUE (facultatif) : nom et valeur de l'indicateur de base de données à définir. Si vous ne mettez à jour que le nombre de processeurs, définissez updateMask=machineConfig.cpuCount et omettez databaseFlags dans le corps de la requête.

Méthode HTTP et URL :

PATCH https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID?updateMask=machineConfig.cpuCount,databaseFlags

Corps JSON de la requête :

{
  "machineConfig": {
    "cpuCount": CPU_COUNT
  },
  "databaseFlags": {
    "FLAG_NAME": "FLAG_VALUE"
  }
}

MCP

Pour mettre à jour le nombre de processeurs ou les indicateurs de base de données d'une instance principale AlloyDB Express, saisissez une requête dans votre client MCP ou appelez l'outil MCP update_instance.

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

  • PROJECT_ID : ID de votre projetGoogle Cloud .

  • REGION_ID : région où se trouve votre cluster.

  • CLUSTER_ID : ID de votre cluster AlloyDB Express.

  • INSTANCE_ID : ID de votre instance principale AlloyDB Express.

  • CPU_COUNT : nombre de processeurs virtuels pour l'instance (1 ou 2).

  • FLAG_NAME et FLAG_VALUE (facultatif) : nom et valeur de l'indicateur de base de données à définir. Si vous ne mettez à jour que le nombre de processeurs, omettez database_flags de arguments.

Dans votre client MCP, vous pouvez saisir un prompt semblable à celui-ci :

Please update the AlloyDB instance INSTANCE_ID in cluster CLUSTER_ID to CPU_COUNT vCPUs.

Paramètres d'appel d'outil :

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "update_instance",
    "arguments": {
      "instance": "projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID",
      "cpu_count": CPU_COUNT,
      "database_flags": {
        "FLAG_NAME": "FLAG_VALUE"
      }
    }
  }
}

Afficher les détails d'un cluster et d'une instance AlloyDB Express

Vous pouvez afficher la liste de vos clusters AlloyDB Express, afficher les détails d'un cluster ou d'une instance AlloyDB Express spécifique, et vérifier l'utilisation du calcul et du stockage de votre cluster.

Pour en savoir plus, consultez Afficher la liste des clusters, Afficher les détails d'un cluster et Afficher les détails d'une instance.

Console

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

    accéder aux clusters

    Dans la colonne Nom de la ressource, les clusters AlloyDB Express affichent un tag  Express à côté du nom du cluster.

  2. Pour afficher des informations détaillées sur un cluster et son instance principale, cliquez sur le nom du cluster dans la colonne Nom de la ressource.

  3. Sur la page Vue d'ensemble, consultez les détails du cluster sous Détails du cluster (y compris le tag Express à côté de ID du cluster et Espace de stockage total utilisé sur la limite de 20 Go) et les détails de l'instance principale sous Instances de votre cluster.

gcloud

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

  • Pour afficher la liste des clusters de votre projet, exécutez la commande gcloud alloydb clusters list :

    gcloud alloydb clusters list --project=PROJECT_ID

  • Pour afficher des détails sur un cluster spécifique, exécutez la commande gcloud alloydb clusters describe :

    gcloud alloydb clusters describe CLUSTER_ID \
    --region=REGION_ID \
    --project=PROJECT_ID

  • Pour afficher des détails sur une instance spécifique, exécutez la commande gcloud alloydb instances describe :

    gcloud alloydb instances describe INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --project=PROJECT_ID

Remplacez les éléments suivants :

  • PROJECT_ID : ID de votre projetGoogle Cloud .
  • CLUSTER_ID : ID de votre cluster AlloyDB Express.
  • REGION_ID : région où se trouve votre cluster.
  • INSTANCE_ID : ID de votre instance principale AlloyDB Express.

REST

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

  • PROJECT_ID : ID de votre projetGoogle Cloud .
  • REGION_ID : région où se trouve votre cluster.
  • CLUSTER_ID : ID de votre cluster AlloyDB Express.

  • INSTANCE_ID : ID de votre instance principale AlloyDB Express.

  • Pour afficher la liste des clusters d'une région, envoyez une requête GET au point de terminaison projects.locations.clusters.list :

    GET https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters

  • Pour afficher les détails d'un cluster, envoyez une requête GET au point de terminaison projects.locations.clusters.get :

    GET https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID

  • Pour afficher les détails d'une instance, envoyez une requête GET au point de terminaison projects.locations.clusters.instances.get :

    GET https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID

MCP

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

  • PROJECT_ID : ID de votre projetGoogle Cloud .

  • REGION_ID : région où se trouve votre cluster.

  • CLUSTER_ID : ID de votre cluster AlloyDB Express.

  • INSTANCE_ID : ID de votre instance principale AlloyDB Express.

  • Pour afficher la liste des clusters d'une région, saisissez une requête dans votre client MCP ou appelez l'outil MCP list_clusters.

    Dans votre client MCP, vous pouvez saisir un prompt semblable à celui-ci :

    Please list the AlloyDB clusters in REGION_ID in project PROJECT_ID.

    Paramètres d'appel d'outil :

    {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_clusters",
    "arguments": {
      "parent": "projects/PROJECT_ID/locations/REGION_ID"
    }
  }
}

  • Pour afficher les détails d'un cluster, saisissez une requête dans votre client MCP ou appelez l'outil MCP get_cluster.

    Dans votre client MCP, vous pouvez saisir un prompt semblable à celui-ci :

    Please show the details of the AlloyDB cluster CLUSTER_ID in REGION_ID.

    Paramètres d'appel d'outil :

    {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_cluster",
    "arguments": {
      "name": "projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID"
    }
  }
}

  • Pour afficher les détails d'une instance, saisissez une requête dans votre client MCP ou appelez l'outil MCP get_instance.

    Dans votre client MCP, vous pouvez saisir un prompt semblable à celui-ci :

    Please show the details of the AlloyDB instance INSTANCE_ID in cluster CLUSTER_ID.

    Paramètres d'appel d'outil :

    {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_instance",
    "arguments": {
      "name": "projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID"
    }
  }
}

Afficher l'utilisation du calcul et du stockage

Pour vérifier le stockage et le calcul utilisés par votre cluster et votre instance principale AlloyDB Express, utilisez la console Google Cloud ou Cloud Monitoring :

  • Dans la console Google Cloud , ouvrez la page Présentation de votre cluster :

    • Espace de stockage utilisé : sous Détails du cluster, consultez Espace de stockage total utilisé pour connaître la quantité d'espace de stockage utilisée par votre cluster sur la limite de 20 Go.
    • Calcul et connexions : affichez les graphiques Utilisation du processeur et Connexions actives sur la page Présentation, ou cliquez sur Insights sur le système dans le menu de navigation pour afficher des métriques détaillées sur le processeur, la mémoire et l'espace de stockage.

  • Dans l'explorateur de métriques Cloud Monitoring, interrogez les métriques suivantes pour les types de ressources surveillées alloydb.googleapis.com/Cluster et alloydb.googleapis.com/Instance :

    • Espace de stockage utilisé : alloydb.googleapis.com/cluster/storage/usage
    • Utilisation du processeur : alloydb.googleapis.com/instance/cpu/average_utilization et alloydb.googleapis.com/instance/cpu/maximum_utilization
    • Connexions actives : alloydb.googleapis.com/database/postgresql/backends

Supprimer un cluster ou une instance AlloyDB Express

Vous pouvez supprimer une instance principale ou un cluster AlloyDB Express lorsque vous n'en avez plus besoin.

Pour en savoir plus, consultez Supprimer une instance et Supprimer un cluster.

Console

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

    accéder aux clusters

  2. Dans la colonne Nom de la ressource, cliquez sur le nom de votre cluster AlloyDB Express.

  3. Sur la page Présentation, supprimez l'instance principale ou le cluster :

    • Pour supprimer l'instance principale, accédez à la section Instances de votre cluster, cliquez sur Actions sur l'instance > Supprimer, saisissez l'ID de l'instance dans la boîte de dialogue, puis cliquez sur Supprimer.
    • Pour supprimer le cluster, supprimez d'abord l'instance principale du cluster, puis cliquez sur Supprimer le cluster, saisissez l'ID de votre cluster dans la boîte de dialogue Supprimer le cluster, puis cliquez sur Supprimer.

gcloud

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

  • Pour supprimer une instance, exécutez la commande gcloud alloydb instances delete :

    gcloud alloydb instances delete INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --project=PROJECT_ID

  • Pour supprimer un cluster, exécutez la commande gcloud alloydb clusters delete. Si le cluster contient toujours son instance principale, incluez l'option --force pour supprimer l'instance principale et le cluster en même temps :

    gcloud alloydb clusters delete CLUSTER_ID \
    --region=REGION_ID \
    --force \
    --project=PROJECT_ID

Remplacez les éléments suivants :

  • INSTANCE_ID : ID de votre instance principale AlloyDB Express.
  • CLUSTER_ID : ID de votre cluster AlloyDB Express.
  • REGION_ID : région où se trouve votre cluster.
  • PROJECT_ID : ID de votre projetGoogle Cloud .

REST

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

  • PROJECT_ID : ID de votre projetGoogle Cloud .
  • REGION_ID : région où se trouve votre cluster.
  • CLUSTER_ID : ID de votre cluster AlloyDB Express.

  • INSTANCE_ID : ID de votre instance principale AlloyDB Express.

  • Pour supprimer une instance, envoyez une requête DELETE au point de terminaison projects.locations.clusters.instances.delete :

    DELETE https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID

  • Pour supprimer un cluster (y compris son instance principale lorsque vous spécifiez force=true), envoyez une requête DELETE au point de terminaison projects.locations.clusters.delete :

    DELETE https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID?force=true

Mettre à niveau un cluster AlloyDB Express vers AlloyDB

Vous pouvez effectuer une mise à niveau sur place de votre cluster AlloyDB Express vers un cluster AlloyDB.

La mise à niveau préserve les données, les schémas, les extensions, les identifiants utilisateur, la configuration réseau (y compris votre nom DNS public et vos points de terminaison Private Service Connect) et le nombre de processeurs virtuels de l'instance principale.

La liste suivante décrit les ressources et les paramètres qui changent au cours du processus de mise à niveau :

  • Nombre de processeurs, ratio de mémoire et capacité de calcul : votre instance conserve son nombre actuel de processeurs virtuels (1 ou 2 vCPU) et passe du ratio vCPU/mémoire d'AlloyDB Express de 1:4 (4 ou 8 Go de RAM) au ratio vCPU/mémoire d'AlloyDB de 1:8 (8 Go de RAM pour 1 vCPU ou 16 Go de RAM pour 2 vCPU). Après la mise à niveau, vous pouvez faire évoluer le calcul jusqu'à 288 processeurs virtuels.
    • Lorsque vous mettez à niveau une instance à 1 processeur virtuel, vous êtes limité aux régions compatibles avec la série de machines C4A. Pour connaître les régions prises en charge, consultez Disponibilité régionale pour C4A.
    • Si votre instance AlloyDB Express ne se trouve pas dans une région compatible avec les types de machines C4A, vous devez d'abord mettre à jour votre instance principale vers une configuration à 2 vCPU avant de procéder à la mise à niveau. Dans la console Google Cloud , si vous cliquez sur Mettre à niveau pour une instance de 1 vCPU dans une région non compatible, un message vous invite à redimensionner d'abord votre instance à 2 vCPU.
  • Calcul et facturation provisionnés : la mise à niveau désactive le calcul avec scaling à zéro, et votre instance s'exécute en tant qu'instance AlloyDB toujours active facturée aux tarifs AlloyDB.
  • Capacité de stockage : la mise à niveau supprime la limite de stockage de 20 Go. Le stockage évolue jusqu'à un quota par défaut de 16 Tio par cluster, et vous pouvez demander une augmentation du quota de stockage pour passer à 128 Tio.
  • Fonctionnalités Enterprise : la mise à niveau débloque la haute disponibilité (HA) régionale, qui est couverte par le contrat de niveau de service (SLA) garantissant un temps d'activité de 99,99 %. Elle débloque également les instances de pool de lecture, la réplication interrégionale, la sauvegarde et la récupération continues, ainsi que les sauvegardes automatisées et à la demande.

Pour mettre à niveau votre cluster AlloyDB Express vers un cluster AlloyDB, procédez comme suit :

Console

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

    accéder aux clusters

  2. Dans la colonne Nom de la ressource, cliquez sur le nom de votre cluster AlloyDB Express.

  3. Sur la page Vue d'ensemble, sous Détails du cluster, recherchez ID du cluster, puis cliquez sur Mettre à niveau.

    Si votre instance principale est une instance à 1 vCPU dans une région qui n'est pas compatible avec la série de machines C4A, un message s'affiche :

    Upgrading to AlloyDB requires a 2 vCPU instance in the REGION_ID region. Resize your instance to 2 vCPUs first.

    Pour redimensionner votre instance à 2 vCPU, cliquez sur Modifier l'instance. Après avoir redimensionné votre instance, cliquez à nouveau sur Mettre à niveau.

  4. Dans le volet Mettre à niveau depuis AlloyDB Express, saisissez l'ID du cluster pour confirmer la mise à niveau, puis cliquez sur Confirmer.

gcloud

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

Pour mettre à niveau votre cluster AlloyDB Express vers un cluster AlloyDB, exécutez la commande gcloud beta alloydb clusters update avec l'option --no-enable-express :

gcloud beta alloydb clusters update CLUSTER_ID \
    --region=REGION_ID \
    --no-enable-express \
    --project=PROJECT_ID

Remplacez les éléments suivants :

  • CLUSTER_ID : ID de votre cluster AlloyDB Express.
  • REGION_ID : région où se trouve votre cluster.
  • PROJECT_ID : ID de votre projetGoogle Cloud .

Si votre instance principale est une instance à 1 processeur virtuel dans une région qui n'est pas compatible avec la série de machines C4A, la commande échoue avec l'erreur suivante :

Upgrading to AlloyDB is not supported for 1-vCPU instances in location "REGION_ID". Please update the instance to use 2 vCPUs and try the upgrade again.

Pour résoudre cette erreur, mettez à jour votre instance principale vers 2 vCPU (--cpu-count=2), puis exécutez à nouveau la commande de mise à niveau.

REST

Pour mettre à niveau votre cluster AlloyDB Express vers un cluster AlloyDB, envoyez une requête PATCH au point de terminaison projects.locations.clusters.patch avec updateMask=expressConfig.enabled et définissez expressConfig.enabled sur false.

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

  • PROJECT_ID : ID de votre projetGoogle Cloud .
  • REGION_ID : région où se trouve votre cluster.
  • CLUSTER_ID : ID de votre cluster AlloyDB Express.

Méthode HTTP et URL :

PATCH https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID?updateMask=expressConfig.enabled

Corps JSON de la requête :

{
  "expressConfig": {
    "enabled": false
  }
}

Si votre instance principale est une instance à 1 processeur virtuel dans une région qui n'est pas compatible avec la série de machines C4A, la requête échoue avec l'erreur suivante :

Upgrading to AlloyDB is not supported for 1-vCPU instances in location "REGION_ID". Please update the instance to use 2 vCPUs and try the upgrade again.

Pour résoudre cette erreur, mettez à jour votre instance principale vers 2 vCPU ("machineConfig": {"cpuCount": 2}), puis renvoyez la demande de mise à niveau.

Étapes suivantes