Convert the example file to a proper readme with examples and additional details

This commit is contained in:
KemoNine 2019-01-06 19:15:33 +00:00
parent 96267eb2fd
commit 030e89d239
2 changed files with 56 additions and 12 deletions

56
docker/README.md Normal file
View File

@ -0,0 +1,56 @@
# Halcyon Docker
This Docker setup for Halcyon includes just Halcyon, php-fpm and the necessary locales for internationalization support in Halcyon.
You'll need to use the main repo's nginx/apache/caddy configs for reverse proxy to the container. traefik will likely work but is untested.
# Build Halcyon Container
``` sh
cd /opt/halcyon/docker
docker build -t halcyon/halcyon:latest .
```
# Configuration
The container has the official example configs stored at ```/var/www/html/config``` inside the image. You can copy the examples from the container to the server via a temporary container and volume.
The configs must be adjusted ahead of running the container for production use.
Please note: The container build will checkout the latest release of Halcyon which may *not* match the current master brach HEAD. It's advisable to use the below to copy the configs so you're using the same config examples as the version deployed in the container.
Example:
``` sh
cd /opt/halcyon
mkdir config
docker run --rm -it \
--entrypoint /bin/sh \
-v /opt/halcyon/config:/var/www/html/config \
halcyon/halcyon:latest
cp /var/www/html/config.example/* /var/www/html/config/
exit
```
# Running
An example for running the container is below.
``` sh
docker run \
--name halcyon \
--restart unless-stopped \
--net docker-private \
--ip 172.30.12.13 \
-e TZ=UTC \
-e DEBUG=1 \
-v /opt/halcyon/config:/var/www/html/config \
halcyon/halcyon:latest
```

View File

@ -1,12 +0,0 @@
docker build -t halcyon/halcyon:latest .
docker run --rm -it -p 9081:80 -v ${PWD}/config:/var/www/html/config test/halcyon:latest
docker run \
--name halcyon \
--restart unless-stopped \
--net docker-private \
--ip 172.30.12.13 \
-e TZ=UTC \
-e DEBUG=1 \
-v /opt/halcyon/config:/var/www/html/config \
test/halcyon:latest