X-Git-Url: https://vcs.fsf.org/?a=blobdiff_plain;f=README.md;h=9afa70d579a5eb904333e9ffdcef0a99dfe9c602;hb=000aa9de23e0735718d7a9bc00e223ea59f6d948;hp=8eab1bd94e7d5fb1312e9024708784f1a6a0a571;hpb=a7e2069eaad2bb72c8d16d6d715023c59a699962;p=discourse_docker.git diff --git a/README.md b/README.md index 8eab1bd..9afa70d 100644 --- a/README.md +++ b/README.md @@ -36,13 +36,9 @@ Placeholder spot for shared volumes with various Discourse containers. You may e #### `/image` -Dockerfile for both the base image `/discourse_base` and discourse image `/discourse`. +Dockerfiles for Discourse; see [the README](image/README.md) for further details. -- `/discourse_base` contains all the OS dependencies including runit, postgres, nginx, ruby. - -- `/discourse` builds on the base image and configures a discourse user and `/var/www/discourse` directory for the Discourse source. - -The Docker repository will always contain the latest built version at: https://index.docker.io/u/samsaffron/discourse/ , you should not need to build the base image. +The Docker repository will always contain the latest built version at: https://hub.docker.com/r/discourse/base/, you should not need to build the base image. ### Launcher @@ -86,7 +82,7 @@ expose: - "127.0.0.1:20080:80" ``` -Expose port 22 inside the container on port 2222 on ALL local host interfaces. In order to bind to only one interface, you may specify the host's IP address as `([:[host_port]])|():[/udp]` as defined in the [docker port binding documentation](http://docs.docker.com/userguide/dockerlinks/) +Publish port 22 inside the container on port 2222 on ALL local host interfaces. In order to bind to only one interface, you may specify the host's IP address as `([:[host_port]])|():[/udp]` as defined in the [docker port binding documentation](http://docs.docker.com/userguide/dockerlinks/). To expose a port without publishing it, specify only the port number (e.g., `80`). #### volumes: @@ -112,6 +108,32 @@ links: Links another container to the current container. This will add `--link postgres:postgres` to the options when running the container. +#### environment variables: + +Setting environment variables to the current container. + +``` +# app.yml + +env: + DISCOURSE_DB_HOST: some-host + DISCOURSE_DB_NAME: {{config}}_discourse +``` + +The above will add `-e DISCOURSE_DB_HOST=some-host -e DISCOURSE_DB_NAME=app_discourse` to the options when running the container. + +#### labels: +``` +# app.yml + +labels: + monitor: 'true' + app_name: {{config}}_discourse +``` + +Add labels to the current container. The above will add `--l monitor=true -l app_name=dev_discourse` to the options +when running the container + ### Upgrading Discourse The Docker setup gives you multiple upgrade options: @@ -188,7 +210,7 @@ then run: This will spawn a new Ubuntu VM, install Docker, and then await your instructions. You can then SSH into the VM with `vagrant ssh`, become `root` with `sudo -i`, and then you're right to go. Your live git repo is -already available at `/var/discourse`, so you can just `cd /var/discourse` +already available at `/vagrant`, so you can just `cd /vagrant` and then start running `launcher`.