在 Kubernetes 上安裝 AlloyDB Omni

選取文件版本：

本頁面提供 AlloyDB Omni Kubernetes Operator 的總覽，並說明如何使用該工具將 AlloyDB Omni 部署至 Kubernetes 叢集。本頁面假設您已熟悉 Kubernetes 作業。

如需在標準 Linux 環境中安裝 AlloyDB Omni 的操作說明，請參閱「安裝 AlloyDB Omni」。

總覽

如要將 AlloyDB Omni 部署至 Kubernetes 叢集，請安裝 AlloyDB Omni Operator，這是 Google 提供的 Kubernetes API 擴充功能。

您可以將宣告式資訊清單檔案與 kubectl 公用程式搭配使用，設定及控管以 Kubernetes 為基礎的 AlloyDB Omni 資料庫叢集，就像任何其他以 Kubernetes 為基礎的部署作業一樣。

事前準備

您必須具備下列項目的存取權：

  • 執行下列軟體的 Kubernetes 叢集：

  • kubectl 公用程式。

  • helm 套件管理工具。

  • Google Cloud CLI。

    如果確實需要安裝 gcloud CLI，請注意，執行 gcloud init 的步驟為選用。安裝 AlloyDB Omni 時，不需要使用 Google 帳戶進行驗證。

Kubernetes 叢集中的每個節點都必須具備下列項目：

  • 至少兩個 x86 或 AMD64 CPU。
  • 至少 8 GB 的 RAM。
  • Linux 核心 4.18 以上版本。
  • 已啟用控制群組第 2 版 (cgroup v2)。

使用 Helm 資訊套件

您可以使用存放區 alloydb-omni-samples 中的 Helm 資訊套件，部署本指南中顯示的元件。

安裝 AlloyDB Omni Operator

如要安裝 AlloyDB Omni Operator，請按照下列步驟操作：

  1. 定義多個環境變數：

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

  2. 下載 AlloyDB Omni 運算子：

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

  3. 安裝 AlloyDB Omni Operator：

    helm install alloydbomni-operator alloydbomni-operator-${OPERATOR_VERSION}.tgz \
--create-namespace \
--namespace alloydb-omni-system \
$(helm install --help | grep -q -- '--rollback-on-failure' && echo '--rollback-on-failure' || echo '--atomic') \
--timeout 5m

    安裝成功後，系統會顯示以下輸出內容：

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

  4. 清理下載的 AlloyDB Omni Operator 安裝檔案。檔案名稱為 alloydbomni-operator-VERSION_NUMBER.tgz，位於目前的工作目錄中。

建立資料庫叢集

AlloyDB Omni 資料庫叢集包含執行 AlloyDB Omni 伺服器所需的所有儲存空間和運算資源，包括主要伺服器、任何副本和所有資料。

在 Kubernetes 叢集上安裝 AlloyDB Omni Operator 後，您可以套用類似下列資訊清單的內容，在 Kubernetes 叢集上建立 AlloyDB Omni 資料庫叢集：

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

更改下列內容：

  • DB_CLUSTER_NAME：這個資料庫叢集的名稱，例如 my-db-cluster。

  • ENCODED_PASSWORD：預設 postgres 使用者角色的資料庫登入密碼，以 Base64 字串編碼，例如 ChangeMe123 的 Q2hhbmdlTWUxMjM=。

  • CPU_COUNT：這個資料庫叢集中，每個資料庫執行個體可用的 CPU 數量。

  • MEMORY_SIZE：這個資料庫叢集中，每個資料庫執行個體的記憶體數量。建議您將每個 CPU 的記憶體設為 8 GB。舉例來說，如果您在這個資訊清單中將 cpu 設為 2，建議將 memory 設為 16Gi。

  • DISK_SIZE：每個資料庫執行個體的磁碟大小，例如 10Gi。

套用這個資訊清單後，Kubernetes 叢集就會包含 AlloyDB Omni 資料庫叢集，並具有指定的記憶體、CPU 和儲存空間設定。如要與新資料庫叢集建立測試連線，請參閱「使用預先安裝的 psql 連線」。

如要進一步瞭解 Kubernetes 資訊清單及套用方式，請參閱「管理資源」。

後續步驟