HashiBox

HashiBox is a local environment to simulate a highly-available cloud with Consul, Nomad, and Vault. OSS and Enterprise versions of each product are supported.

Waypoint can be added but is optional.

It also installs Docker for running Nomad's jobs inside containers.

It leverages Vagrant for virtualization, and Bolt for maintenance automation across nodes.

The main goal is to provide a local environment simulating a HashiCorp Cloud Platform setup as close as possible. This allows to test projects from end-to-end before going live.

Vagrant providers supported:

• parallels
• virtualbox
• vmware_desktop

Architectures supported:

• amd64
• arm64

Notes about the environment:

• To simplify the setup, ACL and TLS across Consul, Nomad, Vault, and Waypoint are not configured. Feel free to make a pull request to support it.
• Only Vault server is leveraged. Vault agents in client mode are not setup since we don't use it. Feel free to make a pull request to support it.
• We could have leveraged Vagrant's sync folders instead of Bolt for file sharing with machines. Bolt is a better choice for production-practices but also for automating scripts across nodes.

Documentation

Getting started:

1. Introduction
2. Installation
3. Vault initialization

Other documents:

• Adding Waypoint
• Maintenance cheatsheet

Screenshots

Consul

Nomad

Vault

Waypoint

License

Repository licensed under the Mozilla Public License, version 2.0.