Menginstal AlloyDB Omni di Kubernetes

Pilih versi dokumentasi:

Halaman ini memberikan ringkasan Operator Kubernetes AlloyDB Omni, dengan petunjuk untuk menggunakannya guna men-deploy AlloyDB Omni ke cluster Kubernetes. Halaman ini mengasumsikan Anda telah memiliki pengetahuan dasar tentang operasi Kubernetes.

Untuk mengetahui petunjuk cara menginstal AlloyDB Omni ke lingkungan Linux standar, lihat Menginstal AlloyDB Omni.

Ringkasan

Untuk men-deploy AlloyDB Omni ke cluster Kubernetes, instal Operator AlloyDB Omni, ekstensi ke Kubernetes API yang disediakan oleh Google.

Anda mengonfigurasi dan mengontrol cluster database AlloyDB Omni berbasis Kubernetes dengan menyandingkan file manifes deklaratif dengan utilitas kubectl, seperti deployment berbasis Kubernetes lainnya. Anda tidak menggunakan CLI AlloyDB Omni, yang ditujukan untuk deployment ke masing-masing mesin Linux, bukan cluster Kubernetes.

Sebelum memulai

Anda memerlukan akses ke hal berikut:

  • Cluster Kubernetes, yang menjalankan software berikut:
  • Utilitas kubectl.
  • Pengelola paket helm.

  • Google Cloud CLI.

    Jika Anda perlu menginstal gcloud CLI, perhatikan bahwa langkah-langkah menjalankan gcloud init bersifat opsional. Menginstal AlloyDB Omni tidak memerlukan autentikasi dengan Akun Google.

Setiap node di cluster Kubernetes harus memiliki hal berikut:

  • Minimal dua CPU x86 atau AMD64.
  • Minimum RAM 8 GB.
  • Kernel Linux versi 4.18 atau yang lebih baru.
  • Grup kontrol v2 (cgroup v2) diaktifkan.

Menggunakan diagram Helm

Anda dapat menggunakan diagram Helm dari repositori alloydb-omni-samples untuk men-deploy komponen yang ditunjukkan dalam panduan ini.

Menginstal Operator AlloyDB Omni

Untuk menginstal Operator AlloyDB Omni, ikuti langkah-langkah berikut:

  1. Tentukan beberapa variabel lingkungan:

    export GCS_BUCKET=alloydb-omni-operator
export HELM_PATH=$(gcloud storage cat gs://$GCS_BUCKET/latest)
export OPERATOR_VERSION="${HELM_PATH%%/*}"

  2. Download Operator AlloyDB Omni:

    gcloud storage cp gs://$GCS_BUCKET/$HELM_PATH ./ --recursive

  3. Instal Operator AlloyDB Omni:

    helm install alloydbomni-operator alloydbomni-operator-${OPERATOR_VERSION}.tgz \
--create-namespace \
--namespace alloydb-omni-system \
--atomic \
--timeout 5m

    Penginstalan yang berhasil akan menampilkan output berikut:

    NAME: alloydbomni-operator
LAST DEPLOYED: CURRENT_TIMESTAMP
NAMESPACE: alloydb-omni-system
STATUS: deployed
REVISION: 1
TEST SUITE: None

  4. Lakukan pembersihan dengan menghapus file penginstalan AlloyDB Omni Operator yang didownload. File ini diberi nama alloydbomni-operator-VERSION_NUMBER.tgz, dan berada di direktori kerja Anda saat ini.

Membuat cluster database

Cluster database AlloyDB Omni berisi semua penyimpanan dan resource komputasi yang diperlukan untuk menjalankan server AlloyDB Omni, termasuk server utama, replika, dan semua data Anda.

Setelah menginstal Operator AlloyDB Omni di cluster Kubernetes, Anda dapat membuat cluster database AlloyDB Omni di cluster Kubernetes dengan menerapkan manifes yang mirip dengan berikut ini:

apiVersion: v1
kind: Secret
metadata:
  name: db-pw-DB_CLUSTER_NAME
type: Opaque
data:
  DB_CLUSTER_NAME: "ENCODED_PASSWORD"
---
apiVersion: alloydbomni.dbadmin.goog/v1
kind: DBCluster
metadata:
  name: DB_CLUSTER_NAME
spec:
  databaseVersion: "15.5.2"
  primarySpec:
    adminUser:
      passwordRef:
        name: db-pw-DB_CLUSTER_NAME
    resources:
      cpu: CPU_COUNT
      memory: MEMORY_SIZE
      disks:
      - name: DataDisk
        size: DISK_SIZE
        storageClass: standard

Ganti kode berikut:

  • DB_CLUSTER_NAME: nama cluster database ini—misalnya, my-db-cluster.

  • ENCODED_PASSWORD: sandi login database untuk peran pengguna postgres default, yang dienkode sebagai string base64—misalnya, Q2hhbmdlTWUxMjM= untuk ChangeMe123.

  • CPU_COUNT: jumlah CPU yang tersedia untuk setiap instance database dalam cluster database ini.

  • MEMORY_SIZE: jumlah memori per instance database dari cluster database ini. Sebaiknya tetapkan setelan ini ke 8 gigabyte per CPU. Misalnya, jika Anda menetapkan cpu ke 2 sebelumnya dalam manifes ini, sebaiknya tetapkan memory ke 16Gi.

  • DISK_SIZE: ukuran disk per instance database—misalnya, 10Gi.

Setelah Anda menerapkan manifes ini, cluster Kubernetes Anda akan berisi cluster database AlloyDB Omni dengan konfigurasi memori, CPU, dan penyimpanan yang ditentukan. Untuk membuat koneksi pengujian dengan cluster database baru, lihat Menghubungkan menggunakan psql yang sudah diinstal sebelumnya.

Untuk mengetahui informasi selengkapnya tentang manifes Kubernetes dan cara menerapkannya, lihat Mengelola resource.

Langkah berikutnya