smuggle v1.0.4

Smuggle

Install

$ npm i

Config

Generate a starter config.

$ smuggle init

Run

$ smuggle [--config smuggle.json]

Options

Example Config

{
    "repos": {
        "smuggle-test": {
            "type": "gitlab",
            "path": "/home/user/localhost/smuggle-test",
            "requiredHeaders": {
                "x-gitlab-event": "Pipeline Hook",
                "x-gitlab-token": "abc123"
            },
            "requiredProps": {
                "object_attributes.status": "success"
            },
            "reset": true,
            "action": "pull",
            "branch": "master",
            "postActions": [
                "echo 'Building application'",
                "npm run build",
                "echo 'Restarting PM2 instance'",
                "pm2 restart smuggle-test",
                "echo 'Cleaning up'",
                "sh /path/to/cleanup.sh"
            ]
        }
    }
}

Running sudo Commands

Experimental

If you need to execute postActions as root, run Smuggle as a user with privileges.

# Run Smuggle as 'myuser', assuming there
# is a 'smuggle.json' in the same directory
$ su -c smuggle myuser

# Run Smuggle as 'myuser' with options
$ su - myuser -c 'smuggle --config "/path/to/smuggle.json"'

Testing via Docker

The Docker/Compose files will start a PM2 session. The example includes a client, server, and Smuggle instance. You can have your existing Docker setup run Smuggle, or modify the example to pull a different repository.

See example/environment.json for PM2 config.

Running the example with docker-compose build && docker-compose up will:

• Clone the sample repo
• Run NPM install
• Build client assets (Webpack in this case)
• Copy the Smuggle config to the container
• Start the API server, client, and Smuggle via PM2

You can use something like LocalTunnel to temporarily get a HTTPS link to your container, and use that to test your webhook via GitLab or GitHub.

$ lt -p 3100 # Smuggle port for this example

TODO

• Add option to verify os.hostname() matches payload's reported host
• Handle sudo more intelligently