gemini-agate-image/README.md

# Gemini Agate Image

This image allowes to publish static content locate in a git repository on Gemini. Based on Agate gemini server.

This images takes these environment variables:

| variable | description | default value | 
| --- | --- | --- |
| `GEMINI_DOMAIN` | domain name of the capsule | example.com |
| `GEMINI_GIT_REPO` | url of the git repository containing content | `https://gitlab.com/valvin/gemini-agate-image` |
| `GEMINI_CONTENT_FOLDER` | folder inside the git repository which contains the content. it means you have `content` folder in your repo with default | `content`|
| `GEMINI_GIT_PATH` | path in which git repository will be cloned | `/app/data` |
| `GEMINI_CERT_PATH` | path which contains certificates. this path has to be a volume if not new certs will be generated | `/certs` |
| `GEMINI_LANG` | langage of the content | `fr-FR` |

image take those commands:

* none or `run` : launch agate after initialization process
* `update`: update repository content

initialization process is:
  * check if cert are present in `GEMINI_CERT_PATH` if not it creates it
  * clone or update the content repository
  * launch agate

docker command example:

```
docker run --rm -it -e GEMINI_DOMAIN=mydomain.tld \
  -e GEMINI_GIT_REPO=https://gitlab.com/valvin/gemini-agate-image \
  -v $(pwd)/certs:/certs -p 1965:1965
  registry.gitlab.com/valvin/gemini-agate-image:latest
```