Menginstal AlloyDB Omni menggunakan orkestrator container

Pilih versi dokumentasi:

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

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

Ringkasan

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

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

Image dasar

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

Referensi image hash SHA

Untuk mencegah serangan rantai pasokan dan memenuhi persyaratan Sertifikasi OpenShift, operator AlloyDB Omni menggunakan hash SHA-256, bukan tag versi untuk semua referensi image container.

  • Upgrade Otomatis: operator AlloyDB Omni menggunakan ImageCatalog internal untuk mengelola hash ini dan memastikan rollback data plane yang andal selama upgrade gagal.

  • Pengaktifan: meskipun diaktifkan secara default untuk paket Bersertifikasi OpenShift, pengguna paket OLM atau Helm dapat mengaktifkan referensi hash secara manual dengan menetapkan variabel lingkungan ENABLE_DIGEST_IMAGE_REFS ke true menggunakan konfigurasi Langganan untuk OLM atau nilai enableDigestImageRefs dalam diagram Helm.

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 Diagram Helm Menginstal AlloyDB Omni di Kubernetes Lingkungan container Kubernetes Anda sendiri—misalnya, 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 Lingkungan container Kubernetes Anda sendiri—misalnya, lokal, cloud publik, Google Kubernetes Engine, Amazon EKS, dan Azure AKS.

Untuk menggunakan paket OLM, instal OLM di cluster Kubernetes sebelum 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 bawaan 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. Instal operator AlloyDB Omni dari registry OCI: 
    helm install alloydbomni-operator oci://gcr.io/alloydb-omni/alloydbomni-operator \
--version 1.7.0 \
--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

OLM

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

  1. Buka halaman AlloyDB Omni Operator.

  2. Klik Install. 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 OperatorGroup OLM 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 ClusterIssuer sertifikat default. 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, ikuti langkah-langkah berikut:

  1. Login ke konsol web Red Hat OpenShift.
  2. Untuk pengguna offline atau yang tidak terhubung, Anda harus mencerminkan image yang diperlukan secara manual ke registry pribadi menggunakan alat yang mempertahankan hash SHA, seperti oc image mirror. Anda harus mengonfigurasi ImageDigestMirrorSet untuk mengalihkan permintaan image dari repositori gcr.io publik ke registry pribadi Anda. Hal ini memastikan bahwa operator AlloyDB Omni dapat mengambil image yang diperlukan menggunakan hash SHA256 yang tidak dapat diubah.

  3. Di konsol web OpenShift, buka Operators > OperatorHub. AlloyDB Omni Operator tercantum dalam katalog Certified dan Community.

  4. Di panel operator AlloyDB Omni, klik Install.

  5. Instal ClusterIssuer sertifikat default. 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 terhubung GDC

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

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

Untuk mengetahui informasi selengkapnya tentang cara mengubah default untuk semua class 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 akan 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: "17.7.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 menetapkannya 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 di cluster database ini.

    • MEMORY_SIZE: jumlah memori per instance database dari cluster database ini. Sebaiknya tetapkan nilai 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 yang telah diinstal psql.

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

Langkah berikutnya