Installation d'un cluster Elasticsearch (3+ nœuds, TLS, Kibana)

Construit à partir de zéro un cluster Elasticsearch 8.x / 9.x de 3 nœuds ou plus : dépôt Elastic, heap dimensionné selon la RAM, memory lock, vm.max_map_count, sécurité automatique sur le premier nœud (TLS + mot de passe elastic), adhésion des autres nœuds par enrollment token, rôles master/data combinés ou séparés, installation et enrollment de Kibana, dépôt de snapshots partagé et politique SLM nocturne. Le résultat est un cluster green, protégé par TLS et mots de passe, avec Kibana et un snapshot pris chaque nuit. L'exploitation courante du cluster installé (shards, disque, ajout/retrait de nœuds), le durcissement de la sécurité, snapshot/restore et les montées de version sont traités dans des guides Elasticsearch distincts.

Topologie: 3+ nœuds Elasticsearch (+ serveur Kibana facultatif)

Avant de commencer

• Tous les serveurs sont dans la même version, prise en charge, du système d'exploitation et à jour. Les horloges sont synchronisées (chrony) : en cas de décalage, les certificats TLS et les tokens peuvent être considérés comme invalides.
• Chaque nœud dispose de … Go de RAM (le heap sera de … Mo) et d'au moins 2 CPU. Elasticsearch est livré avec son propre JDK ; n'installez pas Java séparément.
• … dispose d'assez d'espace libre (à 85 % de remplissage du disque, aucun nouveau shard n'est alloué au nœud data ; à 90 %, les shards commencent à être déplacés vers d'autres nœuds). SSD recommandé.
• Hostnames et IP fixes : ……=……, ………, …=……. Ouverts : 9300 (transport) entre les nœuds, 9200 (HTTPS) des clients vers les nœuds…, 5601 des utilisateurs vers Kibana….
• Les serveurs peuvent joindre artifacts.elastic.co en HTTPS (ou un miroir interne est configuré). Une fois le dépôt ajouté, la commande ci-dessous liste les versions installables.
• Aucune ancienne installation ni ancien répertoire de données Elasticsearch sur les serveurs (les données d'un ancien cluster empêchent le nœud de rejoindre le nouveau cluster).
• … est monté depuis le même partage NFS sur tous les nœuds master et data (persistant dans fstab). L'utilisateur elasticsearch doit avoir le droit d'écriture sur le partage : si son UID n'est pas le même sur tous les nœuds, utilisez all_squash,anonuid=… côté NFS ou alignez les UID.
• Accès root/sudo, fenêtre de maintenance et snapshots des serveurs prêts. Les enrollment tokens sont valables 30 minutes ; enchaînez sans pause les étapes d'adhésion des autres nœuds.

Phases du guide

• Préparation du système d'exploitation — Définir le hostname · Définir le hostname (Kibana) · Configurer la résolution de noms (/etc/hosts) · Installer les outils de base et synchroniser l'horloge · Écrire les paramètres du noyau (vm.max_map_count) · Appliquer les paramètres sysctl …
• Dépôt Elastic et installation du logiciel — Importer la clé GPG Elastic · Déclarer le dépôt Elastic · Déclarer le dépôt Elastic · Lister les versions installables · Installer Elasticsearch · Verrouiller la version
• Heap, verrouillage mémoire et répertoires — Définir la taille du heap · Définir le propriétaire du fichier (heap.options) · Autoriser le verrouillage mémoire dans systemd · Recharger systemd · Préparer le répertoire de données · Définir les droits du répertoire des snapshots
• Premier nœud : initialiser le cluster — Écrire elasticsearch.yml (nœud 1) · Définir le propriétaire du fichier (elasticsearch.yml) · Démarrer le service (nœud 1) · Définir le mot de passe de l'utilisateur elastic · Créer un fichier d'identifiants temporaire pour l'accès API · Vérifier l'état du cluster (nœud unique) …
• Terminer la formation du cluster — Vérifier que tous les nœuds ont rejoint le cluster · Supprimer la ligne cluster.initial_master_nodes · Convertir le nœud 1 en master dédié : vider ses shards · Passer le nœud 1 en rôle master et nettoyer son répertoire de données · Supprimer la règle d'allocation temporaire
• Vérification — Vérifier la santé du cluster · Vérifier le verrouillage mémoire et le heap · Vérifier l'élection du master et la configuration de vote · Vérifier la répartition des shards avec un index de test · Vérifier le fichier de log
• Installation de Kibana et enrollment — Installer Kibana · Définir l'adresse d'écoute · Créer un enrollment token Kibana · Connecter Kibana au cluster (kibana-setup) · Connecter Kibana à plusieurs nœuds · Générer les clés de chiffrement …
• Dépôt de snapshots — Enregistrer et vérifier le dépôt · Définir la politique de snapshot nocturne (SLM)
• Après l'installation — Créer l'utilisateur et le rôle applicatifs · Préparer le certificat de la CA pour les clients · Appliquer la check-list de supervision et de sauvegarde · Supprimer le fichier d'identifiants temporaire