Membuat dan mengelola cluster AlloyDB Express

Dokumen ini menjelaskan cara membuat, menghubungkan, mengedit, melihat, menghapus, dan mengupgrade cluster dan instance AlloyDB Express.

Untuk mengetahui informasi selengkapnya tentang perbedaan kemampuan AlloyDB Express dengan kemampuan AlloyDB, lihat Ringkasan AlloyDB Express. Untuk membuat cluster AlloyDB, lihat Membuat cluster dan instance utamanya.

Sebelum memulai

Sebelum Anda membuat atau mengelola cluster AlloyDB Express, selesaikan prasyarat berikut:

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk membuat dan mengelola cluster dan instance AlloyDB Express, minta administrator untuk memberi Anda peran IAM berikut pada project Anda:

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Membuat cluster dan instance AlloyDB Express

Anda dapat membuat cluster AlloyDB Express dan instance utamanya menggunakan konsol Google Cloud , Google Cloud CLI, AlloyDB REST API, atau server MCP jarak jauh AlloyDB.

Cluster AlloyDB Express mendukung PostgreSQL 18 dan berisi satu instance utama zona yang dimulai dengan 1 vCPU (RAM 4 GB) dan menskalakan penyimpanan secara otomatis hingga 20 GB. Jika Anda berencana mengupgrade instance 1 vCPU di tempat ke AlloyDB nanti tanpa mengubah ukuran menjadi 2 vCPU, buat cluster di region yang juga mendukung seri mesin C4A.

Setelan konektivitas default bergantung pada alat yang Anda gunakan:

  • Google Cloud console: mengaktifkan DNS publik pada instance utama dan Private Service Connect pada cluster secara default. Anda dapat mengonfigurasi projectGoogle Cloud konsumen Private Service Connect nanti dengan mengedit setelan konektivitas instance.

  • gcloud CLI, REST API, dan server MCP jarak jauh AlloyDB: hanya mengaktifkan Private Service Connect di cluster secara default. Saat Anda membuat instance utama, aktifkan DNS publik jika Anda ingin terhubung melalui DNS publik, dan izinkan projectGoogle Cloud konsumen tempat Anda ingin membuat endpoint Private Service Connect untuk instance tersebut.

Konsol

  1. Di konsol Google Cloud , buka halaman Get started.

    Buka Mulai

    Jika project Google Cloud Anda sudah memiliki cluster dan Anda memulai dari halaman Clusters, klik Create cluster di toolbar untuk membuka halaman Select configuration. Kedua halaman menampilkan kartu konfigurasi cluster preset (AlloyDB Express, Production (single zone), dan Production (multi-zone)).

  2. Di kartu AlloyDB Express, klik Create cluster untuk membuka panel Create an AlloyDB Express cluster.

  3. Di panel Create an AlloyDB Express cluster, konfigurasikan cluster Anda:

    • Untuk Cluster ID, masukkan ID untuk cluster Anda, atau pertahankan ID default.
    • Untuk Password, masukkan sandi untuk pengguna postgres default, atau klik Generate untuk membuat sandi. Anda dapat mengubah sandi nanti dari halaman Pengguna.
    • Untuk Region, pilih region yang didukung untuk cluster Anda. Jika Anda berencana mengupgrade instance 1 vCPU ke AlloyDB nanti tanpa mengubah ukuran menjadi 2 vCPU, pilih region yang mendukung seri mesin C4A.
  4. Klik Create cluster.

    Konsol Google Cloud membuat cluster AlloyDB Express dan instance utama 1 vCPU-nya dengan Private Service Connect dan DNS publik diaktifkan secara default, lalu membuka AlloyDB Studio agar Anda dapat membuat kueri database.

    Anda tidak dapat mengubah setelan konektivitas selama pembuatan cluster di konsolGoogle Cloud , tetapi Anda dapat memperbarui jaringan eksternal yang diizinkan atau setelan Private Service Connect nanti dengan mengedit setelan konektivitas instance.

gcloud

Untuk menggunakan gcloud CLI, Anda dapat menginstal dan melakukan inisialisasi Google Cloud CLI, atau Anda dapat menggunakan Cloud Shell.

  1. Untuk membuat cluster AlloyDB Express, jalankan perintah gcloud beta alloydb clusters create dengan flag --enable-express:

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

    Ganti kode berikut:

    • CLUSTER_ID: ID cluster yang ingin Anda buat. ID harus diawali dengan huruf kecil dan dapat berisi huruf kecil, angka, dan tanda hubung.
    • REGION_ID: region yang didukung tempat Anda ingin membuat cluster. Jika Anda berencana mengupgrade instance 1 vCPU ke AlloyDB nanti tanpa mengubah ukuran ke 2 vCPU, pilih region yang juga mendukung seri mesin C4A.
    • PASSWORD: sandi awal untuk pengguna database postgres default.
    • PROJECT_ID: IDGoogle Cloud project tempat Anda ingin membuat cluster.
  2. Untuk membuat instance utama di cluster AlloyDB Express, jalankan perintah gcloud beta alloydb instances create dan pilih flag konektivitas Anda:

    • Khusus DNS publik: tentukan --enable-public-dns dan hapus --allowed-psc-projects.
    • Khusus Private Service Connect: hapus --enable-public-dns dan tentukan --allowed-psc-projects=ALLOWED_PROJECT_ID untuk mengizinkan koneksi Private Service Connect dari project konsumen Google Cloud Anda.
    • DNS publik dan Private Service Connect: tentukan --enable-public-dns dan --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
    

    Ganti kode berikut:

    • INSTANCE_ID: ID instance utama yang ingin Anda buat.
    • ALLOWED_PROJECT_ID (Opsional): daftar project ID atau nomor project yang dipisahkan koma dan diizinkan untuk membuat endpoint Private Service Connect ke instance ini. Google Cloud Hapus --allowed-psc-projects jika Anda hanya mengonfigurasi DNS publik.

REST

  1. Untuk membuat cluster AlloyDB Express, kirim permintaan POST ke endpoint projects.locations.clusters.create dengan expressConfig.enabled ditetapkan ke true.

    Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

    • PROJECT_ID: ID project Google Cloud Anda.
    • REGION_ID: region yang didukung tempat Anda ingin membuat cluster. Jika Anda berencana mengupgrade instance 1 vCPU ke AlloyDB nanti tanpa mengubah ukuran ke 2 vCPU, pilih region yang juga mendukung seri mesin C4A.
    • CLUSTER_ID: ID cluster yang ingin Anda buat.
    • INITIAL_USERNAME: nama pengguna untuk pengguna database awal (misalnya, postgres).
    • INITIAL_USER_PASSWORD: sandi untuk pengguna database awal.

    Metode HTTP dan URL:

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

    Meminta isi JSON:

    {
      "databaseVersion": "POSTGRES_18",
      "expressConfig": {
        "enabled": true
      },
      "initialUser": {
        "user": "INITIAL_USERNAME",
        "password": "INITIAL_USER_PASSWORD"
      }
    }
    
  2. Setelah operasi pembuatan cluster selesai, buat instance utama dengan mengirimkan permintaan POST ke endpoint projects.locations.clusters.instances.create dengan machineConfig.cpuCount ditetapkan ke 1 (menentukan nilai selain 1 akan gagal saat pembuatan). Pilih kolom konektivitas Anda di isi permintaan:

    • Khusus DNS publik: tetapkan "networkConfig": {"publicDnsEnabled": true} dan hapus "pscInstanceConfig".
    • Khusus Private Service Connect: hapus "publicDnsEnabled" (yang ditetapkan secara default ke false) dan tetapkan "pscInstanceConfig": {"allowedConsumerProjects": ["ALLOWED_PROJECT_ID"]}.
    • DNS publik dan Private Service Connect: menyertakan "networkConfig": {"publicDnsEnabled": true} dan "pscInstanceConfig": {"allowedConsumerProjects": ["ALLOWED_PROJECT_ID"]}.

    Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

    • INSTANCE_ID: ID instance utama yang ingin Anda buat.
    • ALLOWED_PROJECT_ID (Opsional):Google Cloud project ID atau nomor project yang diizinkan untuk membuat endpoint Private Service Connect ke instance ini.

    Metode HTTP dan URL:

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

    Meminta isi JSON:

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

MCP

Anda dapat menggunakan klien MCP atau memanggil server MCP jarak jauh AlloyDB secara langsung untuk membuat cluster AlloyDB Express dan instance utamanya.

Di klien MCP, Anda dapat menggunakan satu perintah untuk membuat cluster AlloyDB Express dan instance utamanya. Klien MCP Anda otomatis memanggil create_cluster, melakukan polling get_operation, dan memanggil create_instance:

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

Untuk menjalankan setiap langkah satu per satu atau memanggil alat MCP secara langsung, ikuti langkah-langkah berikut:

  1. Untuk membuat cluster AlloyDB Express, masukkan perintah di klien MCP Anda atau panggil alat MCP create_cluster dengan express_config.enabled ditetapkan ke true.

    Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

    Di klien MCP, Anda dapat memasukkan perintah yang mirip dengan berikut ini:

    Create an AlloyDB Express cluster named CLUSTER_ID in REGION_ID.
    

    Parameter panggilan alat:

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

    Agar Private Service Connect dapat dijangkau dari jaringan VPC, izinkan project konsumenGoogle Cloud di "psc_instance_config" saat Anda membuat atau mengupdate instance utama.

  2. Alat create_cluster menampilkan operasi yang berjalan lama. Lakukan polling status operasi menggunakan alat MCP get_operation hingga done menjadi true dan cluster berada dalam status READY.

  3. Untuk membuat instance utama di cluster AlloyDB Express, masukkan perintah di klien MCP Anda atau panggil alat MCP create_instance. Pilih setelan konektivitas Anda:

    • Khusus DNS publik: tetapkan "public_dns_enabled": true dan hapus "psc_instance_config".

    • Khusus Private Service Connect: hapus "public_dns_enabled" (yang ditetapkan secara default ke false) dan tetapkan "psc_instance_config" dengan "allowed_consumer_projects" (atau "psc_auto_connections" yang menentukan "consumer_project" dan "consumer_network").

    • DNS publik dan Private Service Connect: tetapkan "public_dns_enabled": true dan "psc_instance_config".

    Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

    • INSTANCE_ID: ID instance utama yang ingin Anda buat.

    • ALLOWED_PROJECT_ID: opsional:Google Cloud project ID atau nomor project yang diizinkan untuk membuat endpoint Private Service Connect ke instance ini.

    Di klien MCP, Anda dapat memasukkan perintah yang mirip dengan berikut ini:

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

    Parameter panggilan alat:

    {
      "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. Lakukan polling pada operasi pembuatan instance menggunakan alat MCP get_operation hingga done menjadi true dan instance berada dalam status READY.

Menghubungkan ke instance AlloyDB Express

AlloyDB Express mendukung opsi konektivitas database masuk berikut:

  • DNS Publik (default): menyediakan nama DNS yang dapat dirutekan secara publik (networkInfo.publicDnsName) sehingga Anda dapat terhubung dari klien di luar jaringan VPC.
  • Private Service Connect: memungkinkan Anda terhubung secara pribadi ke instance dari dalam jaringan VPC melalui endpoint Private Service Connect tanpa mengekspos database Anda ke internet publik.

Terhubung melalui DNS publik

Saat terhubung melalui DNS publik dari luar jaringan VPC, Anda dapat melakukan salah satu hal berikut:

Menghubungkan langsung menggunakan klien PostgreSQL

Secara default, endpoint DNS publik menolak semua alamat IP klien langsung. Anda harus mengizinkan blok CIDR klien sebelum terhubung langsung dengan psql.

  1. Konfigurasikan jaringan eksternal yang diizinkan di instance utama Anda.

    Anda tidak dapat menambahkan atau menghapus jaringan eksternal yang diizinkan satu per satu. Setiap update akan menimpa daftar yang ada. Berikan daftar yang dipisahkan koma untuk semua blok CIDR yang ingin Anda izinkan.

    Konsol

    1. Di konsol Google Cloud , buka halaman Clusters.

      Buka Cluster

    2. Di kolom Resource name, klik nama cluster AlloyDB Express Anda.

    3. Di halaman Overview, buka Instances in your cluster, temukan instance utama Anda, lalu klik Instance actions > Edit (atau buka Connectivity di menu navigasi, lalu klik Edit).

    4. Di bagian Connectivity, pastikan konektivitas publik diaktifkan.

    5. Di bagian Authorized external networks, masukkan daftar rentang CIDR IPv4 yang dipisahkan koma (misalnya, 203.0.113.0/24), atau klik Use my IP untuk menambahkan alamat IPv4 /32 dari mesin Anda saat ini.

    6. Klik Update instance.

    gcloud

    Untuk menggunakan gcloud CLI, Anda dapat menginstal dan melakukan inisialisasi Google Cloud CLI, atau Anda dapat menggunakan Cloud Shell.

    Jalankan perintah gcloud alloydb instances update dengan 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
    

    Ganti kode berikut:

    • INSTANCE_ID: ID instance utama AlloyDB Express Anda.
    • CLUSTER_ID: ID cluster AlloyDB Express Anda.
    • REGION_ID: region tempat cluster Anda berada.
    • CIDR_RANGE1, CIDR_RANGE2: daftar rentang alamat IPv4 yang dipisahkan koma dalam notasi CIDR (misalnya, 203.0.113.0/24).
    • PROJECT_ID: ID project Google Cloud Anda.

    REST

    Kirim permintaan PATCH ke endpoint projects.locations.clusters.instances.patch dengan updateMask=networkConfig.authorizedExternalNetworks.

    Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

    • PROJECT_ID: ID project Google Cloud Anda.
    • REGION_ID: region tempat cluster Anda berada.
    • CLUSTER_ID: ID cluster AlloyDB Express Anda.
    • INSTANCE_ID: ID instance utama AlloyDB Express Anda.
    • CIDR_RANGE1, CIDR_RANGE2: Rentang alamat IPv4 dalam notasi CIDR (misalnya, 203.0.113.0/24).

    Metode HTTP dan URL:

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

    Meminta isi JSON:

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

    MCP

    Masukkan perintah di klien MCP Anda atau panggil alat MCP update_instance dengan kolom authorized_external_networks.

    Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

    • PROJECT_ID: ID project Google Cloud Anda.

    • REGION_ID: region tempat cluster Anda berada.

    • CLUSTER_ID: ID cluster AlloyDB Express Anda.

    • INSTANCE_ID: ID instance utama AlloyDB Express Anda.

    • CIDR_RANGE1, CIDR_RANGE2: Rentang alamat IPv4 dalam notasi CIDR, seperti 203.0.113.0/24.

    Di klien MCP, Anda dapat memasukkan perintah yang mirip dengan berikut ini:

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

    Parameter panggilan alat:

    {
      "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. Ambil nama DNS publik instance Anda:

    Konsol

    1. Di konsol Google Cloud , buka halaman Clusters dan klik nama cluster AlloyDB Express Anda.
    2. Buka Connectivity (atau lihat kartu instance utama di halaman Overview) dan salin nama DNS publik instance.

    gcloud

    Jalankan perintah gcloud beta alloydb instances describe untuk mengambil nilai networkInfo.publicDnsName:

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

    Outputnya menggunakan format berikut:

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

    Dalam output ini, IDENTIFIER adalah ID alfanumerik yang dihasilkan sistem.

    REST

    Kirim permintaan GET ke endpoint projects.locations.clusters.instances.get dan baca kolom networkInfo.publicDnsName dari respons:

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

    MCP

    Masukkan perintah di klien MCP Anda atau panggil alat MCP get_instance dan baca kolom networkInfo.publicDnsName dari respons.

    Di klien MCP, Anda dapat memasukkan perintah yang mirip dengan berikut ini:

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

    Parameter panggilan alat:

    {
      "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. Hubungkan ke database Anda menggunakan URI koneksi PostgreSQL standar dan nama DNS publik instance Anda:

    psql postgresql://USERNAME@PUBLIC_DNS_NAME/DATABASE_NAME

    Ganti kode berikut:

    • USERNAME: nama pengguna database PostgreSQL (misalnya, postgres).
    • PUBLIC_DNS_NAME: nama DNS publik instance AlloyDB Express Anda (misalnya, 1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d.a.us-central1.alloydb.s.cloud.goog).
    • DATABASE_NAME: nama database yang akan dihubungkan (database default adalah postgres).
  4. Saat diminta, masukkan sandi untuk pengguna database.

Menghubungkan menggunakan gcloud CLI atau Proxy Auth

Untuk terhubung melalui DNS publik tanpa mengonfigurasi jaringan eksternal yang diizinkan, Anda dapat menggunakan perintah gcloud beta alloydb connect atau klien Proxy Auth mandiri (alloydb-auth-proxy) dengan flag --public-ip. Meskipun AlloyDB Express menampilkan nama DNS publik, bukan alamat IP publik, bidang kontrol menyediakan koneksi publik yang mendasarinya untuk instance yang diselesaikan secara otomatis oleh Proxy Auth saat Anda menentukan --public-ip.

Untuk memulai instance Proxy Auth lokal dan membuka sesi psql menggunakan gcloud CLI, jalankan perintah gcloud beta alloydb connect dengan 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

Ganti kode berikut:

  • INSTANCE_ID: ID instance utama AlloyDB Express Anda.
  • CLUSTER_ID: ID cluster AlloyDB Express Anda.
  • REGION_ID: region tempat cluster Anda berada.
  • USERNAME: nama pengguna database (defaultnya adalah postgres).
  • DATABASE_NAME: nama database (defaultnya adalah postgres).
  • PROJECT_ID: ID project Google Cloud Anda.

Untuk mengetahui informasi selengkapnya tentang cara terhubung dengan gcloud CLI, termasuk autentikasi database IAM (--auto-iam-authn), lihat Terhubung menggunakan gcloud CLI.

Atau, Anda dapat mendownload dan menjalankan klien Proxy Auth mandiri dengan flag --public-ip:

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

Untuk mengetahui informasi tentang cara mendownload, mengonfigurasi, dan menghubungkan melalui klien Proxy Auth mandiri, lihat Menghubungkan menggunakan Proxy Auth AlloyDB.

Terhubung melalui Private Service Connect

Untuk konektivitas pribadi dari dalam jaringan VPC tanpa mengekspos database ke internet publik, Anda dapat mengonfigurasi Private Service Connect di instance AlloyDB Express. Anda dapat terhubung ke endpoint Private Service Connect baik secara langsung dari klien di dalam jaringan VPC Anda atau menggunakan Proxy Auth. Untuk mengetahui informasi selengkapnya tentang cara terhubung ke Private Service Connect, lihat Terhubung ke instance menggunakan Private Service Connect.

Saat mengikuti petunjuk tersebut untuk AlloyDB Express, buat cluster dan instance utama zona 1 vCPU seperti yang dijelaskan dalam Membuat cluster dan instance AlloyDB Express dengan Private Service Connect diaktifkan; AlloyDB Express mendukung konektivitas Private Service Connect masuk ke satu instance utama zona.

Mengedit instance AlloyDB Express

Anda dapat memperbarui jumlah CPU (1 vCPU atau 2 vCPU) atau flag database instance utama AlloyDB Express.

Konsol

  1. Di konsol Google Cloud , buka halaman Clusters.

    Buka Cluster

  2. Di kolom Resource name, klik nama cluster AlloyDB Express Anda.

  3. Di halaman Overview, di bagian Instances in your cluster, temukan instance utama Anda, lalu klik Edit primary (atau klik Instance actions > Edit).

  4. Di halaman Edit primary instance, perbarui setelan instance:

    • Di bagian Machine, dalam daftar Machine Type, pilih 1 vCPU, 4 GB atau 2 vCPU, 8 GB.
    • Opsional: Untuk mengonfigurasi flag database, luaskan Flags (atau klik Show advanced options dan luaskan Flags), lalu klik Add flag. Pilih flag database dari daftar New database flag, berikan nilai, lalu klik Done.
  5. Klik Update instance.

gcloud

Untuk menggunakan gcloud CLI, Anda dapat menginstal dan melakukan inisialisasi Google Cloud CLI, atau Anda dapat menggunakan Cloud Shell.

Untuk menskalakan instance dengan mengubah jumlah CPU-nya (1 atau 2) atau untuk memperbarui flag database-nya, jalankan perintah 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

Ganti kode berikut:

  • INSTANCE_ID: ID instance utama AlloyDB Express Anda.
  • CLUSTER_ID: ID cluster AlloyDB Express Anda.
  • REGION_ID: region tempat cluster Anda berada.
  • CPU_COUNT: jumlah vCPU untuk instance (1 untuk 1 vCPU, RAM 4 GB atau 2 untuk 2 vCPU, RAM 8 GB).
  • FLAGS (Opsional): daftar flag dan nilai database yang dipisahkan koma dalam format FLAG_NAME=VALUE. Jika Anda hanya mengupdate jumlah CPU, hapus flag --database-flags. Untuk mengetahui informasi selengkapnya tentang flag yang didukung, lihat Flag database yang didukung.
  • PROJECT_ID: ID project Google Cloud Anda.
  • --enable-public-dns atau --no-enable-public-dns: mengaktifkan atau menonaktifkan DNS publik untuk instance. Flag ini hanya tersedia di gcloud beta (gcloud beta alloydb instances update).
  • --allowed-psc-projects=[ALLOWED_PSC_PROJECTS,...]: memperbarui daftar yang dipisahkan koma untuk project ID atau nomor project konsumen Google Cloud yang diizinkan membuat endpoint Private Service Connect ke instance.

REST

Untuk memperbarui jumlah CPU atau flag database instance utama AlloyDB Express, kirim permintaan PATCH ke endpoint projects.locations.clusters.instances.patch dan tentukan kolom yang Anda perbarui dalam parameter kueri updateMask.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: ID project Google Cloud Anda.
  • REGION_ID: region tempat cluster Anda berada.
  • CLUSTER_ID: ID cluster AlloyDB Express Anda.
  • INSTANCE_ID: ID instance utama AlloyDB Express Anda.
  • CPU_COUNT: jumlah vCPU untuk instance (1 atau 2).
  • FLAG_NAME dan FLAG_VALUE (Opsional): nama dan nilai flag database yang akan ditetapkan. Jika Anda hanya mengupdate jumlah CPU, tetapkan updateMask=machineConfig.cpuCount dan hapus databaseFlags dari isi permintaan.

Metode HTTP dan URL:

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

Meminta isi JSON:

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

MCP

Untuk memperbarui jumlah CPU atau flag database instance utama AlloyDB Express, masukkan perintah di klien MCP Anda atau panggil alat MCP update_instance.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: ID project Google Cloud Anda.

  • REGION_ID: region tempat cluster Anda berada.

  • CLUSTER_ID: ID cluster AlloyDB Express Anda.

  • INSTANCE_ID: ID instance utama AlloyDB Express Anda.

  • CPU_COUNT: jumlah vCPU untuk instance (1 atau 2).

  • FLAG_NAME dan FLAG_VALUE: opsional: nama dan nilai flag database yang akan ditetapkan. Jika Anda hanya mengupdate jumlah CPU, hapus database_flags dari arguments.

Di klien MCP, Anda dapat memasukkan perintah yang mirip dengan berikut ini:

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

Parameter panggilan alat:

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

Melihat detail cluster dan instance AlloyDB Express

Anda dapat melihat daftar cluster AlloyDB Express, melihat detail tentang cluster atau instance AlloyDB Express tertentu, dan memeriksa penggunaan komputasi dan penyimpanan cluster Anda.

Untuk mengetahui informasi selengkapnya, lihat Melihat daftar cluster, Melihat detail cluster, dan Melihat detail instance.

Konsol

  1. Di konsol Google Cloud , buka halaman Clusters.

    Buka Cluster

    Di kolom Resource name, cluster AlloyDB Express menampilkan tag Express di samping nama cluster.

  2. Untuk melihat informasi mendetail tentang cluster dan instance utamanya, klik nama cluster di kolom Resource name.

  3. Di halaman Overview, lihat detail cluster di bagian Cluster details (termasuk tag Express di samping Cluster ID dan Total storage used dari batas 20 GB) dan detail instance utama di bagian Instances in your cluster.

gcloud

Untuk menggunakan gcloud CLI, Anda dapat menginstal dan melakukan inisialisasi Google Cloud CLI, atau Anda dapat menggunakan Cloud Shell.

  • Untuk melihat daftar cluster di project Anda, jalankan perintah gcloud alloydb clusters list:

    gcloud alloydb clusters list --project=PROJECT_ID
    
  • Untuk melihat detail tentang cluster tertentu, jalankan perintah gcloud alloydb clusters describe:

    gcloud alloydb clusters describe CLUSTER_ID \
        --region=REGION_ID \
        --project=PROJECT_ID
    
  • Untuk melihat detail tentang instance tertentu, jalankan perintah gcloud alloydb instances describe:

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

Ganti kode berikut:

  • PROJECT_ID: ID project Google Cloud Anda.
  • CLUSTER_ID: ID cluster AlloyDB Express Anda.
  • REGION_ID: region tempat cluster Anda berada.
  • INSTANCE_ID: ID instance utama AlloyDB Express Anda.

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: ID project Google Cloud Anda.
  • REGION_ID: region tempat cluster Anda berada.
  • CLUSTER_ID: ID cluster AlloyDB Express Anda.
  • INSTANCE_ID: ID instance utama AlloyDB Express Anda.

  • Untuk melihat daftar cluster di suatu region, kirim permintaan GET ke endpoint projects.locations.clusters.list:

    GET https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters
    
  • Untuk melihat detail tentang cluster, kirim permintaan GET ke endpoint projects.locations.clusters.get:

    GET https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID
    
  • Untuk melihat detail tentang instance, kirim permintaan GET ke 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

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: ID project Google Cloud Anda.

  • REGION_ID: region tempat cluster Anda berada.

  • CLUSTER_ID: ID cluster AlloyDB Express Anda.

  • INSTANCE_ID: ID instance utama AlloyDB Express Anda.

  • Untuk melihat daftar cluster di suatu region, masukkan perintah di klien MCP Anda atau panggil alat MCP list_clusters.

    Di klien MCP, Anda dapat memasukkan perintah yang mirip dengan berikut ini:

    Please list the AlloyDB clusters in REGION_ID in project PROJECT_ID.
    

    Parameter panggilan alat:

    {
      "jsonrpc": "2.0",
      "id": 1,
      "method": "tools/call",
      "params": {
        "name": "list_clusters",
        "arguments": {
          "parent": "projects/PROJECT_ID/locations/REGION_ID"
        }
      }
    }
    
  • Untuk melihat detail tentang cluster, masukkan perintah di klien MCP Anda atau panggil alat MCP get_cluster.

    Di klien MCP, Anda dapat memasukkan perintah yang mirip dengan berikut ini:

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

    Parameter panggilan alat:

    {
      "jsonrpc": "2.0",
      "id": 1,
      "method": "tools/call",
      "params": {
        "name": "get_cluster",
        "arguments": {
          "name": "projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID"
        }
      }
    }
    
  • Untuk melihat detail tentang instance, masukkan perintah di klien MCP Anda atau panggil alat MCP get_instance.

    Di klien MCP, Anda dapat memasukkan perintah yang mirip dengan berikut ini:

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

    Parameter panggilan alat:

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

Melihat penggunaan komputasi dan penyimpanan

Untuk memeriksa penyimpanan dan komputasi yang digunakan oleh cluster dan instance utama AlloyDB Express Anda, gunakan konsol Google Cloud atau Cloud Monitoring:

  • Di konsol Google Cloud , buka halaman Overview cluster Anda:

    • Penyimpanan yang digunakan: di bagian Detail cluster, lihat Total penyimpanan yang digunakan untuk melihat jumlah penyimpanan yang digunakan cluster Anda dari batas 20 GB.
    • Komputasi dan koneksi: lihat diagram CPU utilization dan Active connections di halaman Overview, atau klik System insights di menu navigasi untuk melihat metrik CPU, memori, dan penyimpanan yang mendetail.
  • Di Cloud Monitoring Metrics Explorer, buat kueri metrik berikut untuk jenis resource yang dimonitor alloydb.googleapis.com/Cluster dan alloydb.googleapis.com/Instance:

    • Penyimpanan yang terpakai: alloydb.googleapis.com/cluster/storage/usage
    • Pemakaian CPU: alloydb.googleapis.com/instance/cpu/average_utilization dan alloydb.googleapis.com/instance/cpu/maximum_utilization
    • Koneksi aktif: alloydb.googleapis.com/database/postgresql/backends

Menghapus cluster atau instance AlloyDB Express

Anda dapat menghapus instance utama atau cluster AlloyDB Express jika tidak lagi diperlukan.

Untuk mengetahui informasi selengkapnya, lihat Menghapus instance dan Menghapus cluster.

Konsol

  1. Di konsol Google Cloud , buka halaman Clusters.

    Buka Cluster

  2. Di kolom Resource name, klik nama cluster AlloyDB Express Anda.

  3. Di halaman Overview, hapus instance utama atau cluster:

    • Untuk menghapus instance utama, buka bagian Instance di cluster Anda, klik Tindakan instance > Hapus, masukkan ID instance dalam dialog, lalu klik Hapus.
    • Untuk menghapus cluster, hapus terlebih dahulu instance utama di cluster, lalu klik Delete cluster, masukkan ID cluster Anda di dialog Delete cluster, dan klik Delete.

gcloud

Untuk menggunakan gcloud CLI, Anda dapat menginstal dan melakukan inisialisasi Google Cloud CLI, atau Anda dapat menggunakan Cloud Shell.

  • Untuk menghapus instance, jalankan perintah gcloud alloydb instances delete:

    gcloud alloydb instances delete INSTANCE_ID \
        --cluster=CLUSTER_ID \
        --region=REGION_ID \
        --project=PROJECT_ID
    
  • Untuk menghapus cluster, jalankan perintah gcloud alloydb clusters delete. Jika cluster masih berisi instance utamanya, sertakan flag --force untuk menghapus instance utama dan cluster secara bersamaan:

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

Ganti kode berikut:

  • INSTANCE_ID: ID instance utama AlloyDB Express Anda.
  • CLUSTER_ID: ID cluster AlloyDB Express Anda.
  • REGION_ID: region tempat cluster Anda berada.
  • PROJECT_ID: ID project Google Cloud Anda.

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: ID project Google Cloud Anda.
  • REGION_ID: region tempat cluster Anda berada.
  • CLUSTER_ID: ID cluster AlloyDB Express Anda.
  • INSTANCE_ID: ID instance utama AlloyDB Express Anda.

  • Untuk menghapus instance, kirim permintaan DELETE ke endpoint projects.locations.clusters.instances.delete:

    DELETE https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID
    
  • Untuk menghapus cluster (termasuk instance utamanya saat Anda menentukan force=true), kirim permintaan DELETE ke endpoint projects.locations.clusters.delete:

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

Mengupgrade cluster AlloyDB Express ke AlloyDB

Anda dapat melakukan upgrade langsung cluster AlloyDB Express ke cluster AlloyDB.

Upgrade ini mempertahankan data database, skema, ekstensi, kredensial pengguna, konfigurasi jaringan (termasuk nama DNS publik dan endpoint Private Service Connect), serta jumlah vCPU instance utama Anda.

Daftar berikut menjelaskan resource dan setelan yang berubah selama proses upgrade:

  • Jumlah CPU, rasio memori, dan kapasitas komputasi: instance Anda mempertahankan jumlah vCPU saat ini (1 vCPU atau 2 vCPU) dan diupgrade dari rasio vCPU terhadap memori AlloyDB Express 1:4 (RAM 4 GB atau 8 GB) ke rasio vCPU terhadap memori AlloyDB 1:8 (RAM 8 GB untuk 1 vCPU atau RAM 16 GB untuk 2 vCPU). Setelah upgrade, Anda dapat menskalakan komputasi hingga 288 vCPU.
    • Saat mengupgrade instance 1 vCPU, Anda dibatasi pada region yang mendukung seri mesin C4A. Untuk mengetahui wilayah yang didukung, lihat Ketersediaan regional untuk C4A.
    • Jika instance AlloyDB Express Anda tidak berada di region yang mendukung jenis mesin C4A, Anda harus mengupdate instance utama ke konfigurasi 2 vCPU terlebih dahulu sebelum mengupgrade. Di konsol Google Cloud , jika Anda mengklik Upgrade untuk instance 1 vCPU di region yang tidak didukung, pesan akan meminta Anda untuk mengubah ukuran instance menjadi 2 vCPU terlebih dahulu.
  • Komputasi dan penagihan yang disediakan: upgrade akan menonaktifkan penskalaan hingga nol komputasi, dan instance Anda akan berjalan sebagai instance AlloyDB yang selalu aktif yang ditagih dengan tarif AlloyDB.
  • Kapasitas penyimpanan: upgrade akan menghapus batas penyimpanan 20 GB. Penyimpanan dapat ditingkatkan hingga kuota default 16 TiB per cluster, dan Anda dapat meminta penambahan kuota penyimpanan untuk meningkatkan skala hingga 128 TiB.
  • Fitur Enterprise: upgrade ini akan mengaktifkan ketersediaan tinggi (HA) regional, yang tercakup dalam perjanjian tingkat layanan (SLA) waktu beroperasi 99,99%. Fitur ini juga membuka instance pool baca, replikasi lintas region, pencadangan dan pemulihan berkelanjutan, serta pencadangan otomatis dan sesuai permintaan.

Untuk mengupgrade cluster AlloyDB Express ke cluster AlloyDB, ikuti langkah-langkah berikut:

Konsol

  1. Di konsol Google Cloud , buka halaman Clusters.

    Buka Cluster

  2. Di kolom Resource name, klik nama cluster AlloyDB Express Anda.

  3. Di halaman Overview, di bagian Cluster details, temukan Cluster ID, lalu klik Upgrade.

    Jika instance utama Anda adalah instance 1 vCPU di region yang tidak mendukung seri mesin C4A, pesan akan muncul:

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

    Untuk mengubah ukuran instance menjadi 2 vCPU, klik Edit instance. Setelah mengubah ukuran instance, klik Upgrade lagi.

  4. Di panel Upgrade from AlloyDB Express, masukkan Cluster ID Anda untuk mengonfirmasi upgrade, lalu klik Confirm.

gcloud

Untuk menggunakan gcloud CLI, Anda dapat menginstal dan melakukan inisialisasi Google Cloud CLI, atau Anda dapat menggunakan Cloud Shell.

Untuk mengupgrade cluster AlloyDB Express ke cluster AlloyDB, jalankan perintah gcloud beta alloydb clusters update dengan flag --no-enable-express:

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

Ganti kode berikut:

  • CLUSTER_ID: ID cluster AlloyDB Express Anda.
  • REGION_ID: region tempat cluster Anda berada.
  • PROJECT_ID: ID project Google Cloud Anda.

Jika instance utama Anda adalah instance 1 vCPU di region yang tidak mendukung seri mesin C4A, perintah akan gagal dengan error berikut:

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.

Untuk mengatasi error ini, update instance utama Anda ke 2 vCPU (--cpu-count=2), lalu jalankan kembali perintah upgrade.

REST

Untuk mengupgrade cluster AlloyDB Express ke cluster AlloyDB, kirim permintaan PATCH ke endpoint projects.locations.clusters.patch dengan updateMask=expressConfig.enabled dan tetapkan expressConfig.enabled ke false.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: ID project Google Cloud Anda.
  • REGION_ID: region tempat cluster Anda berada.
  • CLUSTER_ID: ID cluster AlloyDB Express Anda.

Metode HTTP dan URL:

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

Meminta isi JSON:

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

Jika instance utama Anda adalah instance 1 vCPU di region yang tidak mendukung seri mesin C4A, permintaan akan gagal dengan error berikut:

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.

Untuk mengatasi error ini, perbarui instance utama Anda ke 2 vCPU ("machineConfig": {"cpuCount": 2}), lalu kirim permintaan upgrade lagi.

Langkah berikutnya