open-consul/demo/vagrant-cluster/README.md
Brian Shumate e8e6af9fd6
Update demo
- Add DEMO_BOX_NAME env var for specifing different boxes (#2153)
- Update default box to debian/jessie64
- Update README
2016-11-21 12:49:59 -05:00

51 lines
1.3 KiB
Markdown

# Vagrant Consul Demo
This demo provides a very simple `Vagrantfile` that creates two Consul
server nodes, one at *172.20.20.10* and another at *172.20.20.11*. Both are
running a standard Debian * distribution, and Consul is pre-installed.
To get started, you can start the nodes by just doing:
```
vagrant up
```
> NOTE: If you prefer a different Vagrant box, you can set the `DEMO_BOX_NAME`
> environment variable before Starting Vagrant like this:
> `DEMO_BOX_NAME="ubuntu/xenial64" vagrant up`
Once it is finished, you should be able to see the following:
```
vagrant status
Current machine states:
n1 running (virtualbox)
n2 running (virtualbox)
```
At this point the two nodes are running and you can SSH in to play with them:
```
vagrant ssh n1
consul version
Consul v0.7.1
Protocol 2 spoken by default, understands 2 to 3 (agent will automatically use protocol >2 when speaking to compatible agents)
exit
```
and
```
vagrant ssh n2
consul version
Consul v0.7.1
Protocol 2 spoken by default, understands 2 to 3 (agent will automatically use protocol >2 when speaking to compatible agents)
exit
```
## Where to Next?
To learn more about starting Consul, joining nodes to a cluster, and
interacting with the agent, check out the [Getting Started guide](https://www.consul.io/intro/getting-started/install.html).