docker-ckan/_etc/README.md

38 lines
1.4 KiB
Markdown
Executable File

_etc
====
_This directory contains configuration files that are copied to /etc in the container when the Docker file is built, and when a child is built._
## Customisation
- Apache config
- CKAN config
- You can specify custom options in the custom_options.ini file, they will be applied to the default ini file.
- or override the default (generated) config with a volume
- filenames (of the config & custom_options file) can be overriden with environment variables
- Cron jobs
- Postfix config
- Supervisor managed processes
_Ngnix is not installed in the CKAN container anymore. Use the official Ngnix container, or a custom built container instead_
- Nginx conf is stored in this folder for consistency.
- The default config uses "ckan" as a hostname, the corresponding IP address is resolved by linking the ckan container, which adds an entry in `/etc/hosts` inside the container.
Make sure you link your CKAN container as `my_ckan:ckan` or change the config.
## Usage
### Building the CKAN image
_i.e. This docker file_
This will copy the files using the [Docker `ADD` instruction](https://docs.docker.com/reference/builder/#add)
### Building a child image
_i.e. A different Docker from the CKAN image (downstream build)_
This will override the files using the [Docker `ONBUILD` instruction](https://docs.docker.com/reference/builder/#onbuild)
This means that when building a child image, you should have the same directory structure.