39 lines
1.5 KiB
Markdown
39 lines
1.5 KiB
Markdown
# Description
|
|
|
|
This is a deployment of [Dokku](https://github.com/dokku/dokku), a docker-powered PaaS that helps you build and manage the lifecycle of applications.
|
|
|
|
# Configuration
|
|
|
|
In order to configure apps use the `dokku_apps` variable:
|
|
|
|
```yaml
|
|
dokku_apps:
|
|
- name: 'my-awesome-bot'
|
|
repo: 'https://github.com/status-im/my-awesome-bot'
|
|
env:
|
|
APP_ID: 12345
|
|
LOG_LEVEL: debug
|
|
WEBHOOK_SECRET: 'my-github-webhook-secret'
|
|
PRIVATE_KEY: 'my-secret-private-key'
|
|
```
|
|
|
|
# Known Issues
|
|
|
|
## Docker Container Renaming
|
|
|
|
Because we redirect logs to `rsyslog` and then to files in `/var/log/docker` as well as Logstash, and the way Docker handles container renaming, when Dokku renames containers their logs still flow to the randomly generated name, rather then the propper app name.
|
|
|
|
For this reason a hacky workaround has been added to the [`tasks/post_config.yml`](tasks/post_config.yml) file which modifies Dokku script files.
|
|
|
|
For more details see: https://github.com/docker/for-linux/issues/582
|
|
|
|
## Docker User Namespaces
|
|
|
|
Currently Dokku is unable to properly work with Docker user namespace settings.
|
|
|
|
For that reason we are using a hacky workaround in [`tasks/dockremap.yml`](tasks/dockremap.yml) which simply changes the user in Docker `userns-remap` setting to `dokku` rather than `dockremap`.
|
|
|
|
This allows us to use to the user namespaces without getting `chmod` errors on container start.
|
|
|
|
For more details see: https://github.com/dokku/dokku/issues/3454
|