Men-deploy AlloyDB Omni di satu VM GCE

1. Pengantar

Codelab ini menunjukkan cara men-deploy AlloyDB Omni di satu virtual machine (VM) Google Compute Engine (GCE). Di akhir codelab ini, Anda akan menyediakan satu VM GCE yang menjalankan Rocky Linux 9 dan menginstal AlloyDB Omni menggunakan paket RPM resmi. Mesin virtual ini berisi semua alat pengembangan yang Anda perlukan. Layanan ini menawarkan direktori beranda tetap sebesar 20 GB dan beroperasi di Google Cloud, sehingga sangat meningkatkan performa dan autentikasi jaringan.

Prasyarat

  • Akses ke Project Google Cloud dan Cloud Shell dari Konsol Cloud.
  • Google Cloud SDK (gcloud) diinstal dan dikonfigurasi. Untuk mengetahui detail tentang cara menginstal gcloud, lihat gcloud-install

Yang akan Anda pelajari

  • Cara membuat dan menyiapkan VM GCE untuk AlloyDB Omni menggunakan gcloud.
  • Cara menginstal RPM AlloyDB Omni di satu node Linux.
  • Cara melakukan bootstrapping dan mengonfigurasi AlloyDB Omni.
  • Cara memverifikasi penginstalan database lokal.

Yang Anda butuhkan

  • Dapatkan link URL ke RPM AlloyDB Omni. Link dikirim ke email Anda yang mencakup server URL repositori. Lakukan inisialisasi variabel lingkungan berikut agar URL siap digunakan selama codelab.
    export ALLOYDB_OMNI_REPOSITORY_URL="..."
  • Terminal yang berfungsi dengan akses ke Google Cloud. Anda dapat menggunakan Cloud Shell untuk tujuan ini.

2. Penyiapan dan Persyaratan

Penyiapan project

Buat Project Google Cloud

  1. Di Konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.
  2. Pastikan penagihan diaktifkan untuk project Cloud Anda. Pelajari cara memeriksa apakah penagihan telah diaktifkan pada suatu project.

Mulai Cloud Shell

Meskipun Anda dapat mengoperasikan Google Cloud dari jarak jauh menggunakan laptop, dalam codelab ini, Anda akan menggunakan Google Cloud Shell, lingkungan command line yang berjalan di cloud.

Ikon untuk mengaktifkan Cloud Shell

  1. Buka Konsol Google Cloud, lalu klik ikon Cloud Shell di toolbar kanan atas.Anda juga dapat membuka Cloud Shell dengan salah satu cara berikut:
    • Jika Anda menggunakan Konsol Google Cloud, tekan G, lalu S.
    • Klik link ini.

Biasanya, perlu waktu beberapa saat untuk menyediakan dan terhubung ke lingkungan. Setelah operasi ini selesai, Anda akan melihat sesuatu yang mirip dengan berikut ini:

Terminal Google Cloud Shell yang menunjukkan bahwa lingkungan telah terhubung{: width="624"}

3. Membuat VM Compute Engine

Di bagian ini, Anda akan membuat satu virtual machine (VM) Compute Engine (GCE) menggunakan alat command line gcloud. Anda menggunakan image Rocky Linux 9, yang sepenuhnya kompatibel dengan RPM AlloyDB Omni.

  1. Tentukan variabel lingkungan untuk project ID, nama VM, zona, dan region Anda.
    export PROJECT="your-project-id"
export INSTANCE_NAME="alloydb-omni-vm"
export ZONE="us-central1-c"
export REGION="us-central1"
  2. Login menggunakan pengguna akun Google Cloud Anda, dan konfigurasi project default.
    gcloud auth login
gcloud config set project $PROJECT
  3. Buat aturan firewall untuk mengizinkan koneksi SSH ke VM Anda.
    gcloud compute firewall-rules create allow-ssh-alloydb-omni \
    --project=$PROJECT \
    --direction=INGRESS \
    --action=allow \
    --rules=tcp:22 \
    --source-ranges="0.0.0.0/0"
  4. Karena VM dibuat tanpa alamat IP publik, konfigurasi gateway Cloud Router dan Cloud NAT agar VM dapat mengakses repositori paket eksternal dan mendownload software yang diperlukan.
    gcloud compute routers create alloydb-omni-router \
    --project=$PROJECT \
    --network=default \
    --region=$REGION

gcloud compute routers nats create alloydb-omni-nat \
    --project=$PROJECT \
    --router=alloydb-omni-router \
    --region=$REGION \
    --nat-all-subnet-ip-ranges \
    --auto-allocate-nat-external-ips
  5. Pastikan jaringan VPC Anda memiliki rute gateway internet default yang valid. Di beberapa lingkungan bersama atau uji coba, rute default terkadang dihapus oleh skrip pembersihan. Rute ini diperlukan agar Cloud NAT meneruskan traffic keluar ke internet.
    gcloud compute routes create default-internet-route \
    --project=$PROJECT \
    --network=default \
    --destination-range=0.0.0.0/0 \
    --next-hop-gateway=default-internet-gateway
  6. Buat instance VM Compute Engine dengan spesifikasi yang diperlukan (16 vCPU, persistent disk seimbang 20 GB, Rocky Linux 9). Untuk meningkatkan keamanan, kita menggunakan flag --no-address untuk memastikan VM tidak diberi alamat IP publik.
    gcloud compute instances create $INSTANCE_NAME \
    --project=$PROJECT \
    --zone=$ZONE \
    --machine-type=n2-highmem-16 \
    --image-family=rocky-linux-9 \
    --image-project=rocky-linux-cloud \
    --boot-disk-size=20GB \
    --boot-disk-type=pd-balanced \
    --no-address
  7. Setelah VM dibuat, verifikasi status VM.
    gcloud compute instances list --filter="name=$INSTANCE_NAME" --project=$PROJECT

4. Mempersiapkan VM

Di bagian ini, Anda akan terhubung ke VM yang baru dibuat dan menyiapkan lingkungan sistem operasi, yang mencakup penyiapan direktori data dan konfigurasi SELinux.

  1. Hubungkan ke VM melalui SSH menggunakan Identity-Aware Proxy (IAP). Karena VM tidak memiliki alamat IP publik, gcloud akan otomatis melakukan tunneling koneksi SSH melalui IAP.
    gcloud compute ssh $INSTANCE_NAME --zone=$ZONE --project=$PROJECT --tunnel-through-iap
  2. Tentukan variabel lingkungan di VM untuk direktori data dan URL repositori AlloyDB Omni Anda. Ganti URL dengan URL yang Anda terima dari formulir pendaftaran.
    export PGDATA="/var/lib/alloydbomni"
export ALLOYDB_OMNI_REPOSITORY_URL="..."
  3. Buat direktori data tempat AlloyDB Omni akan menyimpan file databasenya.
    sudo mkdir -p $PGDATA
  4. Instal paket policycoreutils-python-utils agar kebijakan SELinux dapat dikonfigurasi untuk memungkinkan layanan database AlloyDB Omni berjalan dengan benar.
    sudo dnf install -y policycoreutils-python-utils

5. Menginstal AlloyDB Omni

Setelah VM disiapkan, Anda kini dapat mengonfigurasi repositori paket dan menginstal paket RPM AlloyDB Omni.

  1. Konfigurasi repositori YUM di VM Anda dengan membuat file konfigurasi repositori.
    sudo tee /etc/yum.repos.d/alloydbomni.repo << EOF
[alloydbomni]
name=alloydbomni
baseurl=$ALLOYDB_OMNI_REPOSITORY_URL
enabled=1
repo_gpgcheck=0
gpgcheck=1
gpgkey=https://dl.google.com/linux/linux_signing_key.pub
EOF
  2. Perbarui cache YUM untuk memastikan repositori baru dikenali.
    sudo yum makecache
    Catatan: Untuk rilis Pratinjau RPM AlloyDB Omni, integritas paket diverifikasi di tingkat RPM individual. Untuk melanjutkan konfigurasi repositori YUM, konfigurasi repo_gpgcheck=0 .
  3. Instal paket RPM AlloyDB Omni versi 18.
    sudo dnf install -y alloydbomni18

6. Menyiapkan AlloyDB Omni

Setelah menginstal paket RPM, Anda harus melakukan inisialisasi, mengonfigurasi, dan memulai layanan database AlloyDB Omni.

  1. Tentukan sandi yang kuat untuk pengguna administrator postgres PostgreSQL.
    export PGPASSWORD="YourStrongPassword123!"
  2. Lakukan inisialisasi instance database AlloyDB Omni.
    sudo PGPASSWORD=$PGPASSWORD PGDATA=$PGDATA /usr/lib/postgresql/18/bin/alloydbomni18-setup initdb
  3. Konfigurasi konteks file SELinux untuk mengizinkan layanan AlloyDB Omni membaca dan menulis data di direktori data kustom Anda, lalu pulihkan konteks keamanan yang benar.
    sudo setenforce 0
  4. Siapkan instance database AlloyDB Omni.
    sudo PGPASSWORD=$PGPASSWORD PGDATA=$PGDATA /usr/lib/postgresql/18/bin/alloydbomni18-setup preparedb
  5. (Opsional) Untuk eksekusi layanan AlloyDB Omni yang dioptimalkan, jalankan utilitas penyiapan host untuk mengonfigurasi setelan kernel dan memori yang direkomendasikan secara otomatis.
    sudo /usr/lib/postgresql/18/bin/alloydbomni18-setup-host
  6. Aktifkan dan mulai layanan systemd AlloyDB Omni.
    sudo systemctl enable alloydbomni18
sudo systemctl start alloydbomni18
  7. Pastikan layanan AlloyDB Omni aktif dan berjalan dengan baik.
    sudo systemctl status alloydbomni18
    Verifikasi output yang menunjukkan Active: active (running).

7. Verifikasi AlloyDB Omni

Untuk memverifikasi bahwa database AlloyDB Omni node tunggal Anda berfungsi dengan benar, hubungkan ke database tersebut menggunakan klien PostgreSQL standar (psql) yang diinstal dengan paket.

  1. Hubungkan ke instance database lokal sebagai pengguna postgres. Anda akan diminta memasukkan sandi yang Anda konfigurasi sebelumnya.
    /usr/lib/postgresql/18/bin/psql -h localhost -U postgres -W
  2. Setelah koneksi dibuat, jalankan kueri SQL dasar untuk memverifikasi versi server database dan untuk memverifikasi bahwa AlloyDB Omni sedang berjalan.
    postgres=# SELECT version();
    Output yang dihasilkan menunjukkan PostgreSQL 18 berjalan dengan AlloyDB Omni.
  3. Masukkan \q untuk keluar dari perintah psql.

8. Pembersihan dan Survei

Setelah menyelesaikan codelab, Anda dapat membersihkan resource Google Cloud untuk menghindari timbulnya biaya yang tidak diinginkan.

  1. Putuskan koneksi dari sesi SSH di VM untuk kembali ke terminal Cloud Shell lokal Anda.
    exit
  2. Hapus instance VM Compute Engine.
    gcloud compute instances delete $INSTANCE_NAME --zone=$ZONE --project=$PROJECT --quiet
  3. Hapus aturan firewall yang dibuat untuk akses SSH.
    gcloud compute firewall-rules delete allow-ssh-alloydb-omni --project=$PROJECT --quiet
  4. Hapus gateway Cloud NAT dan Cloud Router.
    gcloud compute routers nats delete alloydb-omni-nat --router=alloydb-omni-router --region=$REGION --project=$PROJECT --quiet
gcloud compute routers delete alloydb-omni-router --region=$REGION --project=$PROJECT --quiet

9. Selamat

Selamat, Anda telah menyelesaikan codelab ini! Anda telah berhasil men-deploy dan mengonfigurasi AlloyDB Omni di satu virtual machine Compute Engine.

Yang telah kita bahas

  • Cara menyediakan dan menyiapkan VM Compute Engine untuk AlloyDB Omni.
  • Cara mengonfigurasi repositori paket AlloyDB Omni dan menginstal RPM.
  • Cara menginisialisasi, mengonfigurasi, dan mengelola layanan database AlloyDB Omni menggunakan systemd.
  • Cara memverifikasi fungsi database menggunakan alat PostgreSQL standar.

Untuk mengetahui informasi selengkapnya, lihat Ringkasan AlloyDB Omni.

10. Survei

Bagaimana Anda akan menggunakan tutorial ini?

Hanya membacanya Membaca dan menyelesaikan latihannya