You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
add build push docker image image in the publish ci (stac-utils#311)
**Related Issue(s):**
- #
**Description:**
Since I needed to have this docker images of elastic search and open
search, I added a new publish docker image step in publish.yml
ping @jonhealy1
**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: Jonathan Healy <[email protected]>
Copy file name to clipboardExpand all lines: CHANGELOG.md
+8
Original file line number
Diff line number
Diff line change
@@ -7,6 +7,14 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
7
7
8
8
## [Unreleased]
9
9
10
+
## [v3.2.1] - 2024-11-14
11
+
12
+
### Added
13
+
- Added `dockerfiles/Dockerfile.ci.os` and `dockerfiles/Dockerfile.ci.es`, along with their respective entrypoints [#311](https://github.com/stac-utils/stac-fastapi-elasticsearch-opensearch/pull/311)
14
+
15
+
### Changed
16
+
- Updated the `publish.yml` workflow to include Docker image publishing to GitHub Container Registry [#311](https://github.com/stac-utils/stac-fastapi-elasticsearch-opensearch/pull/311)
17
+
- Improved the README with detailed descriptions of the new Docker images, providing guidance for images. [#311](https://github.com/stac-utils/stac-fastapi-elasticsearch-opensearch/pull/311)
10
18
- Aggregation ElasticSearch `total_count` bugfix, moved aggregation text to docs. [#314](https://github.com/stac-utils/stac-fastapi-elasticsearch-opensearch/pull/314)
Copy file name to clipboardExpand all lines: README.md
+41-5
Original file line number
Diff line number
Diff line change
@@ -43,17 +43,24 @@ or
43
43
pip install stac_fastapi.opensearch
44
44
```
45
45
46
-
## Build Elasticsearch API backend
46
+
### To install and run via pre-built Docker Images
47
+
48
+
We provide ready-to-use Docker images through GitHub Container Registry ([ElasticSearch](https://github.com/stac-utils/stac-fastapi-elasticsearch-opensearch/pkgs/container/stac-fastapi-es) and [OpenSearch](https://github.com/stac-utils/stac-fastapi-elasticsearch-opensearch/pkgs/container/stac-fastapi-os) backends). You can easily pull and run these images:
## Run Elasticsearch API backend on localhost:8080
59
+
60
+
You need to ensure [**Docker Compose**](https://docs.docker.com/compose/install/) or [**Podman Compose**](https://podman-desktop.io/docs/compose) installed and running on your machine. In the follwoing command instead of `docker-compose` you can use `podman-compose` as well.
54
61
55
62
```shell
56
-
docker-compose up app-elasticsearch
63
+
docker-compose up elasticsearch app-elasticsearch
57
64
```
58
65
59
66
By default, docker-compose uses Elasticsearch 8.x and OpenSearch 2.11.1.
@@ -66,6 +73,35 @@ OPENSEARCH_VERSION=2.11.0
66
73
```
67
74
The most recent Elasticsearch 7.x versions should also work. See the [opensearch-py docs](https://github.com/opensearch-project/opensearch-py/blob/main/COMPATIBILITY.md) for compatibility information.
68
75
76
+
#### **Configuration reference keys:**
77
+
78
+
You can customize additional settings in your `.env` file:
|`WEB_CONCURRENCY`| Number of worker processes. |`10`| Optional |
94
+
|`RELOAD`| Enable auto-reload for development. |`true`| Optional |
95
+
|`STAC_FASTAPI_RATE_LIMIT`| API rate limit per client. |`200/minute`| Optional |
96
+
|`BACKEND`| Tests-related variable |`elasticsearch` or `opensearch` based on the backend | Optional |
97
+
|`ELASTICSEARCH_VERSION`| ElasticSearch version |`7.17.1`| Optional |
98
+
|`OPENSEARCH_VERSION`| OpenSearch version |`2.11.0`| Optional |
99
+
100
+
> [!NOTE]
101
+
> The variables `ES_HOST`, `ES_PORT`, `ES_USE_SSL`, and `ES_VERIFY_CERTS` apply to both Elasticsearch and OpenSearch backends, so there is no need to rename the key names to `OS_` even if you're using OpenSearch.
0 commit comments