Axiomatic

Summary

Axiomatic is a GitHub webhook handler that launches dir2consul as a Nomad batch job.

Configuration

Axiomatic uses environment variables to override the default configuration values. The Nomad job definition for the Axiomatic service should be adjusted to set these variables.

AXIOMATIC_GITHUB_SECRET (required) is the secret token for validating webhook requests. There is no default value, only sorrow.
AXIOMATIC_IP is the IP address to bind. Default = 127.0.0.1
AXIOMATIC_PORT is the port number to bind. Default = 8181
AXIOMATIC_SSH_PRIV_KEY (required) is the private ssh key used for cloning repositories. It must be base64 encoded.
AXIOMATIC_SSH_PUB_KEY (required) is the public ssh key used for cloning repositories.
NOMAD_ADDR is the address of the Nomad server. Default = http://127.0.0.1:4646
NOMAD_NAMESPACE is the target namespace for queries and actions. Default = default
NOMAD_REGION is region of the Nomad servers to forward commands.
NOMAD_TOKEN is the SecretID of an ACL token to use to authenticate API requests.

Axiomatic passes environment variables, beginning with "CONSUL_" or "D2C_", through to dir2consul. This provides a convenient way to configure the dir2consul batch jobs launched by Axiomatic.

Installation

Axiomatic requires no installation. It ships as a Docker container meant for running as a service.

Usage

Run the service on Nomad

#> nomad job plan axiomatic.nomad
#> nomad job run -check-index 0 axiomatic.nomad

Setup the GitHub Repo Webhook and SSH Key

Open the Settings tab for your repo and choose "Deploy keys" in the menu
Add the ssh public key as a repository deploy key
Open the Settings tab for your repo and choose "Webhooks" in the menu
Press the "Add webhook" button
Enter your Axiomatic service URL in the Payload URL field. E.g. https://axiomatic.example.com/webhook
Enter your Axiomatic github secret in the Secret field
Press the "Add webhook" button

Health Check

Service health can be confirmed by making a web request to the '/health' path of the service.

Sequence Diagram

The following diagram depicts the sequence of the interactions between Axiomatic and related services.

Contributing

Please follow the Conventional Commits specification for your commit messages. Commit type options include: feat, fix, build, chore, ci, docs, style, refactor, perf, and test.

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

Author

Jim Razmus II

License

This project is licensed under the MIT License - see the LICENSE.txt file for details.

License

code42/axiomatic

ErrorLooks like something went wrong!

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 1

Packages 0

Uh oh!

Contributors 7

Uh oh!

Languages

Error
Looks like something went wrong!

Packages