Crea e gestisci i cluster AlloyDB Express

Questo documento descrive come creare, connettere, modificare, visualizzare, eliminare ed eseguire l'upgrade di cluster e istanze AlloyDB Express.

Per saperne di più sulle differenze tra le funzionalità di AlloyDB Express e quelle di AlloyDB, consulta la panoramica di AlloyDB Express. Per creare un cluster AlloyDB, consulta Crea un cluster e la relativa istanza principale.

Prima di iniziare

Prima di creare o gestire i cluster AlloyDB Express, completa i seguenti prerequisiti:

  • Abilita l'API AlloyDB e altre API richieste nel tuo progetto Google Cloud in modo che il tuo progetto sia abilitato ad accedere ad AlloyDB.
  • Se utilizzi il server MCP remoto di AlloyDB, configura il client MCP per connetterti all'endpoint del server MCP globale (https://alloydb.googleapis.com/mcp) o a un endpoint regionale (https://alloydb.REGION_ID.rep.googleapis.com/mcp). Gli endpoint regionali sono attualmente in anteprima.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per creare e gestire cluster e istanze AlloyDB Express, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto:

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Crea un cluster e un'istanza AlloyDB Express

Puoi creare un cluster AlloyDB Express e la relativa istanza principale utilizzando la console Google Cloud , Google Cloud CLI, l'API REST AlloyDB o il server MCP remoto AlloyDB.

Un cluster AlloyDB Express supporta PostgreSQL 18 e contiene un'istanza principale a livello di zona che inizia con 1 vCPU (4 GB di RAM) e scala automaticamente lo spazio di archiviazione fino a 20 GB. Se prevedi di eseguire l'upgrade in loco di un'istanza con 1 vCPU ad AlloyDB in un secondo momento senza ridimensionarla a 2 vCPU, crea il cluster in una regione che supporti anche la serie di macchine C4A.

Le impostazioni di connettività predefinite dipendono dallo strumento utilizzato:

  • ConsoleGoogle Cloud : abilita per impostazione predefinita sia il DNS pubblico nell'istanza principale sia Private Service Connect nel cluster. Puoi configurare i progetti consumer di Private Service ConnectGoogle Cloud in un secondo momento modificando le impostazioni di connettività dell'istanza.

  • gcloud CLI, API REST e server MCP remoto AlloyDB: abilita solo Private Service Connect sul cluster per impostazione predefinita. Quando crei l'istanza principale, attiva il DNS pubblico se vuoi connetterti tramite DNS pubblico e inserisci nella lista consentita i progetti consumerGoogle Cloud in cui vuoi creare endpoint Private Service Connect per l'istanza.

Console

  1. Nella console Google Cloud , vai alla pagina Inizia.

    Vai a Inizia

    Se il tuo progetto Google Cloud ha già dei cluster e inizi dalla pagina Cluster, fai clic su Crea cluster nella barra degli strumenti per aprire la pagina Seleziona configurazione. Entrambe le pagine mostrano schede di configurazione del cluster preimpostate (AlloyDB Express, Produzione (zona singola) e Produzione (multi-zona)).

  2. Nella scheda AlloyDB Express, fai clic su Crea cluster per aprire il riquadro Crea un cluster AlloyDB Express.

  3. Nel riquadro Crea un cluster AlloyDB Express, configura il cluster:

  4. Fai clic su Crea cluster.

    La console Google Cloud crea il cluster AlloyDB Express e la relativa istanza principale con 1 vCPU con Private Service Connect e DNS pubblico abilitati per impostazione predefinita, quindi apre AlloyDB Studio per consentirti di eseguire query sul database.

    Non puoi modificare le impostazioni di connettività durante la creazione del cluster nella consoleGoogle Cloud , ma puoi aggiornare le reti esterne autorizzate o le impostazioni di Private Service Connect in un secondo momento modificando le impostazioni di connettività dell'istanza.

gcloud

Per utilizzare gcloud CLI, puoi installare e inizializzare Google Cloud CLI oppure puoi utilizzare Cloud Shell.

  1. Per creare un cluster AlloyDB Express, esegui il comando gcloud beta alloydb clusters create con il flag --enable-express:

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

    Sostituisci quanto segue:

    • CLUSTER_ID: l'ID del cluster che vuoi creare. L'ID deve iniziare con una lettera minuscola e può contenere lettere minuscole, numeri e trattini.
    • REGION_ID: la regione supportata in cui vuoi creare il cluster. Se prevedi di eseguire l'upgrade di un'istanza con 1 vCPU ad AlloyDB in un secondo momento senza ridimensionarla a 2 vCPU, scegli una regione che supporti anche la serie di macchine C4A.
    • PASSWORD: la password iniziale per l'utente predefinito del database postgres.
    • PROJECT_ID: l'ID del progettoGoogle Cloud in cui vuoi creare il cluster.

  2. Per creare l'istanza principale nel cluster AlloyDB Express, esegui il comando gcloud beta alloydb instances create e scegli i flag di connettività:

    • Solo DNS pubblico: specifica --enable-public-dns e ometti --allowed-psc-projects.
    • Solo Private Service Connect: ometti --enable-public-dns e specifica --allowed-psc-projects=ALLOWED_PROJECT_ID per consentire le connessioni Private Service Connect dal tuo progetto consumer Google Cloud .
    • Sia DNS pubblico che Private Service Connect: specifica sia --enable-public-dns che --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

    Sostituisci quanto segue:

    • INSTANCE_ID: l'ID dell'istanza principale che vuoi creare.
    • ALLOWED_PROJECT_ID (facoltativo): un elenco separato da virgole di ID progetto o numeri di progetto Google Cloud autorizzati a creare endpoint Private Service Connect per questa istanza. Ometti --allowed-psc-projects se configuri solo il DNS pubblico.

REST

  1. Per creare un cluster AlloyDB Express, invia una richiesta POST all'endpoint projects.locations.clusters.create con expressConfig.enabled impostato su true.

    Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

    • PROJECT_ID: l'ID del tuo progettoGoogle Cloud .
    • REGION_ID: la regione supportata in cui vuoi creare il cluster. Se prevedi di eseguire l'upgrade di un'istanza con 1 vCPU ad AlloyDB in un secondo momento senza ridimensionarla a 2 vCPU, scegli una regione che supporti anche la serie di macchine C4A.
    • CLUSTER_ID: l'ID del cluster che vuoi creare.
    • INITIAL_USERNAME: il nome utente dell'utente iniziale del database (ad esempio postgres).
    • INITIAL_USER_PASSWORD: la password per l'utente iniziale del database.

    Metodo HTTP e URL:

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

    Corpo JSON della richiesta:

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

  2. Al termine dell'operazione di creazione del cluster, crea l'istanza principale inviando una richiesta POST all'endpoint projects.locations.clusters.instances.create con machineConfig.cpuCount impostato su 1 (la specifica di un valore diverso da 1 non va a buon fine al momento della creazione). Scegli i campi di connettività nel corpo della richiesta:

    • Solo DNS pubblico: imposta "networkConfig": {"publicDnsEnabled": true} e ometti "pscInstanceConfig".
    • Solo Private Service Connect: ometti "publicDnsEnabled" (il cui valore predefinito è false) e imposta "pscInstanceConfig": {"allowedConsumerProjects": ["ALLOWED_PROJECT_ID"]}.
    • Sia DNS pubblico che Private Service Connect: includi sia "networkConfig": {"publicDnsEnabled": true} che "pscInstanceConfig": {"allowedConsumerProjects": ["ALLOWED_PROJECT_ID"]}.

    Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

    • INSTANCE_ID: l'ID dell'istanza principale che vuoi creare.
    • ALLOWED_PROJECT_ID (facoltativo): gli ID progetto o i numeri di progettoGoogle Cloud autorizzati a creare endpoint Private Service Connect per questa istanza.

    Metodo HTTP e URL:

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

    Corpo JSON della richiesta:

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

MCP

Puoi utilizzare un client MCP o chiamare direttamente il server MCP remoto AlloyDB per creare un cluster AlloyDB Express e la relativa istanza principale.

In un client MCP, puoi utilizzare un singolo prompt per creare sia il cluster AlloyDB Express sia la relativa istanza principale. Il tuo client MCP chiama automaticamente create_cluster, esegue il polling di get_operation e chiama create_instance:

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

Per eseguire ogni passaggio singolarmente o chiamare direttamente gli strumenti MCP, segui questi passaggi:

  1. Per creare un cluster AlloyDB Express, inserisci un prompt nel tuo client MCP o chiama lo strumento MCP create_cluster con express_config.enabled impostato su true.

    Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

    Nel client MCP, puoi inserire un prompt simile al seguente:

    Create an AlloyDB Express cluster named CLUSTER_ID in REGION_ID.

    Parametri della chiamata allo strumento:

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

    Per rendere Private Service Connect raggiungibile da una rete VPC, inserisci nella lista consentita i progetti consumerGoogle Cloud in "psc_instance_config" quando crei o aggiorni l'istanza principale.

  2. Lo strumento create_cluster restituisce un'operazione a lunga esecuzione. Esegui il polling dello stato dell'operazione utilizzando lo strumento MCP get_operation finché done non è true e il cluster non è nello stato READY.

  3. Per creare l'istanza principale nel cluster AlloyDB Express, inserisci un prompt nel client MCP o chiama lo strumento MCP create_instance. Scegli le impostazioni di connettività:

    • Solo DNS pubblico: imposta "public_dns_enabled": true e ometti "psc_instance_config".

    • Solo Private Service Connect: ometti "public_dns_enabled" (il cui valore predefinito è false) e imposta "psc_instance_config" con "allowed_consumer_projects" (o "psc_auto_connections" specificando "consumer_project" e "consumer_network").

    • Sia DNS pubblico che Private Service Connect: imposta sia "public_dns_enabled": true che "psc_instance_config".

    Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

    • INSTANCE_ID: l'ID dell'istanza principale che vuoi creare.

    • ALLOWED_PROJECT_ID: (facoltativo) gli ID progetto o i numeri di progetto autorizzati a creare endpoint Private Service Connect per questa istanza.Google Cloud

    Nel client MCP, puoi inserire un prompt simile al seguente:

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

    Parametri della chiamata allo strumento:

    {
  "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. Esegui il polling dell'operazione di creazione dell'istanza utilizzando lo strumento MCP get_operation finché done non è true e l'istanza non è nello stato READY.

Connettiti a un'istanza AlloyDB Express

AlloyDB Express supporta le seguenti opzioni di connettività al database in entrata:

  • DNS pubblico (predefinito): fornisce un nome DNS instradabile pubblicamente (networkInfo.publicDnsName) in modo da poterti connettere da client esterni a una rete VPC.
  • Private Service Connect: consente di connetterti privatamente alla tua istanza dall'interno della tua rete VPC tramite gli endpoint di Private Service Connect senza esporre il database alla rete internet pubblica.

Connettiti tramite DNS pubblico

Quando ti connetti tramite DNS pubblico dall'esterno di una rete VPC, puoi eseguire una delle seguenti operazioni:

Connettiti direttamente utilizzando un client PostgreSQL

Per impostazione predefinita, l'endpoint DNS pubblico rifiuta tutti gli indirizzi IP client diretti. Devi inserire nella lista consentita i blocchi CIDR client prima di connetterti direttamente a psql.

  1. Configura le reti esterne autorizzate nell'istanza principale.

    Non puoi aggiungere o rimuovere singolarmente le reti esterne autorizzate. Ogni aggiornamento sovrascrive l'elenco esistente. Fornisci un elenco separato da virgole di tutti i blocchi CIDR che vuoi consentire.

    Console

    1. Nella console Google Cloud , vai alla pagina Cluster.

      Vai a Cluster

    2. Nella colonna Nome risorsa, fai clic sul nome del tuo cluster AlloyDB Express.

    3. Nella pagina Panoramica, vai a Istanze nel cluster, individua l'istanza principale e fai clic su Azioni istanza > Modifica (o vai a Connettività nel menu di navigazione e fai clic su Modifica).

    4. In Connettività, assicurati che la connettività pubblica sia abilitata.

    5. In Reti esterne autorizzate, inserisci un elenco separato da virgole di intervalli CIDR IPv4 (ad esempio 203.0.113.0/24) o fai clic su Utilizza il mio IP per aggiungere l'indirizzo IPv4 /32 della tua macchina attuale.

    6. Fai clic su Aggiorna istanza.

    gcloud

    Per utilizzare gcloud CLI, puoi installare e inizializzare Google Cloud CLI oppure puoi utilizzare Cloud Shell.

    Esegui il comando gcloud alloydb instances update con il flag --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

    Sostituisci quanto segue:

    • INSTANCE_ID: l'ID dell'istanza principale di AlloyDB Express.
    • CLUSTER_ID: l'ID del tuo cluster AlloyDB Express.
    • REGION_ID: la regione in cui si trova il cluster.
    • CIDR_RANGE1, CIDR_RANGE2: un elenco separato da virgole di intervalli di indirizzi IPv4 in notazione CIDR (ad esempio, 203.0.113.0/24).
    • PROJECT_ID: l'ID del tuo progettoGoogle Cloud .

    REST

    Invia una richiesta PATCH all'endpoint projects.locations.clusters.instances.patch con updateMask=networkConfig.authorizedExternalNetworks.

    Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

    • PROJECT_ID: l'ID del tuo progettoGoogle Cloud .
    • REGION_ID: la regione in cui si trova il cluster.
    • CLUSTER_ID: l'ID del tuo cluster AlloyDB Express.
    • INSTANCE_ID: l'ID dell'istanza principale di AlloyDB Express.
    • CIDR_RANGE1, CIDR_RANGE2: intervalli di indirizzi IPv4 in notazione CIDR (ad esempio, 203.0.113.0/24).

    Metodo HTTP e URL:

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

    Corpo JSON della richiesta:

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

    MCP

    Inserisci un prompt nel tuo client MCP o chiama lo strumento MCP update_instance con il campo authorized_external_networks.

    Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

    • PROJECT_ID: l'ID del tuo progettoGoogle Cloud .

    • REGION_ID: la regione in cui si trova il cluster.

    • CLUSTER_ID: l'ID del tuo cluster AlloyDB Express.

    • INSTANCE_ID: l'ID dell'istanza principale di AlloyDB Express.

    • CIDR_RANGE1, CIDR_RANGE2: intervalli di indirizzi IPv4 in notazione CIDR, ad esempio 203.0.113.0/24.

    Nel client MCP, puoi inserire un prompt simile al seguente:

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

    Parametri della chiamata allo strumento:

    {
  "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 il nome DNS pubblico dell'istanza:

    Console

    1. Nella console Google Cloud , vai alla pagina Cluster e fai clic sul nome del cluster AlloyDB Express.
    2. Vai a Connettività (o visualizza la scheda dell'istanza principale nella pagina Panoramica) e copia il nome DNS pubblico dell'istanza.

    gcloud

    Esegui il comando gcloud beta alloydb instances describe per recuperare il valore networkInfo.publicDnsName:

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

    L'output utilizza il seguente formato:

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

    In questo output, IDENTIFIER è un identificatore alfanumerico generato dal sistema.

    REST

    Invia una richiesta GET all'endpoint projects.locations.clusters.instances.get e leggi il campo networkInfo.publicDnsName dalla risposta:

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

    MCP

    Inserisci un prompt nel client MCP o chiama lo strumento MCP get_instance e leggi il campo networkInfo.publicDnsName dalla risposta.

    Nel client MCP, puoi inserire un prompt simile al seguente:

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

    Parametri della chiamata allo strumento:

    {
  "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. Connettiti al database utilizzando un URI di connessione PostgreSQL standard e il nome DNS pubblico dell'istanza:

    psql postgresql://USERNAME@PUBLIC_DNS_NAME/DATABASE_NAME

    Sostituisci quanto segue:

    • USERNAME: il nome utente del database PostgreSQL (ad esempio postgres).
    • PUBLIC_DNS_NAME: il nome DNS pubblico dell'istanza AlloyDB Express (ad esempio 1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d.a.us-central1.alloydb.s.cloud.goog).
    • DATABASE_NAME: il nome del database a cui connettersi (il database predefinito è postgres).

  4. Quando richiesto, inserisci la password dell'utente del database.

Connettiti utilizzando gcloud CLI o il proxy di autenticazione

Per connetterti tramite DNS pubblico senza configurare reti esterne autorizzate, puoi utilizzare il comando gcloud beta alloydb connect o il client Auth Proxy autonomo (alloydb-auth-proxy) con il flag --public-ip. Sebbene AlloyDB Express mostri un nome DNS pubblico anziché un indirizzo IP pubblico, il control plane esegue il provisioning di una connessione pubblica sottostante per l'istanza che il proxy di autenticazione risolve automaticamente quando specifichi --public-ip.

Per avviare un'istanza Auth Proxy locale e aprire una sessione psql utilizzando gcloud CLI, esegui il comando gcloud beta alloydb connect con il flag --public-ip:

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

Sostituisci quanto segue:

  • INSTANCE_ID: l'ID dell'istanza principale di AlloyDB Express.
  • CLUSTER_ID: l'ID del tuo cluster AlloyDB Express.
  • REGION_ID: la regione in cui si trova il cluster.
  • USERNAME: il nome utente del database (il valore predefinito è postgres).
  • DATABASE_NAME: il nome del database (il valore predefinito è postgres).
  • PROJECT_ID: l'ID del tuo progetto Google Cloud .

Per saperne di più sulla connessione con gcloud CLI, inclusa l'autenticazione del database IAM (--auto-iam-authn), consulta Connettiti utilizzando gcloud CLI.

In alternativa, puoi scaricare ed eseguire il client Auth Proxy autonomo con il flag --public-ip:

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

Per informazioni su come scaricare, configurare e connetterti tramite il client proxy di autenticazione autonomo, consulta Connettiti utilizzando il proxy di autenticazione AlloyDB.

Connettiti tramite Private Service Connect

Per la connettività privata dall'interno della tua rete VPC senza esporre il database alla rete internet pubblica, puoi configurare Private Service Connect sulla tua istanza AlloyDB Express. Puoi connetterti a un endpoint Private Service Connect direttamente da un client all'interno della tua rete VPC o utilizzando Auth Proxy. Per saperne di più sulla connessione a Private Service Connect, consulta Connettiti a un'istanza utilizzando Private Service Connect.

Quando segui queste istruzioni per AlloyDB Express, crea il cluster e l'istanza principale di zona con 1 vCPU come descritto in Crea un cluster e un'istanza AlloyDB Express con Private Service Connect abilitato. AlloyDB Express supporta la connettività Private Service Connect in entrata a una singola istanza principale di zona.

Modifica un'istanza AlloyDB Express

Puoi aggiornare il numero di CPU (1 vCPU o 2 vCPU) o i flag di database di un'istanza principale AlloyDB Express.

Console

  1. Nella console Google Cloud , vai alla pagina Cluster.

    Vai a Cluster

  2. Nella colonna Nome risorsa, fai clic sul nome del tuo cluster AlloyDB Express.

  3. Nella pagina Panoramica, nella sezione Istanze nel cluster, individua l'istanza principale e fai clic su Modifica istanza principale (oppure fai clic su Azioni istanza > Modifica).

  4. Nella pagina Modifica istanza principale, aggiorna le impostazioni dell'istanza:

    • In Macchina, nell'elenco Tipo di macchina, seleziona 1 vCPU, 4 GB o 2 vCPU, 8 GB.
    • (Facoltativo) Per configurare i flag di database, espandi Flag (o fai clic su Mostra opzioni avanzate ed espandi Flag) e fai clic su Aggiungi flag. Seleziona un flag dall'elenco Nuovo flag di database, fornisci un valore e fai clic su Fine.

  5. Fai clic su Aggiorna istanza.

gcloud

Per utilizzare gcloud CLI, puoi installare e inizializzare Google Cloud CLI oppure puoi utilizzare Cloud Shell.

Per scalare l'istanza modificando il numero di CPU (1 o 2) o per aggiornare i flag di database, esegui il 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

Sostituisci quanto segue:

  • INSTANCE_ID: l'ID dell'istanza principale di AlloyDB Express.
  • CLUSTER_ID: l'ID del tuo cluster AlloyDB Express.
  • REGION_ID: la regione in cui si trova il cluster.
  • CPU_COUNT: il numero di vCPU per l'istanza (1 per 1 vCPU, 4 GB di RAM o 2 per 2 vCPU, 8 GB di RAM).
  • FLAGS (facoltativo): un elenco separato da virgole di flag di database e valori nel formato FLAG_NAME=VALUE. Se stai aggiornando solo il numero di CPU, ometti il flag --database-flags. Per saperne di più sui flag supportati, consulta Flag di database supportati.
  • PROJECT_ID: l'ID del tuo progettoGoogle Cloud .
  • --enable-public-dns o --no-enable-public-dns: attiva o disattiva il DNS pubblico per l'istanza. Questo flag è disponibile solo in gcloud beta (gcloud beta alloydb instances update).
  • --allowed-psc-projects=[ALLOWED_PSC_PROJECTS,...]: aggiorna l'elenco separato da virgole degli ID progetto o dei numeri di progetto consumer Google Cloud autorizzati a creare endpoint Private Service Connect per l'istanza.

REST

Per aggiornare il numero di CPU o i flag di database di un'istanza principale AlloyDB Express, invia una richiesta PATCH all'endpoint projects.locations.clusters.instances.patch e specifica i campi che stai aggiornando nel parametro di query updateMask.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • PROJECT_ID: l'ID del tuo progettoGoogle Cloud .
  • REGION_ID: la regione in cui si trova il cluster.
  • CLUSTER_ID: l'ID del tuo cluster AlloyDB Express.
  • INSTANCE_ID: l'ID dell'istanza principale di AlloyDB Express.
  • CPU_COUNT: il numero di vCPU per l'istanza (1 o 2).
  • FLAG_NAME e FLAG_VALUE (facoltativo): il nome e il valore del flag di database da impostare. Se stai aggiornando solo il numero di CPU, imposta updateMask=machineConfig.cpuCount e ometti databaseFlags dal corpo della richiesta.

Metodo HTTP e URL:

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

Corpo JSON della richiesta:

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

MCP

Per aggiornare il numero di CPU o i flag di database di un'istanza principale AlloyDB Express, inserisci un prompt nel client MCP o chiama lo strumento MCP update_instance.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • PROJECT_ID: l'ID del tuo progettoGoogle Cloud .

  • REGION_ID: la regione in cui si trova il cluster.

  • CLUSTER_ID: l'ID del tuo cluster AlloyDB Express.

  • INSTANCE_ID: l'ID dell'istanza principale di AlloyDB Express.

  • CPU_COUNT: il numero di vCPU per l'istanza (1 o 2).

  • FLAG_NAME e FLAG_VALUE: (facoltativo) il nome e il valore del flag di database da impostare. Se stai aggiornando solo il numero di CPU, ometti database_flags da arguments.

Nel client MCP, puoi inserire un prompt simile al seguente:

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

Parametri della chiamata allo strumento:

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

Visualizza i dettagli del cluster e dell'istanza AlloyDB Express

Puoi visualizzare un elenco dei tuoi cluster AlloyDB Express, visualizzare i dettagli di un cluster o un'istanza AlloyDB Express specifici e controllare l'utilizzo di computing e spazio di archiviazione del cluster.

Per saperne di più, consulta Visualizza l'elenco dei cluster, Visualizza i dettagli del cluster e Visualizza i dettagli dell'istanza.

Console

  1. Nella console Google Cloud , vai alla pagina Cluster.

    Vai a Cluster

    Nella colonna Nome risorsa, i cluster AlloyDB Express visualizzano un tag Express accanto al nome del cluster.

  2. Per visualizzare informazioni dettagliate su un cluster e sulla sua istanza principale, fai clic sul nome del cluster nella colonna Nome risorsa.

  3. Nella pagina Panoramica, visualizza i dettagli del cluster in Dettagli cluster (incluso il tag Express accanto a ID cluster e Spazio di archiviazione totale utilizzato rispetto al limite di 20 GB) e i dettagli dell'istanza principale in Istanze nel cluster.

gcloud

Per utilizzare gcloud CLI, puoi installare e inizializzare Google Cloud CLI oppure puoi utilizzare Cloud Shell.

  • Per visualizzare un elenco dei cluster nel tuo progetto, esegui il comando gcloud alloydb clusters list:

    gcloud alloydb clusters list --project=PROJECT_ID

  • Per visualizzare i dettagli di un cluster specifico, esegui il comando gcloud alloydb clusters describe:

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

  • Per visualizzare i dettagli di un'istanza specifica, esegui il comando gcloud alloydb instances describe:

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del tuo progettoGoogle Cloud .
  • CLUSTER_ID: l'ID del tuo cluster AlloyDB Express.
  • REGION_ID: la regione in cui si trova il cluster.
  • INSTANCE_ID: l'ID dell'istanza principale di AlloyDB Express.

REST

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • PROJECT_ID: l'ID del tuo progettoGoogle Cloud .
  • REGION_ID: la regione in cui si trova il cluster.
  • CLUSTER_ID: l'ID del tuo cluster AlloyDB Express.

  • INSTANCE_ID: l'ID dell'istanza principale di AlloyDB Express.

  • Per visualizzare un elenco di cluster in una regione, invia una richiesta GET all'endpoint projects.locations.clusters.list:

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

  • Per visualizzare i dettagli di un cluster, invia una richiesta GET all'endpoint projects.locations.clusters.get:

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

  • Per visualizzare i dettagli di un'istanza, invia una richiesta GET all'endpoint projects.locations.clusters.instances.get:

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

MCP

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • PROJECT_ID: l'ID del tuo progettoGoogle Cloud .

  • REGION_ID: la regione in cui si trova il cluster.

  • CLUSTER_ID: l'ID del tuo cluster AlloyDB Express.

  • INSTANCE_ID: l'ID dell'istanza principale di AlloyDB Express.

  • Per visualizzare un elenco di cluster in una regione, inserisci un prompt nel client MCP o chiama lo strumento MCP list_clusters.

    Nel client MCP, puoi inserire un prompt simile al seguente:

    Please list the AlloyDB clusters in REGION_ID in project PROJECT_ID.

    Parametri della chiamata allo strumento:

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

  • Per visualizzare i dettagli di un cluster, inserisci un prompt nel client MCP o chiama lo strumento MCP get_cluster.

    Nel client MCP, puoi inserire un prompt simile al seguente:

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

    Parametri della chiamata allo strumento:

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

  • Per visualizzare i dettagli di un'istanza, inserisci un prompt nel client MCP o chiama lo strumento MCP get_instance.

    Nel client MCP, puoi inserire un prompt simile al seguente:

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

    Parametri della chiamata allo strumento:

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

Visualizza l'utilizzo di computing e spazio di archiviazione

Per controllare lo spazio di archiviazione e il computing utilizzati dal cluster e dall'istanza principale di AlloyDB Express, utilizza la console Google Cloud o Cloud Monitoring:

  • Nella console Google Cloud , apri la pagina Panoramica del cluster:

    • Spazio di archiviazione utilizzato: in Dettagli cluster, visualizza Spazio di archiviazione totale utilizzato per vedere quanto spazio di archiviazione sta utilizzando il tuo cluster rispetto al limite di 20 GB.
    • Computing e connessioni: visualizza i grafici Utilizzo CPU e Connessioni attive nella pagina Panoramica oppure fai clic su Insight di sistema nel menu di navigazione per visualizzare metriche dettagliate su CPU, memoria e spazio di archiviazione.

  • In Esplora metriche di Cloud Monitoring, esegui una query sulle seguenti metriche per i tipi di risorsa monitorata alloydb.googleapis.com/Cluster e alloydb.googleapis.com/Instance:

    • Spazio di archiviazione utilizzato: alloydb.googleapis.com/cluster/storage/usage
    • Utilizzo della CPU: alloydb.googleapis.com/instance/cpu/average_utilization e alloydb.googleapis.com/instance/cpu/maximum_utilization
    • Connessioni attive: alloydb.googleapis.com/database/postgresql/backends

Elimina un cluster o un'istanza AlloyDB Express

Puoi eliminare un'istanza o un cluster principale AlloyDB Express quando non ne hai più bisogno.

Per saperne di più, consulta Elimina un'istanza ed Elimina un cluster.

Console

  1. Nella console Google Cloud , vai alla pagina Cluster.

    Vai a Cluster

  2. Nella colonna Nome risorsa, fai clic sul nome del tuo cluster AlloyDB Express.

  3. Nella pagina Panoramica, elimina l'istanza principale o il cluster:

    • Per eliminare l'istanza principale, vai alla sezione Istanze nel cluster, fai clic su Azioni istanza > Elimina, inserisci l'ID istanza nella finestra di dialogo e fai clic su Elimina.
    • Per eliminare il cluster, elimina prima l'istanza principale nel cluster, quindi fai clic su Elimina cluster, inserisci l'ID cluster nella finestra di dialogo Elimina cluster e fai clic su Elimina.

gcloud

Per utilizzare gcloud CLI, puoi installare e inizializzare Google Cloud CLI oppure puoi utilizzare Cloud Shell.

  • Per eliminare un'istanza, esegui il comando gcloud alloydb instances delete:

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

  • Per eliminare un cluster, esegui il comando gcloud alloydb clusters delete. Se il cluster contiene ancora l'istanza principale, includi il flag --force per eliminare l'istanza principale e il cluster insieme:

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

Sostituisci quanto segue:

  • INSTANCE_ID: l'ID dell'istanza principale di AlloyDB Express.
  • CLUSTER_ID: l'ID del tuo cluster AlloyDB Express.
  • REGION_ID: la regione in cui si trova il cluster.
  • PROJECT_ID: l'ID del tuo progettoGoogle Cloud .

REST

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • PROJECT_ID: l'ID del tuo progettoGoogle Cloud .
  • REGION_ID: la regione in cui si trova il cluster.
  • CLUSTER_ID: l'ID del tuo cluster AlloyDB Express.

  • INSTANCE_ID: l'ID dell'istanza principale di AlloyDB Express.

  • Per eliminare un'istanza, invia una richiesta DELETE all'endpoint projects.locations.clusters.instances.delete:

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

  • Per eliminare un cluster (inclusa la sua istanza principale quando specifichi force=true), invia una richiesta DELETE all'endpoint projects.locations.clusters.delete:

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

Esegui l'upgrade di un cluster AlloyDB Express ad AlloyDB

Puoi eseguire un upgrade in loco del cluster AlloyDB Express a un cluster AlloyDB.

L'upgrade conserva i dati, gli schemi, le estensioni, le credenziali utente, la configurazione di rete (inclusi il nome DNS pubblico e gli endpoint Private Service Connect) e il numero di vCPU dell'istanza principale del database.

Il seguente elenco descrive le risorse e le impostazioni che cambiano durante il processo di upgrade:

  • Numero di vCPU, rapporto di memoria e capacità di calcolo: l'istanza mantiene il numero di vCPU attuale (1 vCPU o 2 vCPU) ed esegue l'upgrade dal rapporto vCPU-memoria di AlloyDB Express 1:4 (4 GB o 8 GB di RAM) al rapporto vCPU-memoria di AlloyDB 1:8 (8 GB di RAM per 1 vCPU o 16 GB di RAM per 2 vCPU). Dopo l'upgrade, puoi scalare il computing fino a 288 vCPU.
    • Quando esegui l'upgrade di un'istanza con 1 vCPU, puoi scegliere solo le regioni che supportano la serie di macchine C4A. Per le regioni supportate, consulta Disponibilità a livello di regione per C4A.
    • Se l'istanza AlloyDB Express non si trova in una regione che supporta i tipi di macchina C4A, devi prima aggiornare l'istanza principale a una configurazione con 2 vCPU prima di eseguire l'upgrade. Nella console Google Cloud , se fai clic su Esegui l'upgrade per un'istanza con 1 vCPU in una regione non supportata, un messaggio ti chiede di ridimensionare prima l'istanza a 2 vCPU.
  • Computing e fatturazione con provisioning: l'upgrade disattiva la scalabilità fino a zero del computing e l'istanza viene eseguita come istanza AlloyDB sempre attiva fatturata in base alle tariffe di AlloyDB.
  • Capacità di archiviazione: l'upgrade rimuove il limite di spazio di archiviazione di 20 GB. Lo spazio di archiviazione viene scalato fino a una quota predefinita di 16 TiB per cluster e puoi richiedere un aumento della quota di spazio di archiviazione per fare lo scale up fino a 128 TiB.
  • Funzionalità Enterprise: l'upgrade sblocca l'alta affidabilità (HA) a livello di regione, coperta dall'accordo sul livello del servizio (SLA) con uptime del 99,99%. Inoltre, sblocca le istanze del pool di lettura, la replica tra regioni, il backup e il ripristino continui e i backup automatici e on demand.

Per eseguire l'upgrade del cluster AlloyDB Express a un cluster AlloyDB, segui questi passaggi:

Console

  1. Nella console Google Cloud , vai alla pagina Cluster.

    Vai a Cluster

  2. Nella colonna Nome risorsa, fai clic sul nome del tuo cluster AlloyDB Express.

  3. Nella pagina Panoramica, in Dettagli cluster, individua ID cluster, quindi fai clic su Esegui l'upgrade.

    Se l'istanza principale è un'istanza con 1 vCPU in una regione che non supporta la serie di macchine C4A, viene visualizzato un messaggio:

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

    Per ridimensionare l'istanza a 2 vCPU, fai clic su Modifica istanza. Dopo aver ridimensionato l'istanza, fai di nuovo clic su Esegui l'upgrade.

  4. Nel riquadro Esegui l'upgrade da AlloyDB Express, inserisci l'ID cluster per confermare l'upgrade, quindi fai clic su Conferma.

gcloud

Per utilizzare gcloud CLI, puoi installare e inizializzare Google Cloud CLI oppure puoi utilizzare Cloud Shell.

Per eseguire l'upgrade del cluster AlloyDB Express a un cluster AlloyDB, esegui il comando gcloud beta alloydb clusters update con il flag --no-enable-express:

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

Sostituisci quanto segue:

  • CLUSTER_ID: l'ID del tuo cluster AlloyDB Express.
  • REGION_ID: la regione in cui si trova il cluster.
  • PROJECT_ID: l'ID del tuo progettoGoogle Cloud .

Se l'istanza principale è un'istanza con 1 vCPU in una regione che non supporta la serie di macchine C4A, il comando non va a buon fine e viene visualizzato il seguente errore:

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.

Per risolvere questo errore, aggiorna l'istanza principale a 2 vCPU (--cpu-count=2), quindi esegui di nuovo il comando di upgrade.

REST

Per eseguire l'upgrade del cluster AlloyDB Express a un cluster AlloyDB, invia una richiesta PATCH all'endpoint projects.locations.clusters.patch con updateMask=expressConfig.enabled e imposta expressConfig.enabled su false.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • PROJECT_ID: l'ID del tuo progettoGoogle Cloud .
  • REGION_ID: la regione in cui si trova il cluster.
  • CLUSTER_ID: l'ID del tuo cluster AlloyDB Express.

Metodo HTTP e URL:

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

Corpo JSON della richiesta:

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

Se l'istanza principale è un'istanza con 1 vCPU in una regione che non supporta la serie di macchine C4A, la richiesta non va a buon fine e viene visualizzato il seguente errore:

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.

Per risolvere questo errore, aggiorna l'istanza principale a 2 vCPU ("machineConfig": {"cpuCount": 2}), quindi invia nuovamente la richiesta di upgrade.

Passaggi successivi