Installer AlloyDB Omni

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

Présentation

Le logiciel Google Distributed Cloud pour solution Bare Metal a obtenu la qualification de partenaire 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 :

  • Permet de déployer une version simplifiée d'AlloyDB pour PostgreSQL.
  • Offre une compatibilité totale avec PostgreSQL.
  • Fournit un haut débit sur la charge de travail transactionnelle.
  • Offre une accélération du moteur de données en colonnes pour les charges de travail analytiques.
  • Offre une compatibilité intégrée avec les charges de travail d'IA générative et de recherche vectorielle grâce à 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 (logiciel uniquement) pour solution 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 des volumes. Pour en savoir plus, consultez Présentation du stockage.
  • Nœuds de votre cluster qui répondent aux exigences minimales 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 2 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 base de données passe à 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