Menginstal orkestrator RPM AlloyDB Omni

Pilih versi dokumentasi:

AlloyDB Omni menggunakan orchestrator RPM menyediakan platform otomatisasi untuk menginstal, menyiapkan, dan mengelola cluster database AlloyDB Omni di serangkaian virtual machine (VM) atau server bare metal. AlloyDB Omni menggunakan orchestrator RPM menyediakan antarmuka CLI dan Ansible yang dijalankan di node kontrol khusus tempat Anda mengelola satu atau beberapa cluster dari jarak jauh.

Bergantung pada kebutuhan otomatisasi, Anda dapat memilih antara dua antarmuka orkestrator:

  • CLI orchestrator AlloyDB Omni alloydbctl: direkomendasikan untuk lingkungan yang menggunakan skrip shell untuk otomatisasi.
  • Koleksi Ansible orchestrator AlloyDB Omni: direkomendasikan untuk lingkungan yang menggunakan otomatisasi berbasis Ansible.

Batasan

Batasan berikut berlaku untuk rilis ini:

  • Rilis ini hanya mendukung AlloyDB Omni PostgreSQL 18.
  • Rilis ini hanya mendukung paket software yang kompatibel dengan RHEL versi 9.
  • Rilis ini hanya mendukung platform berbasis Intel x86 64-bit.
  • Upgrade versi utama tidak didukung dalam rilis ini.
  • Rilis ini tidak menyertakan petunjuk untuk menyiapkan Pemulihan dari Bencana.
  • Rilis ini tidak menyertakan petunjuk untuk menyiapkan instance pool baca.
  • Monitor AlloyDB Omni tidak mendukung koneksi SSL. Anda harus men-deploy server dasbor pemantauan di jaringan pribadi yang sama dengan node AlloyDB Omni.

Sebelum memulai

Sebelum memulai deployment, pastikan Anda memenuhi persyaratan berikut:

Mendapatkan paket AlloyDB Omni

Paket software AlloyDB Omni menggunakan orchestrator RPM dalam status Pratinjau. Anda harus mendaftar menggunakan formulir pendaftaran Pratinjau AlloyDB Omni menggunakan orchestrator RPM untuk menerima file RPM.

Jika Anda mengelola paket software melalui repositori Yum pribadi, ikuti petunjuk dari pengelolaan repositori Anda untuk menyertakan file RPM dependen di repositori. Untuk mengetahui informasi selengkapnya, lihat Dependensi paket software.

Menyiapkan repositori software

RPM AlloyDB Omni dikelola di repositori Yum global. Atau, jika organisasi Anda mengelola software melalui repositori Yum pribadi, Anda harus menyertakan paket RPM yang diberikan setelah pendaftaran ke repositori Anda sesuai dengan alat pengelolaan Anda. Anda memerlukan URL repositori pribadi selama proses deployment.

Menyediakan mesin

Menyediakan serangkaian VM yang menjalankan RHEL 9, termasuk:

  • Pengontrol: 1 node yang mengatur pen-deploy-an dan memiliki akses SSH tanpa sandi ke semua node lainnya.
  • Database: 1 atau 3 node yang menjalankan layanan inti dan pemantauan AlloyDB Omni.
  • Load balancer: 2 node opsional yang menjalankan HAProxy dan penggabung koneksi opsional seperti PgBouncer.

Mengonfigurasi jaringan dan firewall

Konfigurasi firewall Anda untuk mengizinkan port TCP berikut berdasarkan arsitektur Anda:

Port Protokol Node Layanan Traffic Catatan
5432 TCP Load balancer HAProxy Masuk Di node load balancer jika berlaku
6432 TCP Load balancer PgBouncer Masuk Penggabung koneksi jika berlaku
9187 TCP Database Monitor AlloyDB Masuk Pantau jika berlaku; tidak mendukung TLS
5432 TCP Database AlloyDB Masuk Arsitektur tangguh 3 node
6432 TCP Database PgBouncer Masuk Penggabung koneksi jika berlaku pada arsitektur tangguh 3 node
2380 TCP etcd etcd Masuk Untuk protokol peer-to-peer etcd
- VRRP Load balancer Keepalived Masuk Pemilihan pemimpin Keepalived
- VRRP Database Keepalived Masuk Pemilihan pemimpin Keepalived pada arsitektur tangguh 3 node
6703 TCP Pengelola Cluster Pengelola Cluster Masuk Port gRPC Cluster Manager
6702 TCP Semua node Node Manager Masuk Port gRPC Node Manager
6700 TCP Semua node Node Manager Masuk Port gRPC inisialisasi Node Manager
8086 HTTP Semua node Node Manager Masuk Port HTTP Node Manager untuk memeriksa primer atau standby
2379 TCP etcd etcd Masuk Agar Cluster Manager dapat bekerja dengan etcd
443 HTTPS Database Cloud Storage Keluar Untuk mengirim data cadangan

Mode SELinux host

AlloyDB Omni mendukung SELinux dalam mode permisif dan pemberlakuan.

Untuk mengaktifkan atau menonaktifkan SELinux, pastikan file /etc/selinux/config diperbarui di semua node. Sebelum melakukan bootstrapping cluster, pastikan setelan SELinux konsisten di semua node database dan node load balancer. Untuk memverifikasi setelan saat ini, gunakan perintah getenforce.

Untuk mengetahui informasi selengkapnya, lihat Spesifikasi kebijakan SELinux.

Menginstal pengelola

Ansible

Gunakan metode ini jika Anda berencana menggunakan playbook Ansible untuk mengelola cluster.

  1. Di node kontrol, instal Ansible dan library Python yang diperlukan:

    # Install EPEL for RHEL 9
sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm -y
# Install Ansible and dependencies
sudo dnf install ansible
sudo dnf install python3-grpcio python3-protobuf python3-googleapis-common-protos

  2. Download file tar koleksi Ansible dan tanda tangannya, verifikasi paket, lalu instal:

    # Download the collection and its signature
wget ALLOYDBOMNI_SERVER/google-alloydbomni_orchestrator-0.1.0-1.tar.gz
wget ALLOYDBOMNI_SERVER/google-alloydbomni_orchestrator-0.1.0-1.tar.gz.asc

# Import the Google Linux signing key
curl -sS https://dl.google.com/linux/linux_signing_key.pub | gpg --import

# Verify the collection tarball
gpg --verify google-alloydbomni_orchestrator-0.1.0-1.tar.gz.asc \
google-alloydbomni_orchestrator-0.1.0-1.tar.gz

# Install the collection
ansible-galaxy collection install google-alloydbomni_orchestrator-0.1.0-1.tar.gz

# Verify the installation
ansible-galaxy collection list | grep alloydbomni_orchestrator

    Ganti ALLOYDBOMNI_SERVER dengan URL server tempat paket software AlloyDB Omni, termasuk file tar koleksi Ansible, dihosting. Sumber ini diberikan kepada Anda setelah Anda mendaftar ke AlloyDB Omni menggunakan orchestrator RPM Pratinjau.

alloydbctl

Gunakan metode ini jika Anda lebih memilih utilitas command line untuk mengelola resource.

  1. Buat file konfigurasi Yum di node kontrol di /etc/yum.repos.d/alloydbomni_orchestrator.repo:

    [alloydbomni_orchestrator]
name=Google AlloyDB Omni orchestrator packages
baseurl=ALLOYDB_OMNI_ORCHESTRATOR_REPOSITORY_URL
enabled=1
repo_gpgcheck=0
gpgcheck=1
gpgkey=REPO_GPG_KEY

    Ganti kode berikut:

    • ALLOYDB_OMNI_ORCHESTRATOR_REPOSITORY_URL URL repositori yang berisi RPM orchestrator AlloyDB Omni.
    • REPO_GPG_KEY: lokasi kunci publik Google untuk verifikasi GNU Privacy Guard (GPG), misalnya, https://dl.google.com/linux/linux_signing_key.pub. Ini juga dapat ditetapkan sebagai jalur jika kunci didownload ke file, misalnya, file:///tmp/linux_signing_key.pub.

  2. Instal paket dan tambahkan biner ke PATH sistem Anda:

    sudo dnf install alloydbomni_orchestrator
export PATH=$PATH:/usr/local/bin

  3. Verifikasi penginstalan dengan menjalankan:

    alloydbctl --help