Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Adds Docker-hub documentation #9

Merged
merged 4 commits into from
Feb 8, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 20 additions & 0 deletions .github/workflows/ci.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -61,3 +61,23 @@ jobs:
if: contains(github.ref, 'refs/tags/') && github.repository == 'georchestra/geonetwork-microservices' && github.event_name == 'push'
run: |
docker push georchestra/gn-cloud-ogc-api-records-service:${{ steps.version.outputs.VERSION }}

- name: "Update Docker Hub Description for OGC API"
if: github.ref == 'refs/heads/geor-main' && github.repository == 'georchestra/geonetwork-microservices' && github.actor != 'dependabot[bot]' && github.event_name != 'pull_request'
uses: peter-evans/dockerhub-description@v3
with:
username: ${{ secrets.DOCKER_HUB_USERNAME }}
password: ${{ secrets.DOCKER_HUB_PASSWORD }}
repository: georchestra/gn-cloud-ogc-api-records-service
readme-filepath: ./DOCKER_HUB_ogc.md
short-description: 'OGC API Records module for the geOrchestra SDI'

- name: "Update Docker Hub Description for GN cloud Searching"
if: github.ref == 'refs/heads/geor-main' && github.repository == 'georchestra/geonetwork-microservices' && github.actor != 'dependabot[bot]' && github.event_name != 'pull_request'
uses: peter-evans/dockerhub-description@v3
with:
username: ${{ secrets.DOCKER_HUB_USERNAME }}
password: ${{ secrets.DOCKER_HUB_PASSWORD }}
repository: georchestra/gn-cloud-searching
readme-filepath: ./DOCKER_HUB_searching.md
short-description: 'GN cloud searching module for the geOrchestra SDI'
51 changes: 51 additions & 0 deletions DOCKER_HUB_ogc.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,51 @@
# Quick reference

- **Maintained by**:
[georchestra.org](https://www.georchestra.org/)

- **Where to get help**:
the [geOrchestra Github repo](https://github.com/georchestra/georchestra), [IRC chat](https://kiwiirc.com/nextclient/irc.libera.chat/georchestra), Stack Overflow

# Featured tags

- `latest`, `23.0.x`

# Quick reference

- **Where to file issues**:
[https://github.com/georchestra/georchestra/issues](https://github.com/georchestra/georchestra/issues)

[https://github.com/geonetwork/geonetwork-microservices/issues](https://github.com/geonetwork/geonetwork-microservices/issues)

- **Supported architectures**:
[`amd64`](https://hub.docker.com/r/amd64/docker/)

- **Source of this description**:
[docs repo's directory](https://github.com/georchestra/geonetwork-microservices/blob/geor-main/DOCKER_HUB_ogc.md)

# What is `georchestra/gn-cloud-ogc-api-records-service`

**Gn-cloud-ogc-api-records-service** is a module for geOrchestra which offers :
- better Search Engine Optimization by implementing an OGC API records service with a landing page builder mechanism

# How to use this image

As for every other geOrchestra webapp, its configuration resides in the data directory ([datadir](https://github.com/georchestra/datadir)), typically something like /etc/georchestra, where it expects to find a geonetwork/microservices/ogc-api-records sub-directory.

It is recommended to use the official docker composition: https://github.com/georchestra/docker.

For this specific component, see the section `ogc-api-records` in the [`georchestra/docker/docker-compose.yml`](https://github.com/georchestra/docker/blob/master/docker-compose.yml) file.

## Where is it built

This image is built using the Dockerfile : `Dockerfile-ogc-api-records` in the repo https://github.com/georchestra/geonetwork-microservices/.

# License

View [license information](https://www.georchestra.org/software.html) for the software contained in this image.

As with all Docker images, these likely also contain other software which may be under other licenses (such as Bash, etc from the base distribution, along with any direct or indirect dependencies of the primary software being contained).

[//]: # (Some additional license information which was able to be auto-detected might be found in [the `repo-info` repository's georchestra/ directory]().)

As for any docker image, it is the user's responsibility to ensure that usages of this image comply with any relevant licenses for all software contained within.
49 changes: 49 additions & 0 deletions DOCKER_HUB_searching.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,49 @@
# Quick reference

- **Maintained by**:
[georchestra.org](https://www.georchestra.org/)

- **Where to get help**:
the [geOrchestra Github repo](https://github.com/georchestra/georchestra), [IRC chat](https://kiwiirc.com/nextclient/irc.libera.chat/georchestra), Stack Overflow

# Featured tags

- `latest`, `23.0.x`

# Quick reference

- **Where to file issues**:
[https://github.com/georchestra/georchestra/issues](https://github.com/georchestra/georchestra/issues)

[https://github.com/geonetwork/geonetwork-microservices/issues](https://github.com/geonetwork/geonetwork-microservices/issues)

- **Supported architectures**:
[`amd64`](https://hub.docker.com/r/amd64/docker/)

- **Source of this description**:
[docs repo's directory](https://github.com/georchestra/geonetwork-microservices/blob/geor-main/DOCKER_HUB_searching.md)

# What is `georchestra/gn-cloud-searching`

**Gn-cloud-searching** is a module for geOrchestra which offers :
- a search service is an Elasticsearch proxy taking care of user privileges

# How to use this image

As for every other geOrchestra webapp, its configuration resides in the data directory ([datadir](https://github.com/georchestra/datadir)), typically something like /etc/georchestra, where it expects to find a geonetwork/microservices/ogc-api-records sub-directory.

It is recommended to use the official docker composition: https://github.com/georchestra/docker.


## Where is it built

This image is built using the Dockerfile : `Dockerfile-searching` in the repo https://github.com/georchestra/geonetwork-microservices/.

# License

View [license information](https://www.georchestra.org/software.html) for the software contained in this image.

As with all Docker images, these likely also contain other software which may be under other licenses (such as Bash, etc from the base distribution, along with any direct or indirect dependencies of the primary software being contained).

[//]: # (Some additional license information which was able to be auto-detected might be found in [the `repo-info` repository's georchestra/ directory]().)
As for any docker image, it is the user's responsibility to ensure that usages of this image comply with any relevant licenses for all software contained within.
Loading