Task based docker

[renoirb]

Hi again @darobin

Here’s the new Docker container for Publican.

Differences:

• No need to rsync, let’s make frontend web server use what’s in data/publish/ directly
• Named anonymous functions in JavaScript code. It was confusing debugging without it
• Everything is written in data/ (what publican writes), and specs-data/ (for Bikeshed) as a Docker volume so that the Docker container remains untouched and what it generates remains outside of it.
• Bikeshed and PhantomJS should run

Known issues

• PhantomJS times out and its unclear what’s missing

How to run

The WebPlatform specs.production.wpdn VM has everything needed to run. But if you want to run it locally, here are the steps. Also you might want to read the DOCKER.md file.

On a server that has Docker installed.

1. Pull the new image

   docker pull webspecs/publican:latest
   

2. Create a few directories

   mkdir -p data/{queue,gits,logs,temp}
   mkdir -p spec-data/read-only
   

3. Make sure directory data/ is owned by uid=999(app-user) and gid=999(app-user). The group and user names doesn’t matter, its their ids that matter.

4. Create config file in data/config.json

   • Bikeshed is in /opt/bikeshed/bikeshed.py
   • Homedir is in /srv/webplatform/specs/

5. Run container

   docker run -it --rm -p 7002:7002 -v "$(pwd)/data":/srv/webplatform/specs/data -v "$(pwd)/spec-data":/opt/bikeshed/bikeshed/spec-data webspecs/publican:latest
   

Run it on WebPlatform infrastructure!

The container is ready in a dedicated VM.

ssh specs.production.wpdn
cd /srv/webplatform/publican-workbench/repo

Run containers like this;

• Run from within the container

  sudo -s
  make docker-bash
  

• Run an instance and send a hook call

  make docker-run
  

  from another terminal, issue a cURL command

    curl -H "Content-Type: application/json" -XPOST localhost:7002/hook -d '{"base_ref":"master","repository":{"name":"assets","owner":{"name":"webspecs"}}}'
  

  you should see;

    {"ok":true,"details":"Queued 1431380611165-28770219 for processing."}
  

See also

• DOCKER.md attached to this pull request
• webspecs/publican on Docker hub
• Parent task is Create publican runner to use as an utility to compile on hooks webplatform/ops#153

[renoirb]

Screenshots!

make docker-bash

You can initialize an empty workspace using publican.js init, it’ll write in data/ that should already be mounted through the Makefile.

make docker-run

Run a container, and send a hook call

On another terminal tab, I issued;

  curl -H "Content-Type: application/json" -XPOST localhost:7002/hook -d '{"base_ref":"master","repository":{"name":"assets","owner":{"name":"webspecs"}}}'

[renoirb]

Wrote instructions on how to run a prebuilt instance locally, like we’ll do in production.