Just van den Broecke
86 lines
2.3 KiB
Markdown
86 lines
2.3 KiB
Markdown
# pygeoapi Docker HOWTO
|
|
|
|
Docker Images `geopython/pygeoapi:latest` and versions are available from DockerHub.
|
|
|
|
Each Docker Image contains a default configuration [default.config.yml](default.config.yml)
|
|
with the project's test data and WFS3 datasets.
|
|
|
|
You can override this default config via Docker Volume mapping.
|
|
See an [example for the geoapi demo server](https://github.com/geopython/demo.pygeoapi.io/tree/master/services/pygeoapi).
|
|
|
|
Depending on your config you may need specific backends to be available.
|
|
|
|
## Running - Basics
|
|
|
|
By default this Image will start a `pygeoapi` Docker Container
|
|
using `gunicorn` on internal port 80.
|
|
|
|
To run with default built-in config and data:
|
|
|
|
```
|
|
docker run -p 5000:80 -it geopython/pygeoapi run
|
|
# or simply
|
|
docker run -p 5000:80 -it geopython/pygeoapi
|
|
|
|
# then browse to http://localhost:5000/
|
|
```
|
|
|
|
You can also run all unit tests to verify:
|
|
|
|
```
|
|
docker run -it geopython/pygeoapi test
|
|
```
|
|
|
|
## Running - Overriding the default config
|
|
|
|
Normally you would override the [default.config.yml](default.config.yml) with your own `pygeoapi` config.
|
|
This can be effected best via Docker Volume Mapping.
|
|
|
|
For example if your config is in `my.config.yml`:
|
|
|
|
```
|
|
docker run -p 5000:80 -v $(pwd)/my.config.yml:/pygeoapi/local.config.yml -it geopython/pygeoapi
|
|
```
|
|
|
|
But better/cleaner is to use `docker-compose`. Something like:
|
|
|
|
```
|
|
version: "3"
|
|
|
|
services:
|
|
|
|
pygeoapi:
|
|
image: geopython/pygeoapi
|
|
|
|
env_file:
|
|
- pygeoapi.env
|
|
|
|
volumes:
|
|
- ./my.config.yml:/pygeoapi/local.config.yml
|
|
|
|
```
|
|
|
|
See how the demo server is setup at
|
|
https://github.com/geopython/demo.pygeoapi.io/tree/master/services/pygeoapi
|
|
|
|
This also shows the `pygeoapi.env` file mainly needed when running from a sub-domain.
|
|
|
|
## Running - Running on your domain
|
|
|
|
By default the `pygeoapi` Docker Image will run from the `root` domain `/`.
|
|
If you need to run from a sub-domain and have all internal URLs correct
|
|
you need to set `SCRIPT_NAME` environment variable.
|
|
|
|
For example to run with `my.config.yml` on http://localhost:5000/mypygeoapi:
|
|
|
|
```
|
|
docker run -p 5000:80 -e SCRIPT_NAME='/mypygeoapi' -v $(pwd)/my.config.yml:/pygeoapi/local.config.yml -it geopython/pygeoapi
|
|
# browse to http://localhost:5000/mypygeoapi
|
|
```
|
|
|
|
See https://github.com/geopython/demo.pygeoapi.io/tree/master/services/pygeoapi
|
|
for an full example.
|
|
|
|
|
|
|