Installa AlloyDB Omni su Kubernetes

Seleziona una versione della documentazione: 16.3.0

• Attuale (16.8.0)
• 16.8.0
• 16.3.0
• 15.12.0
• 15.7.1
• 15.7.0
• 15.5.5
• 15.5.4
• 15.5.2

Questa pagina fornisce una panoramica dell'operatore AlloyDB Omni Kubernetes, con istruzioni per utilizzarlo per eseguire il deployment di AlloyDB Omni in 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, consulta Installare AlloyDB Omni.

Panoramica

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

Configuri e controlli un cluster di database AlloyDB Omni basato su Kubernetes accoppiando file manifest dichiarativi con l'utilità kubectl, proprio come qualsiasi altro deployment basato su Kubernetes. Non utilizzi la CLI AlloyDB Omni, che è pensata per i deployment su singole macchine Linux e non su cluster Kubernetes.

Immagine di base

A partire dalla versione 1.5.0, le immagini Kubernetes dell'operatore AlloyDB Omni sono basate su Universal Base Image (UBI) 9 di Red Hat. Questa transizione migliora la sicurezza, la coerenza e la conformità delle tue implementazioni.

Compatibilità con l'operatore AlloyDB Omni 1.1.0 (e versioni successive)

La versione 1.1.0 dell'operatore AlloyDB Omni non è compatibile con le versioni 15.5.3 e 15.5.4 di AlloyDB Omni. Se utilizzi una di queste versioni di AlloyDB Omni, potresti ricevere un errore simile al seguente:

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

Nota :per eseguire il deployment di AlloyDB Omni su un cluster Kubernetes con l'operatore AlloyDB Omni 1.1.0, utilizza AlloyDB Omni versione 15.5.5 o successive.

Prima di iniziare

Prima di installare AlloyDB Omni su un cluster Kubernetes con l'operatore AlloyDB Omni, assicurati di soddisfare i seguenti requisiti.

Scegliere un'opzione di download o installazione

Scegli una delle seguenti opzioni di download e installazione:

Media	Percorsi di download e guide all'installazione	Deployment in
Operatore OpenShift con bundle OLM	Console web Openshift Container Platform	Ambiente OpenShift
Operatore Kubernetes con bundle OLM	Artifacthub.io	Ambiente container Kubernetes Bring Your Own, ad esempio on-premise, cloud pubblici, Google Kubernetes Engine, Amazon EKS e Azure AKS.
Operatore Kubernetes con grafico Helm	Installa AlloyDB Omni su Kubernetes (questa pagina)	Ambiente container Kubernetes Bring Your Own, ad esempio on-premise, cloud pubblici, GKE, Amazon EKS e Azure AKS.

Verifica l'accesso

Verifica di avere accesso a quanto segue:

• Un cluster Kubernetes che esegue il seguente software:
  • Kubernetes versione 1.21 o successiva.
  • Il servizio cert-manager.
• L'utilità kubectl.
• Il gestore di pacchetti helm o Operator Lifecycle Manager.
• Google Cloud CLI. Dopo aver installato gcloud CLI, devi autenticare il tuo account Google Cloud eseguendo gcloud auth login.

Soddisfare i requisiti hardware e software

Ogni nodo nel cluster Kubernetes deve avere quanto segue:

• Almeno due CPU x86 o AMD64.
• Almeno 8 GB di RAM.
• Versione del kernel Linux 4.18 o successive.
• Control group (cgroup) v2 attivato.

Installa l'operatore AlloyDB Omni

Nota: se vuoi eseguire il deployment di AlloyDB Omni nel tuo ambiente di produzione, consulta Eseguire AlloyDB Omni in produzione.

Puoi installare l'operatore AlloyDB Omni utilizzando diversi metodi, tra cui Helm e Operator Lifecycle Manager (OLM).

Helm

Per installare l'operatore AlloyDB Omni:

1. Definisci le seguenti 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 l'operatore AlloyDB Omni:

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

3. Installa l'operatore AlloyDB Omni:

   helm install alloydbomni-operator alloydbomni-operator-${OPERATOR_VERSION}.tgz \
   --create-namespace \
   --namespace alloydb-omni-system \
   --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. Per fare pulizia, elimina il file di installazione dell'operatore AlloyDB Omni scaricato. Il file è denominato alloydbomni-operator-VERSION_NUMBER.tgz e si trova nella directory di lavoro attuale.

OLM

Per installare l'operatore AlloyDB Omni utilizzando Operator Lifecycle Manager:

1. Vai alla pagina https://operatorhub.io/operator/alloydb-omni-operator.

2. Fai clic sul pulsante Installa per visualizzare le istruzioni.

3. Completa tutti i passaggi di installazione.

4. Dopo aver installato l'operatore AlloyDB Omni, crea manualmente le risorse cert-manager nel cluster. Questo è un requisito. Utilizza questi comandi:

   kubectl create ns ${NAMESPACE:?}
   kubectl apply -f - <<EOF
   apiVersion: cert-manager.io/v1
   kind: ClusterIssuer
   metadata:
     name: alloydbomni-selfsigned-cluster-issuer
   spec:
     selfSigned: {}
   ---
   apiVersion: cert-manager.io/v1
   kind: Issuer
   metadata:
     name: fleet-selfsigned-issuer
     namespace: ${NAMESPACE:?}
   spec:
     selfSigned: {}
   ---
   apiVersion: cert-manager.io/v1
   kind: Certificate
   metadata:
     name: fleet-serving-cert
     namespace: ${NAMESPACE:?}
   spec:
     dnsNames:
     - fleet-webhook-service.alloydb-omni-system.svc
     - fleet-webhook-service.alloydb-omni-system.svc.cluster.local
     issuerRef:
       kind: Issuer
       name: fleet-selfsigned-issuer
     secretName: fleet-webhook-server-cert
   ---
   apiVersion: cert-manager.io/v1
   kind: Issuer
   metadata:
     name: local-selfsigned-issuer
     namespace: ${NAMESPACE:?}
   spec:
     selfSigned: {}
   ---
   apiVersion: cert-manager.io/v1
   kind: Certificate
   metadata:
     name: local-serving-cert
     namespace: ${NAMESPACE:?}
   spec:
     dnsNames:
     - local-webhook-service.alloydb-omni-system.svc
     - local-webhook-service.alloydb-omni-system.svc.cluster.local
     issuerRef:
       kind: Issuer
       name: local-selfsigned-issuer
     secretName: local-webhook-server-cert
   EOF

   Sostituisci NAMESPACE con lo spazio dei nomi in cui si trova l'operatore, ad esempio alloydb-omni-system.

OLM

Nota:devi attivare community-operators CatalogSource perché l'operatore AlloyDB Omni è disponibile solo come operatore della community. La documentazione di Red Hat indica che, se necessario, puoi disattivare il catalogo della community.

Per installare l'operatore AlloyDB Omni nel tuo ambiente Red Hat OpenShift utilizzando OLM, accedi alla console web di Red Hat OpenShift.

1. Seleziona Operatori > OperatorHub.

2. Trova l'operatore AlloyDB Omni utilizzando il campo di ricerca.

   
   Figura 1: l'operatore AlloyDB Omni in OperatorHub

3. Nel riquadro dell'operatore AlloyDB Omni, fai clic su Installa.

   
   Figura 2: il riquadro dell'operatore AlloyDB Omni

4. Dopo aver installato l'operatore AlloyDB Omni, crea manualmente le risorse cert-manager nel cluster. Questo è un requisito. Utilizza questi comandi:

   kubectl create ns ${NAMESPACE:?}
   kubectl apply -f - <<EOF
   apiVersion: cert-manager.io/v1
   kind: ClusterIssuer
   metadata:
     name: alloydbomni-selfsigned-cluster-issuer
   spec:
     selfSigned: {}
   ---
   apiVersion: cert-manager.io/v1
   kind: Issuer
   metadata:
     name: fleet-selfsigned-issuer
     namespace: ${NAMESPACE:?}
   spec:
     selfSigned: {}
   ---
   apiVersion: cert-manager.io/v1
   kind: Certificate
   metadata:
     name: fleet-serving-cert
     namespace: ${NAMESPACE:?}
   spec:
     dnsNames:
     - fleet-webhook-service.alloydb-omni-system.svc
     - fleet-webhook-service.alloydb-omni-system.svc.cluster.local
     issuerRef:
       kind: Issuer
       name: fleet-selfsigned-issuer
     secretName: fleet-webhook-server-cert
   ---
   apiVersion: cert-manager.io/v1
   kind: Issuer
   metadata:
     name: local-selfsigned-issuer
     namespace: ${NAMESPACE:?}
   spec:
     selfSigned: {}
   ---
   apiVersion: cert-manager.io/v1
   kind: Certificate
   metadata:
     name: local-serving-cert
     namespace: ${NAMESPACE:?}
   spec:
     dnsNames:
     - local-webhook-service.alloydb-omni-system.svc
     - local-webhook-service.alloydb-omni-system.svc.cluster.local
     issuerRef:
       kind: Issuer
       name: local-selfsigned-issuer
     secretName: local-webhook-server-cert
   EOF

   Sostituisci NAMESPACE con lo spazio dei nomi in cui si trova l'operatore, ad esempio alloydb-omni-system.

Configura lo spazio di archiviazione GDC connesso

Per installare l'operatore AlloyDB Omni su GDC connesso, devi seguire passaggi aggiuntivi per configurare lo spazio di archiviazione perché i cluster GDC connessi non impostano una classe di archiviazione predefinita. Devi impostare una classe di archiviazione predefinita prima di creare un cluster di database AlloyDB Omni.

Per scoprire come impostare Symcloud Storage come classe di archiviazione predefinita, vedi Impostare Symcloud Storage come classe di archiviazione predefinita.

Per ulteriori informazioni sulla modifica del valore predefinito per tutte le altre classi di archiviazione, vedi Modificare la StorageClass predefinita.

Crea un cluster di database

Nota :ti consigliamo di creare cluster di database in uno spazio dei nomi diverso da alloydb-omni-system, lo spazio dei nomi dell'operatore AlloyDB Omni. L'utilizzo di questo spazio dei nomi migliora l'isolamento e la sicurezza e previene i conflitti tra l'operatore, le risorse che gestisce e i componenti utente nello stesso cluster Kubernetes. Per ulteriori informazioni, consulta il white paper sugli operatori della Cloud Native Computing Foundation.

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 eventuali repliche e tutti i tuoi dati.

Dopo aver installato l'operatore AlloyDB Omni 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
  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: "16.3.0"
  primarySpec:
    adminUser:
      passwordRef:
        name: db-pw-DB_CLUSTER_NAME
    resources:
      cpu: CPU_COUNT
      memory: MEMORY_SIZE
      disks:
      - name: DataDisk
        size: DISK_SIZE

Sostituisci quanto segue:

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

• DB_CLUSTER_NAMESPACE (facoltativo): lo spazio dei nomi in cui vuoi creare il cluster di database, ad esempio my-db-cluster-namespace.

• 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 hai impostato cpu su 2 in precedenza in questo manifest, 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, consulta Connessione tramite psql preinstallato.

Nota :a partire dalla versione 1.1.0 dell'operatore AlloyDB Omni, il secret della password di amministratore non viene più eliminato dopo l'impostazione. Devi conservare il segreto appena impostato per l'intero ciclo di vita del cluster di database AlloyDB Omni.

Per ulteriori informazioni sui manifest di Kubernetes e su come applicarli, consulta Gestione delle risorse.

Passaggi successivi

• Esegui e connettiti ad AlloyDB Omni
• Gestire AlloyDB Omni
• Gestire l'alta disponibilità in Kubernetes