Update Elasticsearch version in cicd, elasticsearch[async] python library (#688)

**Related Issue(s):**

- None

**Description:**

This PR updates the project’s Elasticsearch runtime version used in
local dev and CI, loosens the Python Elasticsearch client constraint,
and simplifies the CI workflow setup to use direct `pip` + `pytest`
instead of `pipenv`.

**Changes:**
- Bump Elasticsearch Docker image version (Compose + GitHub Actions
service) to `9.3.2`.
- Update Python dependency constraint for `elasticsearch[async]` to
allow a wider range (`>=8.19.1,<9.4.0`).
- Simplify `.github/workflows/cicd.yml` by removing `pipenv` and
streamlining install/test steps.

**PR Checklist:**

- [x] Code is formatted and linted (run `pre-commit run --all-files`)
- [x] Tests pass (run `make test`)
- [x] Documentation has been updated to reflect changes, if applicable
- [x] Changes are added to the changelog

---------

Co-authored-by: Copilot <[email protected]>

Author: jonhealy1

.github/workflows/cicd.yml

@@ -15,8 +15,8 @@ jobs:
     timeout-minutes: 20
 
     services:
-      elasticsearch_8_svc:
-        image: docker.elastic.co/elasticsearch/elasticsearch:8.19.5
+      elasticsearch_9_3:
+        image: docker.elastic.co/elasticsearch/elasticsearch:9.3.2
         env:
           cluster.name: stac-cluster
           node.name: es01
@@ -69,7 +69,12 @@ jobs:
     strategy:
       matrix:
         python-version: [ "3.12", "3.13", "3.14"]
-        backend: [ "elasticsearch8", "opensearch"]
+        backend: [ "elasticsearch", "opensearch"]
+        include:
+          - backend: "elasticsearch"
+            port: "9200"
+          - backend: "opensearch"
+            port: "9202"
 
     name: Python ${{ matrix.python-version }} testing with ${{ matrix.backend }}
 
@@ -83,49 +88,33 @@ jobs:
           python-version: ${{ matrix.python-version }}
           cache: 'pip'
           cache-dependency-path: |
-            **/setup.py
+            **/pyproject.toml
 
       - name: Lint code
-        if: ${{ matrix.python-version == 3.11 }}
+        if: ${{ matrix.python-version == '3.12' }}
         run: |
           python -m pip install pre-commit
           pre-commit run --all-files
 
-      - name: Install pipenv
-        run: |
-          python -m pip install --upgrade pipenv wheel
-
-      - name: Install core library stac-fastapi
+      - name: Install dependencies
         run: |
+          python -m pip install --upgrade pip wheel pytest-timeout
           pip install ./stac_fastapi/core[catalogs]
-
-      - name: Install helpers library stac-fastapi
-        run: |
           pip install ./stac_fastapi/sfeos_helpers
-          
-      - name: Install elasticsearch stac-fastapi
-        run: |
           pip install ./stac_fastapi/elasticsearch[dev,server]
-
-      - name: Install opensearch stac-fastapi
-        run: |
           pip install ./stac_fastapi/opensearch[dev,server]
 
-      - name: Install pytest-timeout
-        run: |
-          pip install pytest-timeout
-
       - name: Run test suite
         run: |
-          pipenv run pytest -svvv --timeout=300
+          pytest -svvv --timeout=300
         env:
           ENVIRONMENT: testing
-          ES_PORT: ${{ matrix.backend == 'elasticsearch8' && '9200' || '9202' }}
+          ES_PORT: ${{ matrix.port }}
           ES_HOST: 172.17.0.1
           ES_USE_SSL: false
           DATABASE_REFRESH: true
           ES_VERIFY_CERTS: false
           REDIS_ENABLE: true
           REDIS_HOST: localhost
           REDIS_PORT: 6379
-          BACKEND: ${{ matrix.backend == 'elasticsearch8' && 'elasticsearch' || 'opensearch' }}
+          BACKEND: ${{ matrix.backend }}

CHANGELOG.md

@@ -23,6 +23,9 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 
 ### Updated
 
+- Updated Elasticsearch version in CI/CD compose.yml to 9.3.2 from 8.19.5 [#688](https://github.com/stac-utils/stac-fastapi-elasticsearch-opensearch/pull/688)
+- Updated `elasticsearch[async]` Python dependency from ~=8.19.1 to >=8.19.1,<9.4.0 [#688](https://github.com/stac-utils/stac-fastapi-elasticsearch-opensearch/pull/688)
+- Simplified, cleaned up CI/CD GitHub workflow in `cicd.yml` [#688](https://github.com/stac-utils/stac-fastapi-elasticsearch-opensearch/pull/688)
 - Updated, loosened fastapi, uvicorn and starlette libraries and moved shared deps to core. [#687](https://github.com/stac-utils/stac-fastapi-elasticsearch-opensearch/pull/687)
 
 ## [v6.15.0] - 2026-04-04

README.md

@@ -669,7 +669,7 @@ There are two main ways to run the API locally:
 
 - **Configuration**: By default, Docker Compose uses Elasticsearch 8.x and OpenSearch 3.5.0. To use different versions, create a `.env` file:
   ```shell
-  ELASTICSEARCH_VERSION=8.11.0
+  ELASTICSEARCH_VERSION=9.3.2
   OPENSEARCH_VERSION=3.5.0
   ENABLE_DIRECT_RESPONSE=false
   ```
@@ -704,7 +704,7 @@ You can customize additional settings in your `.env` file:
 | `ES_API_KEY` | API Key for external Elasticsearch/OpenSearch. | N/A | Optional |
 | `ES_TIMEOUT` | Client timeout for Elasticsearch/OpenSearch. | DB client default | Optional |
 | `BACKEND` | Tests-related variable | `elasticsearch` or `opensearch` based on the backend | Optional |
-| `ELASTICSEARCH_VERSION` | Version of Elasticsearch to use. | `8.11.0` | Optional |
+| `ELASTICSEARCH_VERSION` | Version of Elasticsearch to use. | `9.3.2` | Optional |
 | `OPENSEARCH_VERSION` | OpenSearch version | `3.5.0` | Optional |
 | `RETRY_MAX_ATTEMPTS_CONNECTION_ERROR` | Specifies the maximum number of retry attempts for connection errors (ConnectionError, ConnectionTimeout) before giving up. | `5` | Optional |
 | `RETRY_MAX_ATTEMPTS_NOT_FOUND_ERROR` | Specifies the maximum number of retry attempts for `IndexNotFoundException` error before giving up. This is particularly useful for datetime-based index searches where indices may need to be refreshed. | `3` | Optional |

compose.yml

@@ -82,7 +82,7 @@ services:
 
   elasticsearch:
     container_name: es-container
-    image: docker.elastic.co/elasticsearch/elasticsearch:${ELASTICSEARCH_VERSION:-8.19.5}
+    image: docker.elastic.co/elasticsearch/elasticsearch:${ELASTICSEARCH_VERSION:-9.3.2}
     hostname: elasticsearch
     environment:
       ES_JAVA_OPTS: -Xms512m -Xmx1g

stac_fastapi/elasticsearch/pyproject.toml

@@ -30,7 +30,7 @@ dynamic = ["version"]
 dependencies = [
     "stac-fastapi-core==6.15.0",
     "sfeos-helpers==6.15.0",
-    "elasticsearch[async]~=8.19.1",
+    "elasticsearch[async]>=8.19.1,<9.4.0",
 ]
 
 [project.urls]