Menginstal AlloyDB Omni di Kubernetes

Pilih versi dokumentasi:

Halaman ini memberikan ringkasan operator AlloyDB Omni Kubernetes, 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.

Gambar dasar

Mulai dari versi 1.5.0, image Kubernetes operator AlloyDB Omni dibuat berdasarkan Universal Base Image (UBI) 9 Red Hat. Transisi ini meningkatkan keamanan, konsistensi, dan kepatuhan untuk deployment Anda.

Kompatibilitas operator AlloyDB Omni 1.1.0 (dan yang lebih baru)

Operator AlloyDB Omni versi 1.1.0 tidak kompatibel dengan AlloyDB Omni versi 15.5.3 dan 15.5.4. Jika Anda menggunakan salah satu versi AlloyDB Omni ini, Anda mungkin menerima error yang serupa dengan berikut:

Error from server (Forbidden): error when creating "[...]/dbcluster.yaml": admission webhook "vdbcluster.alloydbomni.dbadmin.goog" denied the request: unsupported database version 15.5.3

Sebelum memulai

Sebelum menginstal AlloyDB Omni di cluster Kubernetes dengan operator AlloyDB Omni, pastikan Anda memenuhi persyaratan berikut.

Memilih opsi download atau penginstalan

Saat mengelola workload di cluster Kubernetes generik, Anda dapat menggunakan Helm atau OLM. Helm adalah pengelola paket universal yang menggunakan diagram Helm untuk menginstal workload apa pun, termasuk operator, di semua varian Kubernetes. OLM—pilihan standar dan pilihan yang lebih disukai di platform OpenShift— mengelola siklus proses operator dengan paket OLM khusus.

Berdasarkan lingkungan dan alat Anda, pilih salah satu metode deployment berikut:

Media Lokasi download dan panduan penginstalan Deployment ke
Operator AlloyDB Omni dengan Helm Chart Menginstal AlloyDB Omni di Kubernetes Lingkungan container Kubernetes Anda sendiri—misalnya, di infrastruktur lokal, cloud publik, GKE, Amazon EKS, dan Azure AKS.

Tips: Jika alat CD (continuous delivery) Anda terintegrasi dengan Helm, gunakan opsi ini.
Operator AlloyDB Omni dengan paket OLM OperatorHub.io Bawa lingkungan penampung Kubernetes Anda sendiri—misalnya, di lokasi, cloud publik, Google Kubernetes Engine, Amazon EKS, dan Azure AKS.

Untuk menggunakan paket OLM, instal OLM di cluster Kubernetes sebelum Anda menginstal operator. Untuk mengetahui informasi selengkapnya, lihat olm.operatorframework.io.

Tips: Jika alat CD (continuous delivery) Anda sudah menggunakan OLM, pilih opsi ini.
Operator OpenShift dengan Paket OLM Konsol Web Openshift Container Platform Lingkungan OpenShift

OpenShift, varian Kubernetes, menggunakan OLM sebagai metode standar bawaannya untuk mengemas dan men-deploy operator.

Memverifikasi akses

Pastikan Anda memiliki akses ke hal berikut:

Memenuhi persyaratan hardware dan software

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 (cgroup) v2 diaktifkan.

Menginstal operator AlloyDB Omni

Anda dapat menginstal operator AlloyDB Omni menggunakan berbagai metode, termasuk Helm dan Operator Lifecycle Manager (OLM).

Helm

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

  1. Tentukan variabel lingkungan berikut: 
    export HELM_PATH=$(curl https://storage.googleapis.com/alloydb-omni-operator/latest)
export OPERATOR_VERSION="${HELM_PATH%%/*}"
  2. Download operator AlloyDB Omni: 
    curl -X GET -o "./alloydbomni-operator-${OPERATOR_VERSION}.tgz" "https://storage.googleapis.com/storage/v1/b/alloydb-omni-operator/o/$(echo ${HELM_PATH} | sed 's/\//%2F/g')?alt=media"
  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. Untuk membersihkan, hapus file penginstalan operator AlloyDB Omni yang didownload. File ini diberi nama alloydbomni-operator-VERSION_NUMBER.tgz, dan terletak di direktori kerja Anda saat ini.

OLM

Untuk menginstal operator AlloyDB Omni menggunakan Operator Lifecycle Manager, ikuti langkah-langkah berikut:

  1. Buka halaman AlloyDB Omni Operator.

  2. Klik Instal. Jika Anda belum melakukannya, ikuti petunjuk untuk menginstal hanya operator OLM dan katalog OperatorHub.io.

  3. Buat namespace alloydb-omni-system jika belum ada.

    kubectl create ns alloydb-omni-system

  4. Siapkan OLM OperatorGroup untuk memastikan operator memiliki cakupan cluster.

    kubectl apply -f - <<EOF
apiVersion: operators.coreos.com/v1
kind: OperatorGroup
metadata:
  name: operator-sdk-og
  namespace: alloydb-omni-system
spec:
  upgradeStrategy: Default
EOF

  5. Instal operator menggunakan resource Langganan OLM.

    kubectl apply -f - <<EOF
apiVersion: operators.coreos.com/v1alpha1
kind: Subscription
metadata:
  name: my-alloydb-omni-operator
  namespace: alloydb-omni-system
spec:
  channel: stable
  name: alloydb-omni-operator
  source: operatorhubio-catalog
  sourceNamespace: olm
EOF

  6. Instal sertifikat default ClusterIssuer. Langkah ini bersifat opsional jika Anda menggunakan penerbit sertifikat kustom.

    kubectl apply -f - <<EOF
apiVersion: cert-manager.io/v1
kind: ClusterIssuer
metadata:
  name: alloydbomni-selfsigned-cluster-issuer
spec:
  selfSigned: {}
EOF

OLM

Untuk menginstal operator AlloyDB Omni di lingkungan Red Hat OpenShift menggunakan OLM, login ke konsol web Red Hat OpenShift.

  1. Pilih Operators > OperatorHub.

  2. Temukan operator AlloyDB Omni menggunakan kolom penelusuran.

  3. Di panel operator AlloyDB Omni, klik Install.

  4. Instal sertifikat default ClusterIssuer. Langkah ini bersifat opsional jika Anda menggunakan penerbit sertifikat kustom.

    kubectl apply -f - <<EOF
apiVersion: cert-manager.io/v1
kind: ClusterIssuer
metadata:
  name: alloydbomni-selfsigned-cluster-issuer
spec:
  selfSigned: {}
EOF

Mengonfigurasi penyimpanan yang terhubung GDC

Untuk menginstal operator AlloyDB Omni di GDC yang terhubung, Anda harus mengikuti langkah-langkah tambahan untuk mengonfigurasi penyimpanan karena cluster yang terhubung ke GDC tidak menetapkan class penyimpanan default. Anda harus menyetel class penyimpanan default sebelum membuat cluster database AlloyDB Omni.

Untuk mempelajari cara menetapkan Symcloud Storage sebagai kelas penyimpanan default, lihat Menetapkan Symcloud Storage sebagai kelas penyimpanan default.

Untuk mengetahui informasi selengkapnya tentang cara mengubah default untuk semua kelas penyimpanan lainnya, lihat Mengubah StorageClass default.

Membuat cluster database

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

Untuk membuat cluster database AlloyDB Omni, ikuti langkah-langkah berikut:

  1. Buat namespace khusus untuk cluster database Anda. Hal ini meningkatkan isolasi dan keamanan.

    kubectl create namespace DB_CLUSTER_NAMESPACE

    Ganti DB_CLUSTER_NAMESPACE dengan namespace tempat Anda ingin membuat cluster database—misalnya, my-db-cluster-namespace.

  2. Buat file manifes bernama db-cluster.yaml dengan konten berikut. Manifes ini menentukan rahasia untuk sandi database dan resource DBCluster itu sendiri.

    apiVersion: v1
kind: Secret
metadata:
  name: db-pw-DB_CLUSTER_NAME
  namespace: DB_CLUSTER_NAMESPACE
type: Opaque
data:
  DB_CLUSTER_NAME: "ENCODED_PASSWORD"
---
apiVersion: alloydbomni.dbadmin.goog/v1
kind: DBCluster
metadata:
  name: DB_CLUSTER_NAME
  namespace: DB_CLUSTER_NAMESPACE
spec:
  databaseVersion: "15.13.0"
  # Optional: Specify the base OS type for the database image.
  # Valid values are "Debian" and "UBI9".
  # If not specified, the operator defaults to "Debian" for databaseVersion < 16.9.0
  # and "UBI9" for databaseVersion 16.9.0 or later.
  # databaseImageOSType: "OS_TYPE"
  primarySpec:
    adminUser:
      passwordRef:
        name: db-pw-DB_CLUSTER_NAME
    resources:
      cpu: CPU_COUNT
      memory: MEMORY_SIZE
      disks:
      - name: DataDisk
        size: DISK_SIZE

    Ganti kode berikut:

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

    • OS_TYPE: Opsional. Jenis sistem operasi dasar untuk image database. Nilai yang valid adalah Debian dan UBI9. Jika Anda tidak menentukannya, operator akan otomatis menyetelnya ke Debian jika databaseVersion kurang dari 16.9.0, dan ke UBI9 jika databaseVersion adalah 16.9.0 atau yang lebih baru.

    • 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.

  3. Terapkan manifes ke cluster Kubernetes Anda:

    kubectl apply -f db-cluster.yaml

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