github.imxd.top/hashicorp/consul@v1.4.5/demo/vagrant-cluster/README.md (about)

     1  # Vagrant Consul Demo
     2  
     3  This demo provides a very simple `Vagrantfile` that creates two Consul
     4  server nodes, one at *172.20.20.10* and another at *172.20.20.11*. Both are
     5  running a standard Debian * distribution, and *the latest version* of Consul
     6  is pre-installed.
     7  
     8  To get started, you can start the nodes by just doing:
     9  
    10  ```
    11  vagrant up
    12  ```
    13  
    14  > NOTE: If you prefer a different Vagrant box, you can set the `DEMO_BOX_NAME`
    15  > environment variable before starting `vagrant` like this: 
    16  > `DEMO_BOX_NAME="ubuntu/xenial64" vagrant up`
    17  
    18  Once it is finished, you should be able to see the following:
    19  
    20  ```
    21  vagrant status
    22  Current machine states:
    23  
    24  n1                        running (virtualbox)
    25  n2                        running (virtualbox)
    26  ```
    27  
    28  At this point the two nodes are running and you can SSH in to play with them:
    29  
    30  ```
    31  vagrant ssh n1
    32  consul version
    33  Consul v0.7.5
    34  Protocol 2 spoken by default, understands 2 to 3 (agent will automatically use protocol >2 when speaking to compatible agents)
    35  exit
    36  ```
    37  
    38  and
    39  
    40  ```
    41  vagrant ssh n2
    42  consul version
    43  Consul v0.7.5
    44  Protocol 2 spoken by default, understands 2 to 3 (agent will automatically use protocol >2 when speaking to compatible agents)
    45  exit
    46  ```
    47  
    48  > NOTE: This demo will query the HashiCorp Checkpoint service to determine
    49  > the latest Consul release version and install that version by default,
    50  > but if you need a different Consul version, set the `CONSUL_DEMO_VERSION`
    51  > environment variable before `vagrant up` like this:
    52  > `CONSUL_DEMO_VERSION=0.6.4 vagrant up`
    53  
    54  ## Where to Next?
    55  
    56  To learn more about starting Consul, joining nodes into a cluster, and
    57  interacting with the agent, check out the [Getting Started guide](https://www.consul.io/intro/getting-started/install.html).