QAG-65: fix: Fix DDEV Elasticsearch plugin configuration and installation

- Implement automatic Elasticsearch plugin installation script
- Replace broken manual plugin installation with environment variable configuration
- Add proper restart handling for newly installed plugins
- Update documentation with Elasticsearch configuration details
- Update elasticsearch8.yml configuration comments

Refs: .ddev/elasticsearch/, README.md

Author: tormi

.ddev/addon-metadata/elasticsearch/manifest.yaml

@@ -1,9 +1,9 @@
 name: elasticsearch
 repository: ddev/ddev-elasticsearch
 version: v0.3.2
-install_date: "2024-08-13T10:51:11+03:00"
+install_date: "2025-03-21T10:53:19+02:00"
 project_files:
-    - elasticsearch/config/elasticsearch8.yml
+    - elasticsearch/
     - docker-compose.elasticsearch8.yaml
 global_files: []
 removal_actions: []

.ddev/config.yaml

@@ -33,13 +33,10 @@ hooks:
   post-start:
     - exec: "composer install"
     - exec: "npm ci"
-    - exec: |
-        plugins=(analysis-icu)
-        for plugin in "${plugins[@]}"; do
-          if ! elasticsearch-plugin list | grep -q "^$plugin\b"; then
-            elasticsearch-plugin install "$plugin"
-          else
-            echo "Plugin $plugin is already installed"
-          fi
-        done
-      service: elasticsearch
+    - exec-host: "ddev exec -s elasticsearch /mnt/ddev_config/elasticsearch/elasticsearch-setup.sh"
+    - exec-host: |
+        if [ -f /tmp/elasticsearch_needs_restart ]; then
+          echo "Restarting Elasticsearch to apply plugin changes..."
+          ddev restart elasticsearch
+          rm /tmp/elasticsearch_needs_restart
+        fi

.ddev/docker-compose.elasticsearch8.yaml

@@ -14,6 +14,7 @@ services:
       - VIRTUAL_HOST=$DDEV_HOSTNAME
       - HTTP_EXPOSE=9200:9200
       - HTTPS_EXPOSE=9201:9200
+      - ELASTICSEARCH_PLUGINS=analysis-icu
     labels:
       com.ddev.site-name: ${DDEV_SITENAME}
       com.ddev.approot: $DDEV_APPROOT

.ddev/elasticsearch/config/elasticsearch8.yml

@@ -1,4 +1,3 @@
-#ddev-generated
 # This file contains the configuration settings for Elasticsearch 8.
 # For more information, see https://www.elastic.co/guide/en/elasticsearch/reference/current/settings.html
 
@@ -8,7 +7,8 @@ cluster.name: "docker-cluster"
 # https://www.elastic.co/guide/en/elasticsearch/reference/current/important-settings.html#network.host
 network.host: 0.0.0.0
 
-# Security settings
+# Disable security features
+# https://www.elastic.co/guide/en/elasticsearch/reference/current/security-settings.html#general-security-settings
 xpack.security.enabled: false
 xpack.security.autoconfiguration.enabled: false
 xpack.security.enrollment.enabled: false

.ddev/elasticsearch/elasticsearch-setup.sh

@@ -0,0 +1,29 @@
+#!/bin/bash
+
+# Exit if no plugins specified
+[ -z "$ELASTICSEARCH_PLUGINS" ] && echo "No plugins specified in ELASTICSEARCH_PLUGINS" && exit 0
+
+echo "Installing Elasticsearch plugins: $ELASTICSEARCH_PLUGINS"
+needs_restart=false
+
+# Process each plugin
+for plugin in $ELASTICSEARCH_PLUGINS; do
+    # Skip if already installed
+    if bin/elasticsearch-plugin list | grep -q "$plugin"; then
+        echo "✓ Plugin $plugin already installed"
+        continue
+    fi
+
+    # Install plugin
+    echo "Installing $plugin plugin..."
+    bin/elasticsearch-plugin install "$plugin" && \
+    chown -R elasticsearch:root "/usr/share/elasticsearch/plugins/$plugin" && \
+    chmod -R 755 "/usr/share/elasticsearch/plugins/$plugin" && \
+    echo "✓ Plugin $plugin installed successfully" && \
+    needs_restart=true
+done
+
+# Signal for restart if needed
+[ "$needs_restart" = true ] && echo "New plugins were installed. Elasticsearch needs to be restarted." && touch /tmp/elasticsearch_needs_restart
+
+exit 0

README.md

@@ -121,6 +121,41 @@ For a complete list of all available services, URLs, and ports, use:
 - `ddev xdebug <mode>` - Configure Xdebug debugging modes
 - `ddev syncdb [environment]` - Sync database from remote environment (requires VPN and `ddev auth ssh`, see `scripts/syncdb.sh` for details)
 
+<details>
+<summary>DDEV Elasticsearch configuration</summary>
+
+#### DDEV Elasticsearch configuration
+
+This project includes Elasticsearch with the `analysis-icu` plugin for Unicode/multilingual text processing support.
+
+**Configuration and customization:**
+
+Plugins are defined in `.ddev/docker-compose.elasticsearch8.yaml` as environment variables. You can install multiple plugins by adding them as space-separated values:
+
+```yaml
+services:
+  elasticsearch:
+    environment:
+      - ELASTICSEARCH_PLUGINS=analysis-icu analysis-ukrainian
+```
+
+The installation process:
+1. Plugin names are defined as space-separated values
+2. A post-start hook installs missing plugins and sets permissions
+3. Elasticsearch restarts automatically if needed
+
+**Useful commands:**
+
+```bash
+# List installed plugins
+ddev exec -s elasticsearch "bin/elasticsearch-plugin list"
+
+# View detailed plugin information
+ddev exec -s elasticsearch "curl -s localhost:9200/_nodes/plugins?pretty"
+```
+
+</details>
+
 <details>
 <summary>Lando environment</summary>