Crea y administra clústeres de AlloyDB Express

En este documento, se describe cómo crear, conectar, editar, ver, borrar y actualizar clústeres e instancias de AlloyDB Express.

Para obtener más información sobre cómo las funciones de AlloyDB Express se diferencian de las de AlloyDB, consulta Descripción general de AlloyDB Express. Para crear un clúster de AlloyDB, consulta Crea un clúster y su instancia principal.

Antes de comenzar

Antes de crear o administrar clústeres de AlloyDB Express, completa los siguientes requisitos previos:

Roles obligatorios

Para obtener los permisos que necesitas para crear y administrar clústeres y las instancias de AlloyDB Express, pídele a tu administrador que te otorgue los siguientes roles de IAM en tu proyecto:

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Crea un clúster y una instancia de AlloyDB Express

Puedes crear un clúster de AlloyDB Express y su instancia principal con la consola de Google Cloud , Google Cloud CLI, la API de REST de AlloyDB o el servidor de MCP remoto de AlloyDB.

Un clúster de AlloyDB Express admite PostgreSQL 18 y contiene una sola instancia principal zonal que comienza con 1 CPU virtual (4 GB de RAM) y escala el almacenamiento de forma automática hasta 20 GB. Si planeas actualizar una instancia de 1 CPU virtual en su lugar a AlloyDB más adelante sin cambiar el tamaño a 2 CPU virtuales, crea tu clúster en una región que también admita la serie de máquinas C4A.

La configuración de conectividad predeterminada depende de la herramienta que uses:

  • Consola deGoogle Cloud : habilita el DNS público en la instancia principal y Private Service Connect en el clúster de forma predeterminada. Puedes configurar los proyectos de consumidor de Private Service Connect Google Cloud más adelante editando la configuración de conectividad de la instancia.

  • gcloud CLI, API de REST y servidor de MCP remoto de AlloyDB: Solo habilita Private Service Connect en el clúster de forma predeterminada. Cuando crees la instancia principal, habilita el DNS público si deseas conectarte a través de él y agrega a la lista de entidades permitidas los proyectos de consumidor deGoogle Cloud en los que quieras crear extremos de Private Service Connect para la instancia.

Console

  1. En la consola de Google Cloud , ve a la página Comenzar.

    Ir a Comenzar

    Si tu proyecto de Google Cloud ya tiene clústeres y, en su lugar, comienzas desde la página Clústeres, haz clic en Crear clúster en la barra de herramientas para abrir la página Seleccionar configuración. En ambas páginas, se muestran tarjetas de configuración de clústeres predeterminadas (AlloyDB Express, Producción (zona única) y Producción (multizona)).

  2. En la tarjeta AlloyDB Express, haz clic en Crear clúster para abrir el panel Crear un clúster de AlloyDB Express.

  3. En el panel Crea un clúster de AlloyDB Express, configura tu clúster:

  4. Haga clic en Crear clúster.

    La consola de Google Cloud crea tu clúster de AlloyDB Express y su instancia principal de 1 CPU virtual con Private Service Connect y el DNS público habilitados de forma predeterminada y, luego, abre AlloyDB Studio para que puedas consultar tu base de datos.

    No puedes cambiar la configuración de conectividad durante la creación del clúster en la consola deGoogle Cloud , pero puedes actualizar las redes externas autorizadas o la configuración de Private Service Connect más adelante editando la configuración de conectividad de la instancia.

gcloud

Para usar gcloud CLI, puedes instalar e inicializar Google Cloud CLI, o bien puedes usar Cloud Shell.

  1. Para crear un clúster de AlloyDB Express, ejecuta el comando gcloud beta alloydb clusters create con la marca --enable-express:

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

    Reemplaza lo siguiente:

    • CLUSTER_ID: Es el ID del clúster que deseas crear. El ID debe comenzar con una letra minúscula y puede contener letras minúsculas, números y guiones.
    • REGION_ID: Es la región admitida en la que deseas crear el clúster. Si planeas actualizar una instancia de 1 CPU virtual a AlloyDB más adelante sin cambiar el tamaño a 2 CPU virtuales, elige una región que también admita la serie de máquinas C4A.
    • PASSWORD: Es la contraseña inicial del usuario de la base de datos postgres predeterminado.
    • PROJECT_ID: Es el ID del proyecto deGoogle Cloud en el que quieres crear el clúster.

  2. Para crear la instancia principal en tu clúster de AlloyDB Express, ejecuta el comando gcloud beta alloydb instances create y elige tus marcas de conectividad:

    • Solo DNS público: Especifica --enable-public-dns y omite --allowed-psc-projects.
    • Solo para Private Service Connect: omite --enable-public-dns y especifica --allowed-psc-projects=ALLOWED_PROJECT_ID para permitir conexiones de Private Service Connect desde tu proyecto Google Cloud de consumidor.
    • DNS público y Private Service Connect: especifica --enable-public-dns y --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

    Reemplaza lo siguiente:

    • INSTANCE_ID: Es el ID de la instancia principal que deseas crear.
    • ALLOWED_PROJECT_ID (opcional): Es una lista separada por comas de IDs o números de proyecto de Google Cloud que pueden crear extremos de Private Service Connect para esta instancia. Omite --allowed-psc-projects si solo configuras el DNS público.

REST

  1. Para crear un clúster de AlloyDB Express, envía una solicitud POST al extremo projects.locations.clusters.create con expressConfig.enabled establecido en true.

    Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

    • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
    • REGION_ID: Es la región admitida en la que deseas crear el clúster. Si planeas actualizar una instancia de 1 CPU virtual a AlloyDB más adelante sin cambiar el tamaño a 2 CPU virtuales, elige una región que también admita la serie de máquinas C4A.
    • CLUSTER_ID: Es el ID del clúster que deseas crear.
    • INITIAL_USERNAME: Es el nombre de usuario del usuario inicial de la base de datos (por ejemplo, postgres).
    • INITIAL_USER_PASSWORD: Es la contraseña del usuario inicial de la base de datos.

    Método HTTP y URL:

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

    Cuerpo JSON de la solicitud:

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

  2. Después de que se complete la operación de creación del clúster, crea la instancia principal enviando una solicitud POST al extremo projects.locations.clusters.instances.create con machineConfig.cpuCount establecido en 1 (especificar cualquier valor que no sea 1 falla en la creación). Elige los campos de conectividad en el cuerpo de la solicitud:

    • Solo DNS público: configura "networkConfig": {"publicDnsEnabled": true} y omite "pscInstanceConfig".
    • Solo para Private Service Connect: omite "publicDnsEnabled" (que se establece de forma predeterminada en false) y configura "pscInstanceConfig": {"allowedConsumerProjects": ["ALLOWED_PROJECT_ID"]}.
    • DNS público y Private Service Connect: Incluye "networkConfig": {"publicDnsEnabled": true} y "pscInstanceConfig": {"allowedConsumerProjects": ["ALLOWED_PROJECT_ID"]}.

    Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

    • INSTANCE_ID: Es el ID de la instancia principal que deseas crear.
    • ALLOWED_PROJECT_ID (opcional): Son los ID o números de proyecto deGoogle Cloud que pueden crear extremos de Private Service Connect para esta instancia.

    Método HTTP y URL:

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

    Cuerpo JSON de la solicitud:

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

MCP

Puedes usar un cliente de MCP o llamar al servidor de MCP remoto de AlloyDB directamente para crear un clúster de AlloyDB Express y su instancia principal.

En un cliente de MCP, puedes usar un solo mensaje para crear el clúster de AlloyDB Express y su instancia principal. Tu cliente de MCP llama automáticamente a create_cluster, sondea get_operation y llama a create_instance:

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

Para ejecutar cada paso de forma individual o llamar a las herramientas de MCP directamente, sigue estos pasos:

  1. Para crear un clúster de AlloyDB Express, ingresa una instrucción en tu cliente de MCP o llama a la herramienta de MCP create_cluster con express_config.enabled establecido en true.

    Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

    En tu cliente de MCP, puedes ingresar una instrucción similar a la siguiente:

    Create an AlloyDB Express cluster named CLUSTER_ID in REGION_ID.

    Parámetros de la llamada a la herramienta:

    {
  "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
      }
    }
  }
}

    Para que se pueda acceder a Private Service Connect desde una red de VPC, agrega a la lista de entidades permitidas los proyectos de consumidor deGoogle Cloud en "psc_instance_config" cuando crees o actualices la instancia principal.

  2. La herramienta create_cluster devuelve una operación de larga duración. Sondea el estado de la operación con la herramienta de MCP get_operation hasta que done sea true y el clúster esté en el estado READY.

  3. Para crear la instancia principal en tu clúster de AlloyDB Express, ingresa una instrucción en tu cliente de MCP o llama a la herramienta de MCP create_instance. Elige la configuración de conectividad:

    • Solo DNS público: configura "public_dns_enabled": true y omite "psc_instance_config".

    • Solo para Private Service Connect: omite "public_dns_enabled" (que se establece de forma predeterminada en false) y configura "psc_instance_config" con "allowed_consumer_projects" (o "psc_auto_connections" especificando "consumer_project" y "consumer_network").

    • DNS público y Private Service Connect: configura "public_dns_enabled": true y "psc_instance_config".

    Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

    • INSTANCE_ID: Es el ID de la instancia principal que deseas crear.

    • ALLOWED_PROJECT_ID: Es opcional. Son los IDs o números de proyecto deGoogle Cloud que pueden crear extremos de Private Service Connect para esta instancia.

    En tu cliente de MCP, puedes ingresar una instrucción similar a la siguiente:

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

    Parámetros de la llamada a la herramienta:

    {
  "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. Sondea la operación de creación de la instancia con la herramienta de MCP get_operation hasta que done sea true y la instancia esté en el estado READY.

Conéctate a una instancia de AlloyDB Express

AlloyDB Express admite las siguientes opciones de conectividad de base de datos entrante:

  • DNS público (predeterminado): Proporciona un nombre de DNS enrutable de forma pública (networkInfo.publicDnsName) para que puedas conectarte desde clientes fuera de una red de VPC.
  • Private Service Connect: Te permite conectarte de forma privada a tu instancia desde tu red de VPC a través de extremos de Private Service Connect sin exponer tu base de datos al Internet público.

Conéctate a través de un DNS público

Cuando te conectas a través de un DNS público desde fuera de una red de VPC, puedes hacer lo siguiente:

Conéctate directamente con un cliente de PostgreSQL

De forma predeterminada, el extremo de DNS público rechaza todas las direcciones IP de clientes directos. Debes incluir en la lista de entidades permitidas tus bloques CIDR de cliente antes de conectarte directamente con psql.

  1. Configura redes externas autorizadas en tu instancia principal.

    No puedes agregar ni quitar redes externas autorizadas de forma individual. Cada actualización reemplaza la lista existente. Proporciona una lista separada por comas de todos los bloques CIDR que deseas permitir.

    Console

    1. En la consola de Google Cloud , ve a la página Clústeres.

      Ir a los clústeres

    2. En la columna Nombre del recurso, haz clic en el nombre de tu clúster de AlloyDB Express.

    3. En la página Descripción general, ve a Instancias en tu clúster, ubica tu instancia principal y haz clic en Acciones de la instancia > Editar (o ve a Conectividad en el menú de navegación y haz clic en Editar).

    4. En Conectividad, asegúrate de que la conectividad pública esté habilitada.

    5. En Redes externas autorizadas, ingresa una lista separada por comas de rangos CIDR IPv4 (por ejemplo, 203.0.113.0/24) o haz clic en Usar mi IP para agregar la dirección IPv4 /32 de tu máquina actual.

    6. Haz clic en Actualizar instancia.

    gcloud

    Para usar gcloud CLI, puedes instalar e inicializar Google Cloud CLI, o bien puedes usar Cloud Shell.

    Ejecuta el comando gcloud alloydb instances update con la marca --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

    Reemplaza lo siguiente:

    • INSTANCE_ID: Es el ID de tu instancia principal de AlloyDB Express.
    • CLUSTER_ID: Es el ID de tu clúster de AlloyDB Express.
    • REGION_ID: Es la región en la que se encuentra el clúster.
    • CIDR_RANGE1, CIDR_RANGE2: Es una lista separada por comas de rangos de direcciones IPv4 en notación CIDR (por ejemplo, 203.0.113.0/24).
    • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .

    REST

    Envía una solicitud PATCH al extremo projects.locations.clusters.instances.patch con updateMask=networkConfig.authorizedExternalNetworks.

    Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

    • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
    • REGION_ID: Es la región en la que se encuentra el clúster.
    • CLUSTER_ID: Es el ID de tu clúster de AlloyDB Express.
    • INSTANCE_ID: Es el ID de tu instancia principal de AlloyDB Express.
    • CIDR_RANGE1, CIDR_RANGE2: Son rangos de direcciones IPv4 en notación CIDR (por ejemplo, 203.0.113.0/24).

    Método HTTP y URL:

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

    Cuerpo JSON de la solicitud:

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

    MCP

    Ingresa una instrucción en tu cliente de MCP o llama a la herramienta de MCP update_instance con el campo authorized_external_networks.

    Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

    • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .

    • REGION_ID: Es la región en la que se encuentra el clúster.

    • CLUSTER_ID: Es el ID de tu clúster de AlloyDB Express.

    • INSTANCE_ID: Es el ID de tu instancia principal de AlloyDB Express.

    • CIDR_RANGE1, CIDR_RANGE2: Son rangos de direcciones IPv4 en notación CIDR, como 203.0.113.0/24.

    En tu cliente de MCP, puedes ingresar una instrucción similar a la siguiente:

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

    Parámetros de la llamada a la herramienta:

    {
  "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. Recupera el nombre de DNS público de tu instancia:

    Console

    1. En la consola de Google Cloud , ve a la página Clústeres y haz clic en el nombre de tu clúster de AlloyDB Express.
    2. Ve a Conectividad (o consulta la tarjeta de la instancia principal en la página Descripción general) y copia el nombre de DNS público de la instancia.

    gcloud

    Ejecuta el comando gcloud beta alloydb instances describe para recuperar el valor de networkInfo.publicDnsName:

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

    El resultado usa el siguiente formato:

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

    En este resultado, IDENTIFIER es un identificador alfanumérico generado por el sistema.

    REST

    Envía una solicitud GET al extremo projects.locations.clusters.instances.get y lee el campo networkInfo.publicDnsName de la respuesta:

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

    MCP

    Ingresa una instrucción en tu cliente de MCP o llama a la herramienta de MCP get_instance y lee el campo networkInfo.publicDnsName de la respuesta.

    En tu cliente de MCP, puedes ingresar una instrucción similar a la siguiente:

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

    Parámetros de la llamada a la herramienta:

    {
  "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. Conéctate a tu base de datos con un URI de conexión de PostgreSQL estándar y el nombre de DNS público de tu instancia:

    psql postgresql://USERNAME@PUBLIC_DNS_NAME/DATABASE_NAME

    Reemplaza lo siguiente:

    • USERNAME: Es el nombre de usuario de la base de datos de PostgreSQL (por ejemplo, postgres).
    • PUBLIC_DNS_NAME: Es el nombre de DNS público de tu instancia de AlloyDB Express (por ejemplo, 1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d.a.us-central1.alloydb.s.cloud.goog).
    • DATABASE_NAME: Es el nombre de la base de datos a la que te conectarás (la base de datos predeterminada es postgres).

  4. Cuando se te solicite, ingresa la contraseña del usuario de la base de datos.

Conéctate con gcloud CLI o el proxy de autenticación

Para conectarte a través de un DNS público sin configurar redes externas autorizadas, puedes usar el comando gcloud beta alloydb connect o el cliente proxy de autenticación independiente (alloydb-auth-proxy) con la marca --public-ip. Aunque AlloyDB Express muestra un nombre de DNS público en lugar de una dirección IP pública, el plano de control aprovisiona una conexión pública subyacente para la instancia que el proxy de autenticación resuelve automáticamente cuando especificas --public-ip.

Para iniciar una instancia local del proxy de autenticación y abrir una sesión de psql con gcloud CLI, ejecuta el comando gcloud beta alloydb connect con la marca --public-ip:

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

Reemplaza lo siguiente:

  • INSTANCE_ID: Es el ID de tu instancia principal de AlloyDB Express.
  • CLUSTER_ID: Es el ID de tu clúster de AlloyDB Express.
  • REGION_ID: Es la región en la que se encuentra el clúster.
  • USERNAME: el nombre de usuario de la base de datos (el valor predeterminado es postgres).
  • DATABASE_NAME: Es el nombre de la base de datos (el valor predeterminado es postgres).
  • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .

Para obtener más información sobre cómo conectarte con gcloud CLI, incluida la autenticación de la base de datos de IAM (--auto-iam-authn), consulta Conéctate con gcloud CLI.

Como alternativa, puedes descargar y ejecutar el cliente del proxy de autenticación independiente con la marca --public-ip:

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

Para obtener información sobre cómo descargar, configurar y conectarse a través del cliente independiente del proxy de autenticación, consulta Conéctate con el proxy de autenticación de AlloyDB.

Conéctate a través de Private Service Connect

Para obtener conectividad privada desde tu red de VPC sin exponer tu base de datos al Internet público, puedes configurar Private Service Connect en tu instancia de AlloyDB Express. Puedes conectarte a un extremo de Private Service Connect directamente desde un cliente dentro de tu red de VPC o con el proxy de autenticación. Para obtener más información sobre cómo conectarte a Private Service Connect, consulta Conéctate a una instancia con Private Service Connect.

Cuando sigas esas instrucciones para AlloyDB Express, crea tu clúster y la instancia principal zonal de 1 CPU virtual, como se describe en Crea un clúster y una instancia de AlloyDB Express con Private Service Connect habilitado. AlloyDB Express admite la conectividad entrante de Private Service Connect a una sola instancia principal zonal.

Edita una instancia de AlloyDB Express

Puedes actualizar el recuento de CPU (1 CPU virtual o 2 CPU virtuales) o las marcas de base de datos de una instancia principal de AlloyDB Express.

Console

  1. En la consola de Google Cloud , ve a la página Clústeres.

    Ir a los clústeres

  2. En la columna Nombre del recurso, haz clic en el nombre de tu clúster de AlloyDB Express.

  3. En la página Descripción general, en la sección Instancias en tu clúster, busca tu instancia principal y haz clic en Editar instancia principal (o haz clic en Acciones de la instancia > Editar).

  4. En la página Editar instancia principal, actualiza la configuración de la instancia:

    • En Máquina, en la lista Tipo de máquina, selecciona 1 CPU virtual, 4 GB o 2 CPU virtuales, 8 GB.
    • Opcional: Para configurar las marcas de base de datos, expande Marcas (o haz clic en Mostrar opciones avanzadas y expande Marcas) y haz clic en Agregar marca. Selecciona una marca de la lista Nueva marca de base de datos, proporciona un valor y haz clic en Listo.

  5. Haz clic en Actualizar instancia.

gcloud

Para usar gcloud CLI, puedes instalar e inicializar Google Cloud CLI, o bien puedes usar Cloud Shell.

Para escalar la instancia cambiando su recuento de CPU (1 o 2) o para actualizar sus marcas de base de datos, ejecuta el comando 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

Reemplaza lo siguiente:

  • INSTANCE_ID: Es el ID de tu instancia principal de AlloyDB Express.
  • CLUSTER_ID: Es el ID de tu clúster de AlloyDB Express.
  • REGION_ID: Es la región en la que se encuentra el clúster.
  • CPU_COUNT: Es la cantidad de CPUs virtuales para la instancia (1 para 1 CPU virtual, 4 GB de RAM o 2 para 2 CPUs virtuales, 8 GB de RAM).
  • FLAGS (opcional): Es una lista separada por comas de marcas de base de datos y valores en el formato FLAG_NAME=VALUE. Si solo actualizas el recuento de CPU, omite la marca --database-flags. Para obtener más información sobre las marcas compatibles, consulta Marcas de base de datos compatibles.
  • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
  • --enable-public-dns o --no-enable-public-dns: habilita o inhabilita el DNS público para la instancia. Esta marca solo está disponible en gcloud beta (gcloud beta alloydb instances update).
  • --allowed-psc-projects=[ALLOWED_PSC_PROJECTS,...]: Actualiza la lista separada por comas de los ID del proyecto o números de proyecto de consumidor Google Cloud que pueden crear extremos de Private Service Connect en la instancia.

REST

Para actualizar el recuento de CPU o las marcas de base de datos de una instancia principal de AlloyDB Express, envía una solicitud PATCH al extremo projects.locations.clusters.instances.patch y especifica los campos que estás actualizando en el parámetro de consulta updateMask.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
  • REGION_ID: Es la región en la que se encuentra el clúster.
  • CLUSTER_ID: Es el ID de tu clúster de AlloyDB Express.
  • INSTANCE_ID: Es el ID de tu instancia principal de AlloyDB Express.
  • CPU_COUNT: Es la cantidad de CPU virtuales para la instancia (1 o 2).
  • FLAG_NAME y FLAG_VALUE (opcional): Es el nombre y el valor de la marca de base de datos que se establecerán. Si solo actualizas el recuento de CPU, establece updateMask=machineConfig.cpuCount y omite databaseFlags del cuerpo de la solicitud.

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

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

MCP

Para actualizar el recuento de CPU o las marcas de base de datos de una instancia principal de AlloyDB Express, ingresa una instrucción en tu cliente de MCP o llama a la herramienta de MCP update_instance.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .

  • REGION_ID: Es la región en la que se encuentra el clúster.

  • CLUSTER_ID: Es el ID de tu clúster de AlloyDB Express.

  • INSTANCE_ID: Es el ID de tu instancia principal de AlloyDB Express.

  • CPU_COUNT: Es la cantidad de CPUs virtuales para la instancia (1 o 2).

  • FLAG_NAME y FLAG_VALUE: opcional: el nombre y el valor de la marca de base de datos que se establecerán. Si solo actualizas el recuento de CPU, omite database_flags de arguments.

En tu cliente de MCP, puedes ingresar una instrucción similar a la siguiente:

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

Parámetros de la llamada a la herramienta:

{
  "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"
      }
    }
  }
}

Ver los detalles del clúster y de la instancia de AlloyDB Express

Puedes ver una lista de tus clústeres de AlloyDB Express, ver detalles sobre un clúster o una instancia específicos de AlloyDB Express y verificar el uso de procesamiento y almacenamiento de tu clúster.

Para obtener más información, consulta Visualiza la lista de clústeres, Visualiza los detalles del clúster y Visualiza los detalles de la instancia.

Console

  1. En la consola de Google Cloud , ve a la página Clústeres.

    Ir a los clústeres

    En la columna Nombre del recurso, los clústeres de AlloyDB Express muestran una etiqueta Express junto al nombre del clúster.

  2. Para ver información detallada sobre un clúster y su instancia principal, haz clic en el nombre del clúster en la columna Nombre del recurso.

  3. En la página Descripción general, consulta los detalles del clúster en Detalles del clúster (incluida la etiqueta Express junto al ID del clúster y el Almacenamiento total usado del límite de 20 GB) y los detalles de la instancia principal en Instancias en tu clúster.

gcloud

Para usar gcloud CLI, puedes instalar e inicializar Google Cloud CLI, o bien puedes usar Cloud Shell.

  • Para ver una lista de los clústeres de tu proyecto, ejecuta el comando gcloud alloydb clusters list:

    gcloud alloydb clusters list --project=PROJECT_ID

  • Para visualizar detalles sobre un clúster específico, ejecuta el comando gcloud alloydb clusters describe:

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

  • Para ver los detalles de una instancia específica, ejecuta el comando gcloud alloydb instances describe:

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

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
  • CLUSTER_ID: Es el ID de tu clúster de AlloyDB Express.
  • REGION_ID: Es la región en la que se encuentra el clúster.
  • INSTANCE_ID: Es el ID de tu instancia principal de AlloyDB Express.

REST

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
  • REGION_ID: Es la región en la que se encuentra el clúster.
  • CLUSTER_ID: Es el ID de tu clúster de AlloyDB Express.

  • INSTANCE_ID: Es el ID de tu instancia principal de AlloyDB Express.

  • Para ver una lista de clústeres en una región, envía una solicitud GET al extremo projects.locations.clusters.list:

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

  • Para ver los detalles de un clúster, envía una solicitud GET al extremo projects.locations.clusters.get:

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

  • Para ver los detalles de una instancia, envía una solicitud GET al extremo projects.locations.clusters.instances.get:

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

MCP

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .

  • REGION_ID: Es la región en la que se encuentra el clúster.

  • CLUSTER_ID: Es el ID de tu clúster de AlloyDB Express.

  • INSTANCE_ID: Es el ID de tu instancia principal de AlloyDB Express.

  • Para ver una lista de clústeres en una región, ingresa una instrucción en tu cliente de MCP o llama a la herramienta de MCP list_clusters.

    En tu cliente de MCP, puedes ingresar una instrucción similar a la siguiente:

    Please list the AlloyDB clusters in REGION_ID in project PROJECT_ID.

    Parámetros de la llamada a la herramienta:

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

  • Para ver los detalles de un clúster, ingresa una instrucción en tu cliente de MCP o llama a la herramienta de MCP get_cluster.

    En tu cliente de MCP, puedes ingresar una instrucción similar a la siguiente:

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

    Parámetros de la llamada a la herramienta:

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

  • Para ver detalles sobre una instancia, ingresa una instrucción en tu cliente de MCP o llama a la herramienta de MCP get_instance.

    En tu cliente de MCP, puedes ingresar una instrucción similar a la siguiente:

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

    Parámetros de la llamada a la herramienta:

    {
  "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"
    }
  }
}

Visualiza el uso de procesamiento y almacenamiento

Para verificar el almacenamiento y el procesamiento que usan tu clúster y la instancia principal de AlloyDB Express, usa la consola de Google Cloud o Cloud Monitoring:

  • En la consola de Google Cloud , abre la página Descripción general del clúster:

    • Almacenamiento usado: en Detalles del clúster, consulta Almacenamiento total usado para ver cuánto almacenamiento usa tu clúster del límite de 20 GB.
    • Procesamiento y conexiones: Consulta los gráficos Uso de CPU y Conexiones activas en la página Descripción general, o haz clic en Estadísticas del sistema en el menú de navegación para ver las métricas detalladas de CPU, memoria y almacenamiento.

  • En el Explorador de métricas de Cloud Monitoring, consulta las siguientes métricas para los tipos de recurso supervisado alloydb.googleapis.com/Cluster y alloydb.googleapis.com/Instance:

    • Almacenamiento usado: alloydb.googleapis.com/cluster/storage/usage
    • Uso de CPU: alloydb.googleapis.com/instance/cpu/average_utilization y alloydb.googleapis.com/instance/cpu/maximum_utilization
    • Conexiones activas: alloydb.googleapis.com/database/postgresql/backends

Borra un clúster o una instancia de AlloyDB Express

Puedes borrar una instancia principal o un clúster de AlloyDB Express cuando ya no los necesites.

Para obtener más información, consulta Borra una instancia y Borra un clúster.

Console

  1. En la consola de Google Cloud , ve a la página Clústeres.

    Ir a los clústeres

  2. En la columna Nombre del recurso, haz clic en el nombre de tu clúster de AlloyDB Express.

  3. En la página Descripción general, borra la instancia principal o el clúster:

    • Para borrar la instancia principal, ve a la sección Instancias en tu clúster, haz clic en Acciones de la instancia > Borrar, ingresa el ID de la instancia en el cuadro de diálogo y haz clic en Borrar.
    • Para borrar el clúster, primero borra la instancia principal en el clúster y, luego, haz clic en Borrar clúster, ingresa el ID del clúster en el cuadro de diálogo Borrar clúster y haz clic en Borrar.

gcloud

Para usar gcloud CLI, puedes instalar e inicializar Google Cloud CLI, o bien puedes usar Cloud Shell.

  • Para borrar una instancia, ejecuta el comando gcloud alloydb instances delete:

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

  • Para borrar un clúster, ejecuta el comando gcloud alloydb clusters delete. Si el clúster aún contiene su instancia principal, incluye la marca --force para borrar la instancia principal y el clúster juntos:

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

Reemplaza lo siguiente:

  • INSTANCE_ID: Es el ID de tu instancia principal de AlloyDB Express.
  • CLUSTER_ID: Es el ID de tu clúster de AlloyDB Express.
  • REGION_ID: Es la región en la que se encuentra el clúster.
  • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .

REST

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
  • REGION_ID: Es la región en la que se encuentra el clúster.
  • CLUSTER_ID: Es el ID de tu clúster de AlloyDB Express.

  • INSTANCE_ID: Es el ID de tu instancia principal de AlloyDB Express.

  • Para borrar una instancia, envía una solicitud DELETE al extremo projects.locations.clusters.instances.delete:

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

  • Para borrar un clúster (incluida su instancia principal cuando especificas force=true), envía una solicitud DELETE al extremo projects.locations.clusters.delete:

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

Actualiza un clúster de AlloyDB Express a AlloyDB

Puedes realizar una actualización in situ de tu clúster de AlloyDB Express a un clúster de AlloyDB.

La actualización conserva los datos, los esquemas, las extensiones, las credenciales de usuario, la configuración de red (incluidos el nombre de DNS público y los extremos de Private Service Connect) y el recuento de CPUs virtuales de la instancia principal de la base de datos.

En la siguiente lista, se describen los recursos y la configuración que cambian durante el proceso de actualización:

  • Recuento de CPU, proporción de memoria y capacidad de procesamiento: Tu instancia conserva su recuento de CPU virtuales actual (1 o 2 CPU virtuales) y se actualiza de la proporción de CPU virtuales a memoria de 1:4 de AlloyDB Express (4 GB u 8 GB de RAM) a la proporción de CPU virtuales a memoria de 1:8 de AlloyDB (8 GB de RAM para 1 CPU virtual o 16 GB de RAM para 2 CPU virtuales). Después de la actualización, puedes escalar el procesamiento hasta 288 vCPUs.
    • Cuando actualizas una instancia de 1 CPU virtual, estás limitado a las regiones que admiten la serie de máquinas C4A. Para conocer las regiones admitidas, consulta Disponibilidad regional para C4A.
    • Si tu instancia de AlloyDB Express no se encuentra en una región que admita tipos de máquinas C4A, primero debes actualizar tu instancia principal a una configuración de 2 CPU virtuales antes de actualizar. En la consola de Google Cloud , si haces clic en Actualizar para una instancia de 1 CPU virtual en una región no admitida, un mensaje te solicitará que primero cambies el tamaño de tu instancia a 2 CPU virtuales.
  • Procesamiento y facturación aprovisionados: La actualización inhabilita el procesamiento con reducción de escala a cero, y tu instancia se ejecuta como una instancia de AlloyDB siempre activa que se factura según las tarifas de AlloyDB.
  • Capacidad de almacenamiento: La actualización quita el límite de almacenamiento de 20 GB. El almacenamiento escala hasta una cuota predeterminada de 16 TiB por clúster, y puedes solicitar un aumento de la cuota de almacenamiento para escalar hasta 128 TiB.
  • Funciones de Enterprise: La actualización desbloquea la alta disponibilidad (HA) regional, que está cubierta por el acuerdo de nivel de servicio (ANS) de tiempo de actividad del 99.99%. También desbloquea instancias de grupos de lectura, replicación entre regiones, copia de seguridad y recuperación continuas, y copias de seguridad automáticas y a pedido.

Para actualizar tu clúster de AlloyDB Express a un clúster de AlloyDB, sigue estos pasos:

Console

  1. En la consola de Google Cloud , ve a la página Clústeres.

    Ir a los clústeres

  2. En la columna Nombre del recurso, haz clic en el nombre de tu clúster de AlloyDB Express.

  3. En la página Descripción general, en Detalles del clúster, busca ID del clúster y, luego, haz clic en Actualizar.

    Si tu instancia principal es una instancia de 1 CPU virtual en una región que no admite la serie de máquinas C4A, aparecerá un mensaje:

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

    Para cambiar el tamaño de tu instancia a 2 CPUs virtuales, haz clic en Editar instancia. Después de cambiar el tamaño de la instancia, vuelve a hacer clic en Actualizar.

  4. En el panel Actualiza desde AlloyDB Express, ingresa el ID del clúster para confirmar la actualización y, luego, haz clic en Confirmar.

gcloud

Para usar gcloud CLI, puedes instalar e inicializar Google Cloud CLI, o bien puedes usar Cloud Shell.

Para actualizar tu clúster de AlloyDB Express a un clúster de AlloyDB, ejecuta el comando gcloud beta alloydb clusters update con la marca --no-enable-express:

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

Reemplaza lo siguiente:

  • CLUSTER_ID: Es el ID de tu clúster de AlloyDB Express.
  • REGION_ID: Es la región en la que se encuentra el clúster.
  • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .

Si tu instancia principal es una instancia de 1 CPU virtual en una región que no admite la serie de máquinas C4A, el comando falla con el siguiente error:

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.

Para resolver este error, actualiza tu instancia principal a 2 vCPUs (--cpu-count=2) y, luego, vuelve a ejecutar el comando de actualización.

REST

Para actualizar tu clúster de AlloyDB Express a un clúster de AlloyDB, envía una solicitud PATCH al extremo projects.locations.clusters.patch con updateMask=expressConfig.enabled y establece expressConfig.enabled en false.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
  • REGION_ID: Es la región en la que se encuentra el clúster.
  • CLUSTER_ID: Es el ID de tu clúster de AlloyDB Express.

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

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

Si tu instancia principal es una instancia de 1 vCPU en una región que no admite la serie de máquinas C4A, la solicitud falla con el siguiente error:

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.

Para resolver este error, actualiza tu instancia principal a 2 vCPUs ("machineConfig": {"cpuCount": 2}) y, luego, vuelve a enviar la solicitud de actualización.

¿Qué sigue?