Go to file

Sean Cross a8407e3ffe README: add note for saving repo root Signed-off-by: Sean Cross <sean@xobs.io>		2019-01-12 16:08:09 +08:00
.dockerignore	dockerignore: make it a copy of gitignore	2019-01-12 15:55:32 +08:00
.gitignore	gitignore: add swp/swo and repo root	2019-01-11 16:02:13 +08:00
Dockerfile	Dockerfile: don't run as root	2019-01-12 16:07:07 +08:00
index.js	index: one more tiny printing change	2019-01-12 15:52:41 +08:00
LICENSE	LICENSE: add file	2019-01-12 15:53:41 +08:00
package-lock.json	cmdline: add arguments	2019-01-12 13:54:30 +08:00
package.json	package: add repository, license, author	2019-01-12 15:40:07 +08:00
README.md	README: add note for saving repo root	2019-01-12 16:08:09 +08:00

README.md

Reveal Server

Installation

Install dependent packages with npm:

npm i

Or build a Docker image:

docker build -t reveal-serve .

Usage

Run on your server. Specify a secret with the s option. Create a webhook that fires on the "push" event.

Ensure that your repo has a "website" configured. The last component of this path will be used on the server.

Docker

There are some environment variables that can be used to configure the server:

RV_PREFIXES: A comma-separated list of acceptable prefixes. For example, to allow GitHub, set RV_PREFIXES=https://github.com, or to enable only your repo set RV_PREFIXES=https://github.com/username/. If a prefix does not match, it will not be loaded.
RV_SECRET: The contents of a secret that is shipped as part of the webhook.
RV_LISTEN_PORT: The port number to listen to. Defaults to 9119.
RV_LISTEN_ADDR: The local address to listen to. Defaults to 0.0.0.0
RV_ROOT: The root where all repos will go to.

An example invocation would be:

mkdir repo-root && chown 1000 repo-root
docker run \
    -d \
    --restart unless-stopped \
    --log-opt max-size=10m \
    --name=reveal-serve \
    -p 9119:80 \
    -e RV_PREFIXES=https://github.com/example \
    -e RV_SECRET=rvsecretkey \
    -e RV_ROOT=/data \
    -v $(pwd)/repo-root:/data \
    reveal-serve