packer-server

• Static File Server for the app files
• clones the desired repository in the desired branch
• listens for pushes to the branch (see git-spy and github-webhook-forwarding)
• pulls the latests changes from the branch every time there is a push
• more (TODO: document it)

Installation

$ npm i -g packer-server

Usage:

See configure and launch your service in vigour-config for information on how to configure and launch the packer-server and where to get more info for all the configuration options.

npm start

As a minimum, you must set the following configuration options:

• repo (MAIL_MAN_REPO)
• branch (MAIL_MAN_BRANCH)
• gwfURL (GIT_SPY_GWF_URL)
• gwfUser (GIT_SPY_GWF_USER)
• gwfPass (GIT_SPY_GWF_PASS)

If serving an app found in a private repository, make sure you have the permissions to access it via the git command (this is what packer-server uses internally).

You will probably also want to set the following unless you're just launching a single packer locally for testing.

• port (PACKER_SERVER_PORT)
• gitSpyPort (GIT_SPY_PORT)

Other options are available (see the package)

npm test

Some of the tests will launch a real packer, which will try to subscribe to a github-webhook-forwarding service and need its URL and proper credentials. credentials we don't want to put in the repo. Please set the following environment variables instead:

• GWF_TEST_OWNER
• GWF_TEST_USER
• GWF_TEST_PASS
• GWF_TEST_PORT (optional, default: 8000)

example:

$ export GWF_TEST_OWNER=vigour
$ export GWF_TEST_USER=vigourbot
$ export GWF_TEST_PASS=OMGthisissoooooosecret

how it works:

• mail-man clones the specified branch of the specified repo in the directory where you launched packer-server.
• git-spy subscribes to the repo and branch on the github-webhook-forwarding process reachable via gwfURL, which registers a WebHook on GitHub to listen for pushes.
• packer-server serves the files found at dist/<platform> of the cloned repo, where <platform> is selected by looking at the request's User-Agent header.
• When a push is made to the specified repo and branch, the packer will pull and serve the new version automatically.