Installer AlloyDB Omni

Installez et exécutez AlloyDB Omni sur des clusters Google Distributed Cloud (logiciel uniquement) pour Bare Metal.

Présentation

Google Distributed Cloud pour Bare Metal a terminé la qualification des partenaires pour AlloyDB Omni (à partir de la version 1.7.0 de l'opérateur AlloyDB Omni).

AlloyDB Omni est un package logiciel de base de données téléchargeable qui :

  • Vous permet de déployer une version simplifiée d'AlloyDB pour PostgreSQL.
  • Offre une compatibilité totale avec PostgreSQL.
  • Offre un débit élevé pour les charges de travail transactionnelles.
  • Offre une accélération du moteur de données en colonnes pour les charges de travail analytiques.
  • Offre une prise en charge intégrée des charges de travail d'IA générative et de recherche vectorielle avec AlloyDB AI.

Déployez et gérez AlloyDB Omni sur vos clusters bare metal à l'aide de l'opérateur Kubernetes AlloyDB Omni.

Avant de commencer

Avant d'installer AlloyDB Omni, vous devez disposer des éléments suivants :

  • Un cluster Google Distributed Cloud Bare Metal exécutant Kubernetes version 1.21 ou ultérieure.
  • L'outil de ligne de commande kubectl configuré pour communiquer avec votre cluster.
  • Le gestionnaire de packages helm (version 3 ou ultérieure) installé sur votre poste de travail administrateur.
  • Une StorageClass par défaut configurée sur votre cluster Bare Metal pour le provisionnement dynamique de volumes. Pour en savoir plus, consultez Présentation du stockage.
  • Nœuds de votre cluster qui répondent aux exigences minimales en termes de ressources pour AlloyDB Omni :
    • Au moins deux processeurs par instance de base de données.
    • Au moins 8 Go de RAM par processeur (par exemple, 16 Go pour deux processeurs).
    • Kernel Linux 4.18 ou version ultérieure avec le groupe de contrôle (cgroup) v2 activé.

Installer cert-manager

L'opérateur AlloyDB Omni nécessite cert-manager pour gérer les certificats TLS de ses webhooks d'admission.

  1. Si cert-manager n'est pas déjà installé sur votre cluster, installez-le à l'aide de 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. Remplacez KUBECONFIG par le chemin d'accès du fichier kubeconfig de votre cluster.

  3. Vérifiez que les pods cert-manager sont en cours d'exécution : sh kubectl get pods -n cert-manager --kubeconfig KUBECONFIG

    Installer l'opérateur AlloyDB Omni

Pour installer l'opérateur Kubernetes AlloyDB Omni à partir du registre OCI à l'aide de Helm, procédez comme suit :

  1. Installez le chart Helm de l'opérateur :

    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

    Remplacez les éléments suivants :

    • OPERATOR_VERSION : version de l'opérateur AlloyDB Omni à installer (par exemple, 1.8.0 ou version ultérieure).
    • KUBECONFIG : chemin d'accès au fichier kubeconfig de votre cluster.

  2. Vérifiez que le pod de l'opérateur est en cours d'exécution :

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

    Le résultat ressemble à ce qui suit :

    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

Créer un cluster AlloyDB Omni

Une fois l'opérateur exécuté, créez un cluster de bases de données AlloyDB Omni en créant un secret de mot de passe et en appliquant une ressource personnalisée DBCluster.

  1. Créez un espace de noms pour vos charges de travail de base de données :

    kubectl create namespace my-db-ns --kubeconfig KUBECONFIG

  2. Créez un secret Kubernetes contenant le mot de passe de connexion de l'administrateur de base de données pour l'utilisateur postgres par défaut :

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

    Remplacez PASSWORD par un mot de passe sécurisé.

  3. Créez un fichier manifeste nommé 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. Appliquez le fichier manifeste :

    kubectl apply -f db-cluster.yaml --kubeconfig KUBECONFIG

  5. Vérifiez que le cluster de bases de données atteint l'état Ready :

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

    Le résultat ressemble à ce qui suit :

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

Étapes suivantes