RousselTMLEARNING

Observabilité

Déployer OpenSearch en cluster : Docker, Kubernetes et services managés

Passer d'un nœud à un vrai cluster OpenSearch : trois nœuds avec Docker Compose, réglages système, paquets Linux, Helm et opérateur Kubernetes, certificats, répartition sur plusieurs zones et services managés comme Amazon OpenSearch Service.

1. Où faire tourner OpenSearch ? #

Choisir son mode de déploiement.

Options #

Où faire tourner OpenSearch ?

2. Trois nœuds avec Docker Compose #

Le cluster minimal tolérant aux pannes.

Architecture #

Un cluster de trois nœuds

docker-compose.yml #

x-os: &os
  image: opensearchproject/opensearch:3
  ulimits:
    memlock: {soft: -1, hard: -1}
    nofile: {soft: 65536, hard: 65536}
  networks: [os-net]

x-env: &env
  cluster.name: os-lab
  discovery.seed_hosts: os-node1,os-node2,os-node3
  cluster.initial_cluster_manager_nodes: os-node1,os-node2,os-node3
  bootstrap.memory_lock: "true"
  OPENSEARCH_JAVA_OPTS: -Xms1g -Xmx1g
  OPENSEARCH_INITIAL_ADMIN_PASSWORD: ${OPENSEARCH_INITIAL_ADMIN_PASSWORD}

services:
  os-node1:
    <<: *os
    container_name: os-node1
    environment: {<<: *env, node.name: os-node1}
    volumes: [os-data1:/usr/share/opensearch/data]
    ports: ["9200:9200"]
  os-node2:
    <<: *os
    container_name: os-node2
    environment: {<<: *env, node.name: os-node2}
    volumes: [os-data2:/usr/share/opensearch/data]
  os-node3:
    <<: *os
    container_name: os-node3
    environment: {<<: *env, node.name: os-node3}
    volumes: [os-data3:/usr/share/opensearch/data]
  dashboards:
    image: opensearchproject/opensearch-dashboards:3
    environment:
      OPENSEARCH_HOSTS: '["https://os-node1:9200","https://os-node2:9200","https://os-node3:9200"]'
    ports: ["5601:5601"]
    networks: [os-net]

volumes: {os-data1: {}, os-data2: {}, os-data3: {}}
networks: {os-net: {}}
sudo sysctl -w vm.max_map_count=262144
echo 'OPENSEARCH_INITIAL_ADMIN_PASSWORD=Str0ng!Passw0rd-2026' > .env
docker compose up -d
curl -sk -u 'admin:Str0ng!Passw0rd-2026' 'https://localhost:9200/_cat/nodes?v&h=name,node.role,cluster_manager'

Les ancres YAML (&os, <<: *env) évitent de répéter la configuration commune. La colonne cluster_manager affiche une étoile devant le nœud élu.

À savoir : Les trois nœuds partagent ici les certificats de démonstration de l'image, ce qui suffit pour une maquette. En production, générez des certificats par nœud avec votre autorité de certification.

3. Kubernetes #

Helm ou opérateur.

Deux approches #

OutilPrincipePour
Charts Helmun StatefulSet par groupe de nœuds, configuration dans values.yamldéploiements simples, équipes déjà Helm
Opérateur OpenSearchune ressource OpenSearchCluster ; l'opérateur gère montées de version, certificats, mise à l'échelleexploitation dans la durée
helm repo add opensearch-operator https://opensearch-project.github.io/opensearch-k8s-operator/
helm install opensearch-operator opensearch-operator/opensearch-operator -n opensearch --create-namespace
apiVersion: opensearch.opster.io/v1
kind: OpenSearchCluster
metadata:
  name: logs
  namespace: opensearch
spec:
  general:
    serviceName: logs
    version: 3.9.0
  dashboards:
    enable: true
    version: 3.9.0
    replicas: 1
  nodePools:
    - component: managers
      replicas: 3
      diskSize: "10Gi"
      roles: ["cluster_manager"]
      resources: {requests: {memory: "2Gi", cpu: "500m"}}
    - component: data
      replicas: 3
      diskSize: "200Gi"
      roles: ["data", "ingest"]
      resources: {requests: {memory: "8Gi", cpu: "2"}}

Le réglage vm.max_map_count doit être appliqué sur les nœuds Kubernetes (l'opérateur peut lancer un conteneur d'initialisation pour cela). Utilisez une classe de stockage SSD et une politique de rétention des volumes qui ne supprime pas les données avec le pod.

4. Résister à la perte d'une zone #

Répartir les répliques.

Allocation par zone #

node.attr.zone: zone-a          # zone-b, zone-c sur les autres nœuds
cluster.routing.allocation.awareness.attributes: zone

Avec cet attribut, OpenSearch place primaire et réplique d'un même shard dans des zones différentes. Répartissez aussi les trois nœuds cluster manager sur trois zones : la perte d'une zone laisse alors le quorum et une copie de chaque shard.

5. Services managés #

Déléguer l'exploitation.

Panorama #

OffrePrincipeÀ vérifier
Amazon OpenSearch Serviceclusters gérés par AWS : nœuds choisis, montées de version, snapshots automatiques, UltraWarm et stockage froidversions disponibles, API restreintes
Amazon OpenSearch Serverlesscollections sans nœuds, facturées en unités de calcul (OCU)fonctions et API non toutes disponibles
Autres hébergeursplusieurs fournisseurs proposent OpenSearch géré (Aiven, Instaclustr…)région, plugins, support
Attention : Un service managé restreint souvent certaines API (réglages du cluster, plugins, securityadmin). Vérifiez que vos outils et vos TP fonctionnent avant de vous engager.

Commandes à connaître #

Commandes à connaître
  • docker compose up -d : démarrer le cluster de maquette
  • GET _cat/nodes?v&h=name,node.role,cluster_manager : nœuds et cluster manager élu
  • kubectl get opensearchclusters -n opensearch : clusters gérés par l'opérateur
  • GET _cluster/settings?include_defaults=true&filter_path=**.awareness : allocation par zone
  • docker stop os-node2 : simuler la panne d'un nœud

Sources #

Vérifié en novembre 2026 (OpenSearch 3.x, Data Prepper 2.x) : OpenSearch publie une version mineure environ toutes les six semaines, consultez les notes de version avant de vous appuyer sur un détail.

Articles liés

Le cluster OpenSearch en détail : nœuds, shards et réplication

Comprendre le fonctionnement interne d'un cluster OpenSearch : rôles des nœuds, élection du cluster manager, …

Recherche plein texte dans OpenSearch : analyseurs et pertinence

Maîtriser la recherche plein texte : index inversé, analyseurs (dont le français), API _analyze, requêtes mat…

Agrégations, PPL et SQL avancés dans OpenSearch

Analyser ses données dans OpenSearch : agrégations bucket, metric et pipeline, histogrammes de dates, cardina…

Pour aller plus loin

Soutenir

♥ SOUTENIR

Soutenez RousselTM Learning

Les formations, articles, TP et attestations restent gratuits et sans publicité intrusive. Une contribution libre, du montant de votre choix, finance l’hébergement, les environnements de TP et l’écriture de nouveaux contenus.

Contribuer avec PayPal Montant libre · carte bancaire ou compte PayPalEn savoir plus
QR code PayPal
Ou scannez ce QR code avec votre téléphone

Merci, chaque contribution compte !