Installa AlloyDB Omni su Kubernetes

Seleziona una versione della documentazione:

Questa pagina fornisce una panoramica di AlloyDB Omni Kubernetes Operator, con istruzioni per utilizzarlo per eseguire il deployment di AlloyDB Omni su un cluster Kubernetes. Questa pagina presuppone una conoscenza di base del funzionamento di Kubernetes.

Per istruzioni sull'installazione di AlloyDB Omni in un ambiente Linux standard, vedi Installare AlloyDB Omni.

Panoramica

Per eseguire il deployment di AlloyDB Omni su un cluster Kubernetes, installa AlloyDB Omni Operator, un'estensione dell'API Kubernetes fornita da Google.

Configura e controlla un cluster di database AlloyDB Omni basato su Kubernetes associando i file manifest dichiarativi all'utilità kubectl, proprio come qualsiasi altro deployment basato su Kubernetes.

Prima di iniziare

Devi avere accesso a quanto segue:

  • Un cluster Kubernetes che esegue il seguente software:

  • L'kubectl utilità.

  • Il gestore di pacchetti helm.

  • Google Cloud CLI.

    Se devi installare gcloud CLI, tieni presente che il passaggio di esecuzione di gcloud init è facoltativo. L'installazione di AlloyDB Omni non richiede l'autenticazione con un Account Google.

Ogni nodo del cluster Kubernetes deve avere quanto segue:

  • Un minimo di due CPU x86 o AMD64.
  • Almeno 8 GB di RAM.
  • Versione kernel Linux 4.18 o successive.
  • Gruppo di controllo v2 (cgroup v2) abilitato.

Utilizzare i grafici Helm

Puoi utilizzare i grafici Helm dal repository alloydb-omni-samples per eseguire il deployment dei componenti mostrati in questa guida.

Installare AlloyDB Omni Operator

Per installare AlloyDB Omni Operator:

  1. Definisci diverse variabili di ambiente:

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

  2. Scarica AlloyDB Omni Operator:

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

  3. Installa 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

    L'installazione riuscita mostra il seguente output:

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

  4. Libera spazio eliminando il file di installazione di AlloyDB Omni Operator scaricato. Il file si chiama alloydbomni-operator-VERSION_NUMBER.tgz e si trova in nella directory di lavoro corrente.

Creare un cluster di database

Un cluster di database AlloyDB Omni contiene tutte le risorse di archiviazione e di calcolo necessarie per eseguire un server AlloyDB Omni, inclusi il server principale, le repliche e tutti i dati.

Dopo aver installato AlloyDB Omni Operator sul cluster Kubernetes, puoi creare un cluster di database AlloyDB Omni sul cluster Kubernetes applicando un manifest simile al seguente:

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

Sostituisci quanto segue:

  • DB_CLUSTER_NAME: il nome di questo cluster di database, ad esempio my-db-cluster.

  • ENCODED_PASSWORD: la password di accesso al database per il ruolo utente postgres predefinito, codificata come stringa base64, ad esempio Q2hhbmdlTWUxMjM= per ChangeMe123.

  • CPU_COUNT: il numero di CPU disponibili per ogni istanza di database in questo cluster di database.

  • MEMORY_SIZE: la quantità di memoria per istanza di database di questo cluster di database. Ti consigliamo di impostare questo valore su 8 gigabyte per CPU. Ad esempio, se in precedenza in questo manifest hai impostato cpu su 2, ti consigliamo di impostare memory su 16Gi.

  • DISK_SIZE: le dimensioni del disco per istanza di database, ad esempio 10Gi.

Dopo aver applicato questo manifest, il cluster Kubernetes contiene un cluster di database AlloyDB Omni con la configurazione di memoria, CPU e spazio di archiviazione specificata. Per stabilire una connessione di test con il nuovo cluster di database, vedi Connettersi utilizzando psql.

Per ulteriori informazioni sui manifest Kubernetes e su come applicarli, vedi Gestire le risorse.

Passaggi successivi