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:
- Aktifkan AlloyDB API dan API lain yang diperlukan di project Google Cloud Anda agar project Anda diaktifkan untuk mengakses AlloyDB.
- Jika Anda menggunakan server MCP jarak jauh AlloyDB, konfigurasikan klien MCP Anda untuk terhubung ke endpoint server MCP global (
https://alloydb.googleapis.com/mcp) atau endpoint regional (https://alloydb.REGION_ID.rep.googleapis.com/mcp). Endpoint regional saat ini dalam Pratinjau.
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:
- Admin AlloyDB (
roles/alloydb.admin) - Pemilik (
roles/owner) - Editor (
roles/editor) -
Menggunakan server MCP jarak jauh AlloyDB:
MCP Tool User (
roles/mcp.toolUser)
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
Di konsol Google Cloud , buka halaman Get started.
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)).
Di kartu AlloyDB Express, klik Create cluster untuk membuka panel Create an AlloyDB Express cluster.
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
postgresdefault, 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.
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.
Untuk membuat cluster AlloyDB Express, jalankan perintah
gcloud beta alloydb clusters createdengan flag--enable-express:gcloud beta alloydb clusters create CLUSTER_ID \ --region=REGION_ID \ --password=PASSWORD \ --enable-express \ --project=PROJECT_IDGanti 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 databasepostgresdefault.PROJECT_ID: IDGoogle Cloud project tempat Anda ingin membuat cluster.
Untuk membuat instance utama di cluster AlloyDB Express, jalankan perintah
gcloud beta alloydb instances createdan pilih flag konektivitas Anda:- Khusus DNS publik: tentukan
--enable-public-dnsdan hapus--allowed-psc-projects. - Khusus Private Service Connect: hapus
--enable-public-dnsdan tentukan--allowed-psc-projects=ALLOWED_PROJECT_IDuntuk mengizinkan koneksi Private Service Connect dari project konsumen Google Cloud Anda. - DNS publik dan Private Service Connect: tentukan
--enable-public-dnsdan--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_IDGanti 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-projectsjika Anda hanya mengonfigurasi DNS publik.
- Khusus DNS publik: tentukan
REST
Untuk membuat cluster AlloyDB Express, kirim permintaan
POSTke endpointprojects.locations.clusters.createdenganexpressConfig.enabledditetapkan ketrue.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_IDMeminta isi JSON:
{ "databaseVersion": "POSTGRES_18", "expressConfig": { "enabled": true }, "initialUser": { "user": "INITIAL_USERNAME", "password": "INITIAL_USER_PASSWORD" } }Setelah operasi pembuatan cluster selesai, buat instance utama dengan mengirimkan permintaan
POSTke endpointprojects.locations.clusters.instances.createdenganmachineConfig.cpuCountditetapkan ke1(menentukan nilai selain1akan 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 kefalse) 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_IDMeminta isi JSON:
{ "instanceType": "PRIMARY", "availabilityType": "ZONAL", "machineConfig": { "cpuCount": 1 }, "networkConfig": { "publicDnsEnabled": true }, "pscInstanceConfig": { "allowedConsumerProjects": [ "ALLOWED_PROJECT_ID" ] } }- Khusus DNS publik: tetapkan
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:
Untuk membuat cluster AlloyDB Express, masukkan perintah di klien MCP Anda atau panggil alat MCP
create_clusterdenganexpress_config.enabledditetapkan ketrue.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.
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.Alat
create_clustermenampilkan operasi yang berjalan lama. Lakukan polling status operasi menggunakan alat MCPget_operationhinggadonemenjaditruedan cluster berada dalam statusREADY.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": truedan hapus"psc_instance_config".Khusus Private Service Connect: hapus
"public_dns_enabled"(yang ditetapkan secara default kefalse) 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": truedan"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" ] } } } }Lakukan polling pada operasi pembuatan instance menggunakan alat MCP
get_operationhinggadonemenjaditruedan instance berada dalam statusREADY.
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:
- Terhubung langsung menggunakan klien PostgreSQL (seperti
psql): memerlukan pengizinan alamat IP klien Anda di jaringan eksternal yang diizinkan terlebih dahulu. - Hubungkan menggunakan gcloud CLI atau Auth Proxy, atau gunakan Konektor Bahasa AlloyDB: mengenkripsi traffic secara otomatis dan tidak memerlukan konfigurasi jaringan eksternal yang diizinkan.
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.
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
Di konsol Google Cloud , buka halaman Clusters.
Di kolom Resource name, klik nama cluster AlloyDB Express Anda.
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).
Di bagian Connectivity, pastikan konektivitas publik diaktifkan.
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/32dari mesin Anda saat ini.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 updatedengan 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_IDGanti 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
PATCHke endpointprojects.locations.clusters.instances.patchdenganupdateMask=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.authorizedExternalNetworksMeminta isi JSON:
{ "networkConfig": { "authorizedExternalNetworks": [ { "cidrRange": "CIDR_RANGE1" }, { "cidrRange": "CIDR_RANGE2" } ] } }MCP
Masukkan perintah di klien MCP Anda atau panggil alat MCP
update_instancedengan kolomauthorized_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, seperti203.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" ] } } }Ambil nama DNS publik instance Anda:
Konsol
- Di konsol Google Cloud , buka halaman Clusters dan klik nama cluster AlloyDB Express Anda.
- Buka Connectivity (atau lihat kartu instance utama di halaman Overview) dan salin nama DNS publik instance.
gcloud
Jalankan perintah
gcloud beta alloydb instances describeuntuk mengambil nilainetworkInfo.publicDnsName:gcloud beta alloydb instances describe INSTANCE_ID \ --cluster=CLUSTER_ID \ --region=REGION_ID \ --format="value(networkInfo.publicDnsName)" \ --project=PROJECT_IDOutputnya menggunakan format berikut:
IDENTIFIER.IDENTIFIER.REGION_ID.alloydb.s.cloud.googDalam output ini,
IDENTIFIERadalah ID alfanumerik yang dihasilkan sistem.REST
Kirim permintaan
GETke endpointprojects.locations.clusters.instances.getdan baca kolomnetworkInfo.publicDnsNamedari respons:GET https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_IDMCP
Masukkan perintah di klien MCP Anda atau panggil alat MCP
get_instancedan baca kolomnetworkInfo.publicDnsNamedari 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" } } }Hubungkan ke database Anda menggunakan URI koneksi PostgreSQL standar dan nama DNS publik instance Anda:
psql postgresql://USERNAME@PUBLIC_DNS_NAME/DATABASE_NAMEGanti 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 adalahpostgres).
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 adalahpostgres).DATABASE_NAME: nama database (defaultnya adalahpostgres).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-ipUntuk 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
Di konsol Google Cloud , buka halaman Clusters.
Di kolom Resource name, klik nama cluster AlloyDB Express Anda.
Di halaman Overview, di bagian Instances in your cluster, temukan instance utama Anda, lalu klik Edit primary (atau klik Instance actions > Edit).
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.
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 (1untuk 1 vCPU, RAM 4 GB atau2untuk 2 vCPU, RAM 8 GB).FLAGS(Opsional): daftar flag dan nilai database yang dipisahkan koma dalam formatFLAG_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-dnsatau--no-enable-public-dns: mengaktifkan atau menonaktifkan DNS publik untuk instance. Flag ini hanya tersedia digcloud 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 (1atau2).FLAG_NAMEdanFLAG_VALUE(Opsional): nama dan nilai flag database yang akan ditetapkan. Jika Anda hanya mengupdate jumlah CPU, tetapkanupdateMask=machineConfig.cpuCountdan hapusdatabaseFlagsdari 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 (1atau2).FLAG_NAMEdanFLAG_VALUE: opsional: nama dan nilai flag database yang akan ditetapkan. Jika Anda hanya mengupdate jumlah CPU, hapusdatabase_flagsdariarguments.
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
Di konsol Google Cloud , buka halaman Clusters.
Di kolom Resource name, cluster AlloyDB Express menampilkan tag Express di samping nama cluster.
Untuk melihat informasi mendetail tentang cluster dan instance utamanya, klik nama cluster di kolom Resource name.
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_IDUntuk melihat detail tentang cluster tertentu, jalankan perintah
gcloud alloydb clusters describe:gcloud alloydb clusters describe CLUSTER_ID \ --region=REGION_ID \ --project=PROJECT_IDUntuk 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
GETke endpointprojects.locations.clusters.list:GET https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clustersUntuk melihat detail tentang cluster, kirim permintaan
GETke endpointprojects.locations.clusters.get:GET https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_IDUntuk melihat detail tentang instance, kirim permintaan
GETke endpointprojects.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/Clusterdanalloydb.googleapis.com/Instance:- Penyimpanan yang terpakai:
alloydb.googleapis.com/cluster/storage/usage - Pemakaian CPU:
alloydb.googleapis.com/instance/cpu/average_utilizationdanalloydb.googleapis.com/instance/cpu/maximum_utilization - Koneksi aktif:
alloydb.googleapis.com/database/postgresql/backends
- Penyimpanan yang terpakai:
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
Di konsol Google Cloud , buka halaman Clusters.
Di kolom Resource name, klik nama cluster AlloyDB Express Anda.
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_IDUntuk menghapus cluster, jalankan perintah
gcloud alloydb clusters delete. Jika cluster masih berisi instance utamanya, sertakan flag--forceuntuk 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
DELETEke endpointprojects.locations.clusters.instances.delete:DELETE https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_IDUntuk menghapus cluster (termasuk instance utamanya saat Anda menentukan
force=true), kirim permintaanDELETEke endpointprojects.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
Di konsol Google Cloud , buka halaman Clusters.
Di kolom Resource name, klik nama cluster AlloyDB Express Anda.
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.
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.