Selon vos besoins d'automatisation, vous pouvez choisir entre deux interfaces d'orchestration :
- Interface CLI de l'outil d'orchestration AlloyDB Omni
alloydbctl: recommandée pour les environnements utilisant des scripts shell pour l'automatisation. - Collection Ansible de l'outil d'orchestration AlloyDB Omni : recommandée pour les environnements qui utilisent l'automatisation basée sur Ansible.
Limites
Les limites suivantes s'appliquent à cette version :
- Cette version n'est compatible qu'avec AlloyDB Omni PostgreSQL 18.
- Cette version n'est compatible qu'avec les packages logiciels compatibles avec RHEL version 9.
- Cette version n'est compatible qu'avec la plate-forme Intel x86 64 bits.
- Les mises à niveau de version majeure ne sont pas disponibles dans cette version.
- Cette version n'inclut pas d'instructions pour configurer la reprise après sinistre.
- Cette version n'inclut pas d'instructions pour configurer des instances de pool de lecture.
- Le moniteur AlloyDB Omni n'est pas compatible avec les connexions SSL. Vous devez déployer vos serveurs de tableau de bord de surveillance sur le même réseau privé que les nœuds AlloyDB Omni.
Avant de commencer
Avant de commencer le déploiement, assurez-vous de répondre aux exigences suivantes :
Obtenir des packages AlloyDB Omni
Les packages logiciels AlloyDB Omni avec l'outil d'orchestration RPM sont disponibles en preview. Vous devez vous inscrire à l'aide du formulaire d'inscription à la preview d'AlloyDB Omni avec l'outil d'orchestration RPM pour recevoir les fichiers RPM.
Si vous gérez des packages logiciels via un dépôt Yum privé, suivez les instructions de gestion de votre dépôt pour inclure les fichiers RPM dépendants dans le dépôt. Pour en savoir plus, consultez Dépendances des packages logiciels.
Configurer un dépôt de logiciels
Les RPM AlloyDB Omni sont conservés dans un dépôt Yum mondial. Si votre organisation gère des logiciels via un dépôt Yum privé, vous devez inclure les packages RPM fournis après l'inscription dans votre dépôt en fonction de vos outils de gestion. Vous aurez besoin de l'URL de votre dépôt privé lors du processus de déploiement.
Provisionner des machines
Provisionnez un ensemble de VM exécutant RHEL 9, y compris les éléments suivants :
- Contrôleur : 1 nœud qui orchestre le déploiement et dispose d'un accès SSH sans mot de passe à tous les autres nœuds.
- Base de données : 1 ou 3 nœuds qui exécutent les services de base et de surveillance AlloyDB Omni.
- Équilibreur de charge : 2 nœuds facultatifs qui exécutent HAProxy et des poolers de connexion facultatifs tels que PgBouncer.
Configurer le réseau et le pare-feu
Configurez votre pare-feu pour autoriser les ports TCP suivants en fonction de votre architecture :
| Port | Protocole | Nœud | Service | Trafic | Remarques |
|---|---|---|---|---|---|
| 5432 | TCP | Équilibreur de charge | HAProxy | Entrants | Sur le nœud de l'équilibreur de charge, le cas échéant |
| 6432 | TCP | Équilibreur de charge | PgBouncer | Entrants | Pooler de connexion, le cas échéant |
| 9187 | TCP | Base de données | Moniteur AlloyDB | Entrants | Moniteur, le cas échéant ; non compatible avec TLS |
| 5432 | TCP | Base de données | AlloyDB | Entrants | Architecture résiliente à trois nœuds |
| 6432 | TCP | Base de données | PgBouncer | Entrants | Pooler de connexion, le cas échéant, sur une architecture résiliente à trois nœuds |
| 2380 | TCP | etcd | etcd | Entrants | Pour le protocole peer-to-peer etcd |
| - | VRRP | Équilibreur de charge | Keepalived | Entrants | Élection du responsable Keepalived |
| - | VRRP | Base de données | Keepalived | Entrants | Élection du responsable Keepalived sur une architecture résiliente à trois nœuds |
| 6703 | TCP | Gestionnaire de cluster | Gestionnaire de cluster | Entrants | Port gRPC du gestionnaire de cluster |
| 6702 | TCP | Tous les nœuds | Gestionnaire de nœuds | Entrants | Port gRPC du gestionnaire de nœuds |
| 6700 | TCP | Tous les nœuds | Gestionnaire de nœuds | Entrants | Port gRPC d'initialisation du gestionnaire de nœuds |
| 8086 | HTTP | Tous les nœuds | Gestionnaire de nœuds | Entrants | Port HTTP du gestionnaire de nœuds pour vérifier le nœud principal ou de secours |
| 2379 | TCP | etcd | etcd | Entrants | Pour que le gestionnaire de cluster fonctionne avec etcd |
| 443 | HTTPS | Base de données | Cloud Storage | Sortants | Pour l'envoi de données de sauvegarde |
Mode SELinux de l'hôte
AlloyDB Omni est compatible avec SELinux en mode permissif et en mode d'application.
Pour activer ou désactiver SELinux, vérifiez que le fichier /etc/selinux/config est mis à jour sur tous les nœuds. Avant d'amorcer le cluster, assurez-vous que les paramètres SELinux sont cohérents sur tous les nœuds de base de données et les nœuds d'équilibrage de charge. Pour vérifier les paramètres actuels, utilisez la commande getenforce.
Pour en savoir plus, consultez Spécifications des règles SELinux.
Installer l'outil d'orchestration
Ansible
Utilisez cette méthode si vous prévoyez d'utiliser des playbooks Ansible pour gérer vos clusters.
Sur votre nœud de contrôle, installez Ansible et les bibliothèques Python requises :
# Install EPEL for RHEL 9 sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm -y # Install Ansible and dependencies sudo dnf install ansible sudo dnf install python3-grpcio python3-protobuf python3-googleapis-common-protosTéléchargez le fichier tar de la collection Ansible et sa signature, vérifiez le package et installez-le :
# Download the collection and its signature wget ALLOYDBOMNI_SERVER/google-alloydbomni_orchestrator-0.1.0-1.tar.gz wget ALLOYDBOMNI_SERVER/google-alloydbomni_orchestrator-0.1.0-1.tar.gz.asc # Import the Google Linux signing key curl -sS https://dl.google.com/linux/linux_signing_key.pub | gpg --import # Verify the collection tarball gpg --verify google-alloydbomni_orchestrator-0.1.0-1.tar.gz.asc \ google-alloydbomni_orchestrator-0.1.0-1.tar.gz # Install the collection ansible-galaxy collection install google-alloydbomni_orchestrator-0.1.0-1.tar.gz # Verify the installation ansible-galaxy collection list | grep alloydbomni_orchestratorRemplacez
ALLOYDBOMNI_SERVERpar l'URL du serveur sur lequel sont hébergés les packages logiciels AlloyDB Omni, y compris le fichier tar de la collection Ansible. Cette source vous est fournie après votre inscription à la preview d'AlloyDB Omni avec l'outil d'orchestration RPM Preview.
alloydbctl
Utilisez cette méthode si vous préférez un utilitaire de ligne de commande pour gérer les ressources.
Créez un fichier de configuration Yum sur le nœud de contrôle à l'adresse
/etc/yum.repos.d/alloydbomni_orchestrator.repo:[alloydbomni_orchestrator] name=Google AlloyDB Omni orchestrator packages baseurl=ALLOYDB_OMNI_ORCHESTRATOR_REPOSITORY_URL enabled=1 repo_gpgcheck=0 gpgcheck=1 gpgkey=REPO_GPG_KEYRemplacez les éléments suivants :
ALLOYDB_OMNI_ORCHESTRATOR_REPOSITORY_URL: URL du dépôt contenant les RPM de l'outil d'orchestration AlloyDB Omni.REPO_GPG_KEY: emplacement de la clé publique de Google pour la validation GNU Privacy Guard (GPG), par exemple,https://dl.google.com/linux/linux_signing_key.pub. Vous pouvez également définir un chemin d'accès si la clé est téléchargée dans un fichier, par exemple,file:///tmp/linux_signing_key.pub.
Installez le package et ajoutez le binaire au
PATHde votre système :sudo dnf install alloydbomni_orchestrator export PATH=$PATH:/usr/local/binVérifiez l'installation en exécutant la commande suivante :
alloydbctl --help