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 sekumpulan mesin virtual (VM) atau server bare metal. AlloyDB Omni menggunakan orchestrator RPM menyediakan CLI dan antarmuka Ansible yang dijalankan di node kontrol khusus tempat Anda mengelola satu atau beberapa cluster dari jarak jauh.

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

  • 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 kumpulan 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 berada dalam 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 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 disediakan setelah pendaftaran ke dalam repositori sesuai dengan alat pengelolaan Anda. Anda memerlukan URL repositori pribadi selama proses deployment.

Menyediakan mesin

Sediakan sekumpulan VM yang menjalankan RHEL 9, termasuk:

  • Pengontrol: 1 node yang mengatur deployment 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 Monitor 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 Pengelola Cluster
6702 TCP Semua node Pengelola Node Masuk Port gRPC Pengelola Node
6700 TCP Semua node Pengelola Node Masuk Port gRPC Init Pengelola Node
8086 HTTP Semua node Pengelola Node Masuk Port HTTP Pengelola Node untuk memeriksa utama atau standby
2379 TCP etcd etcd Masuk Agar Pengelola Cluster dapat berfungsi dengan etcd
443 HTTPS Database Cloud Storage Keluar Untuk mengirim data cadangan

Mode SELinux host

AlloyDB Omni mendukung SELinux dalam mode permisif dan mode penerapan.

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 orchestrator

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 untuk 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. Hal 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