Menginstal AlloyDB Omni

Instal dan jalankan AlloyDB Omni di software Google Distributed Cloud khusus untuk cluster bare metal.

Ringkasan

Software Google Distributed Cloud khusus untuk bare metal telah menyelesaikan kualifikasi partner untuk AlloyDB Omni (dimulai dengan Operator AlloyDB Omni versi 1.7.0).

AlloyDB Omni adalah paket software database yang dapat didownload dan:

  • Memungkinkan Anda men-deploy versi AlloyDB untuk PostgreSQL yang disederhanakan.
  • Menawarkan kompatibilitas penuh PostgreSQL.
  • Memberikan throughput tinggi pada workload transaksional.
  • Menawarkan akselerasi columnar engine untuk workload analisis.
  • Menawarkan dukungan bawaan untuk workload AI generatif dan penelusuran vektor dengan AlloyDB AI.

Deploy dan kelola AlloyDB Omni di cluster bare metal Anda menggunakan Operator Kubernetes AlloyDB Omni.

Sebelum memulai

Sebelum menginstal AlloyDB Omni, Anda harus memiliki hal berikut:

  • Cluster Google Distributed Cloud khusus software untuk bare metal yang menjalankan Kubernetes versi 1.21 atau yang lebih baru.
  • Alat command line kubectl yang dikonfigurasi untuk berkomunikasi dengan cluster Anda.
  • Pengelola paket helm (versi 3 atau yang lebih baru) yang diinstal di workstation admin Anda.
  • StorageClass default yang dikonfigurasi di cluster bare metal Anda untuk penyediaan volume dinamis. Untuk mengetahui informasi selengkapnya, lihat Ringkasan penyimpanan.
  • Node di cluster Anda yang memenuhi persyaratan resource minimum untuk AlloyDB Omni:
    • Minimal 2 CPU per instance database.
    • RAM minimal 8 GB per CPU (misalnya, 16 GB untuk 2 CPU).
    • Linux kernel 4.18 atau yang lebih baru dengan grup kontrol (cgroup) v2 diaktifkan.

Menginstal cert-manager

Operator AlloyDB Omni memerlukan cert-manager untuk mengelola sertifikat TLS untuk webhook penerimaannya.

  1. Jika cert-manager belum diinstal di cluster Anda, instal menggunakan Helm: sh helm repo add jetstack https://charts.jetstack.io helm repo update helm install cert-manager jetstack/cert-manager \ --namespace cert-manager \ --create-namespace \ --version v1.16.0 \ --set crds.enabled=true \ --kubeconfig KUBECONFIG

  2. Ganti KUBECONFIG dengan jalur file kubeconfig cluster Anda.

  3. Pastikan Pod cert-manager sedang berjalan: sh kubectl get pods -n cert-manager --kubeconfig KUBECONFIG

    Menginstal Operator AlloyDB Omni

Untuk menginstal Operator Kubernetes AlloyDB Omni dari registry OCI menggunakan Helm, lakukan hal berikut:

  1. Instal diagram Helm operator:

    helm install alloydbomni-operator oci://gcr.io/alloydb-omni/alloydbomni-operator \
        --version OPERATOR_VERSION \
        --create-namespace \
        --namespace alloydb-omni-system \
        $(helm install --help | grep -q -- '--rollback-on-failure' && echo '--rollback-on-failure' || echo '--atomic') \
        --timeout 5m \
        --kubeconfig KUBECONFIG
    

    Ganti kode berikut:

    • OPERATOR_VERSION: versi Operator AlloyDB Omni yang akan diinstal (misalnya, 1.8.0 atau yang lebih baru).
    • KUBECONFIG: jalur file kubeconfig cluster Anda.
  2. Pastikan Pod operator sedang berjalan:

    kubectl get pods -n alloydb-omni-system --kubeconfig KUBECONFIG
    

    Outputnya mirip dengan hal berikut ini:

    NAME                                        READY   STATUS    RESTARTS   AGE
    fleet-controller-manager-796c698cd7-x2vsr   1/1     Running   0          22h
    local-controller-manager-76f6c98446-rzpsc   1/1     Running   0          22h
    

Membuat cluster AlloyDB Omni

Setelah operator berjalan, buat cluster database AlloyDB Omni dengan membuat Secret sandi dan menerapkan resource kustom DBCluster.

  1. Buat namespace untuk workload database Anda:

    kubectl create namespace my-db-ns --kubeconfig KUBECONFIG
    
  2. Buat Secret Kubernetes yang berisi sandi login administrator database untuk pengguna postgres default:

    kubectl create secret generic db-pw-my-db-cluster \
        --namespace my-db-ns \
        --from-literal=my-db-cluster=PASSWORD \
        --kubeconfig KUBECONFIG
    

    Ganti PASSWORD dengan sandi yang aman.

  3. Buat manifes bernama db-cluster.yaml:

    apiVersion: alloydbomni.dbadmin.goog/v1
    kind: DBCluster
    metadata:
      name: my-db-cluster
      namespace: my-db-ns
    spec:
      databaseVersion: "18.3.0"
      primarySpec:
        adminUser:
          passwordRef:
            name: db-pw-my-db-cluster
        resources:
          cpu: 2
          memory: 16Gi
          disks:
          - name: DataDisk
            size: 20Gi
    
  4. Terapkan manifes:

    kubectl apply -f db-cluster.yaml --kubeconfig KUBECONFIG
    
  5. Pastikan cluster database mencapai status Ready:

    kubectl get dbclusters -n my-db-ns --kubeconfig KUBECONFIG
    

    Outputnya mirip dengan hal berikut ini:

    NAME            PRIMARY             PRIMARYSTATUS   STANDBY   STANDBYSTATUS   STATUS
    my-db-cluster   my-db-cluster-0     Ready                                     Ready
    

Langkah berikutnya