feat: add opensearch docker-compose file

Author: cr7258

.env

@@ -5,5 +5,5 @@ ELASTICSEARCH_PASSWORD=test123
 
 # OpenSearch connection settings
 OPENSEARCH_HOSTS=https://localhost:9200
-OPENSEARCH_USERNAME=elastic
-OPENSEARCH_PASSWORD=test123
+OPENSEARCH_USERNAME=admin
+OPENSEARCH_PASSWORD=admin

Dockerfile

@@ -19,9 +19,9 @@ RUN hatch build && pip install dist/*.whl
 
 # Set environment variables required for the MCP server
 # These can be overridden at runtime with docker run --env
-ENV ELASTIC_HOST="https://localhost:9200"
-ENV ELASTIC_USERNAME="elastic"
-ENV ELASTIC_PASSWORD="test123"
+ENV ELASTICSEARCH_HOST="https://localhost:9200"
+ENV ELASTICSEARCH_USERNAME="elastic"
+ENV ELASTICSEARCH_PASSWORD="test123"
 
 # Expose the port the server is running on (if applicable)
 EXPOSE 8000

README.md

@@ -30,17 +30,21 @@ https://github.com/user-attachments/assets/f7409e31-fac4-4321-9c94-b0ff2ea7ff15
 - `get_cluster_stats`: Get statistical information about the cluster.
 
 
-## Start Elasticsearch Cluster
+## Start Elasticsearch/OpenSearch Cluster
 
-Start the Elasticsearch cluster using Docker Compose:
+Start the Elasticsearch/OpenSearch cluster using Docker Compose:
 
 ```bash
-docker-compose up -d
+# For Elasticsearch
+docker-compose -f setup/elasticsearch-docker-compose.yml up -d
+
+# For OpenSearch
+docker-compose -f setup/opensearch-docker-compose.yml up -d
 ```
 
-This will start a 3-node Elasticsearch cluster and Kibana. Default Elasticsearch username `elastic`, password `test123`.
+The default Elasticsearch username is `elastic` and password is `test123`. The default OpenSearch username is `admin` and password is `admin`.
 
-You can access Kibana from http://localhost:5601.
+You can access Kibana/OpenSearch Dashboards from http://localhost:5601.
 
 ## Usage with Claude Desktop
 

docker-compose.yml setup/elasticsearch-docker-compose.yml

@@ -0,0 +1,71 @@
+services:
+  opensearch-node1: # This is also the hostname of the container within the Docker network (i.e. https://opensearch-node1/)
+    image: opensearchproject/opensearch:2.11.0
+    container_name: opensearch-node1
+    environment:
+      - cluster.name=opensearch-cluster # Name the cluster
+      - node.name=opensearch-node1 # Name the node that will run in this container
+      - discovery.seed_hosts=opensearch-node1,opensearch-node2 # Nodes to look for when discovering the cluster
+      - cluster.initial_cluster_manager_nodes=opensearch-node1,opensearch-node2 # Nodes eligibile to serve as cluster manager
+      - bootstrap.memory_lock=true # Disable JVM heap memory swapping
+      - "OPENSEARCH_JAVA_OPTS=-Xms512m -Xmx512m" # Set min and max JVM heap sizes to at least 50% of system RAM
+      - cluster.routing.allocation.disk.watermark.low=2gb
+      - cluster.routing.allocation.disk.watermark.high=1gb
+      - cluster.routing.allocation.disk.watermark.flood_stage=512mb
+    ulimits:
+      memlock:
+        soft: -1 # Set memlock to unlimited (no soft or hard limit)
+        hard: -1
+      nofile:
+        soft: 65536 # Maximum number of open files for the opensearch user - set to at least 65536
+        hard: 65536
+    volumes:
+      - opensearch-data1:/usr/share/opensearch/data # Creates volume called opensearch-data1 and mounts it to the container
+    ports:
+      - 9200:9200 # REST API
+      - 9600:9600 # Performance Analyzer
+    networks:
+      - opensearch-net # All of the containers will join the same Docker bridge network
+  opensearch-node2:
+    image: opensearchproject/opensearch:2.11.0 # This should be the same image used for opensearch-node1 to avoid issues
+    container_name: opensearch-node2
+    environment:
+      - cluster.name=opensearch-cluster
+      - node.name=opensearch-node2
+      - discovery.seed_hosts=opensearch-node1,opensearch-node2
+      - cluster.initial_cluster_manager_nodes=opensearch-node1,opensearch-node2
+      - bootstrap.memory_lock=true
+      - "OPENSEARCH_JAVA_OPTS=-Xms512m -Xmx512m"
+      - cluster.routing.allocation.disk.watermark.low=2gb
+      - cluster.routing.allocation.disk.watermark.high=1gb
+      - cluster.routing.allocation.disk.watermark.flood_stage=512mb
+    ulimits:
+      memlock:
+        soft: -1
+        hard: -1
+      nofile:
+        soft: 65536
+        hard: 65536
+    volumes:
+      - opensearch-data2:/usr/share/opensearch/data
+    networks:
+      - opensearch-net
+  opensearch-dashboards:
+    image: opensearchproject/opensearch-dashboards:2.11.0 # Make sure the version of opensearch-dashboards matches the version of opensearch installed on other nodes
+    container_name: opensearch-dashboards
+    ports:
+      - 5601:5601 # Map host port 5601 to container port 5601
+    expose:
+      - "5601" # Expose port 5601 for web access to OpenSearch Dashboards
+    environment:
+      OPENSEARCH_HOSTS: '["https://opensearch-node1:9200","https://opensearch-node2:9200"]' # Define the OpenSearch nodes that OpenSearch Dashboards will query
+    networks:
+      - opensearch-net
+
+volumes:
+  opensearch-data1:
+  opensearch-data2:
+
+networks:
+  opensearch-net:
+