redo readme
This commit is contained in:
Christine Dodrill
parent
a0f84fd8fe
commit
89a8593cc6
115
README.md
115
README.md
|
|
@ -1,76 +1,81 @@
|
||||||
# RancherOS Vagrant
|
Rancher Swarm
|
||||||
|
=============
|
||||||
|
|
||||||
Quickly checkout RancherOS using Vagrant/Virtualbox.
|
A simple tutorial on how to make a Docker swarm cluster on top of Vagrant.
|
||||||
|
|
||||||
|
For this you need at least 3 GB of ram free on your computer. This might work
|
||||||
|
with less if you change the ram levels, but just have at least 3 GB of ram free
|
||||||
|
just in case.
|
||||||
|
|
||||||
## Getting started
|
How to cluster
|
||||||
1.) Install dependencies
|
--------------
|
||||||
|
|
||||||
* Virtualbox (Tested with 4.3.22)
|
First, you need the machines to cluster:
|
||||||
* Vagrant (Tested with 1.7.2)
|
|
||||||
|
|
||||||
2.) Clone this project
|
```console
|
||||||
|
$ vagrant up
|
||||||
```
|
|
||||||
git clone https://github.com/rancherio/os-vagrant.git
|
|
||||||
cd os-vagrant
|
|
||||||
```
|
```
|
||||||
|
|
||||||
3.) Up and Running
|
Now, you need a docker swarm discovery token:
|
||||||
|
|
||||||
```
|
```console
|
||||||
vagrant up
|
$ docker run --rm swarm create
|
||||||
vagrant ssh
|
fd243153d366c4fc088de73681b884ad
|
||||||
```
|
```
|
||||||
|
|
||||||
Start running Docker like you usually would!
|
First you'll need to get the first runner online and waiting in the cluster.
|
||||||
|
|
||||||
## Enable Rsync folder sync
|
```console
|
||||||
If you want to sync the current working directory via rsync edit the Vagrantfile and change this line:
|
$ vagrant ssh runner-01
|
||||||
|
runner-01$ sudo ros c set user_docker.args '[docker, -d, -s, overlay, -G, docker, -H, unix:///var/run/docker.sock, -H, tcp://0.0.0.0:2375]'
|
||||||
<pre>$rsync_folder_disabled = true</pre>
|
runner-01$ sudo system-docker restart docker
|
||||||
|
|
||||||
to
|
|
||||||
|
|
||||||
<pre>
|
|
||||||
$rsync_folder_disabled = <b>false</b>
|
|
||||||
</pre>
|
|
||||||
## Upgrading RancherOS Versions
|
|
||||||
|
|
||||||
To upgrade the Vagrant box, refresh this repository from master.
|
|
||||||
|
|
||||||
```
|
|
||||||
vagrant destroy
|
|
||||||
vagrant box remove rancheros
|
|
||||||
vagrant up
|
|
||||||
```
|
```
|
||||||
|
|
||||||
|
Now have that machine join the cluster:
|
||||||
|
|
||||||
### Customizing and configuring
|
```console
|
||||||
|
runner-01$ docker run --name swarm -d swarm join --addr=172.19.8.101:2375 token://fd243153d366c4fc088de73681b884ad
|
||||||
|
```
|
||||||
|
|
||||||
|
Repeat this for the other two nodes.
|
||||||
|
|
||||||
To get a feel for how things work under the hood checkout the
|
Now connect to the management vm:
|
||||||
[RancherOS Repo](https://github.com/rancherio/os) for details.
|
|
||||||
|
|
||||||
## Contact
|
```console
|
||||||
For bugs, questions, comments, corrections, suggestions, etc., open an issue in
|
$ vagrant ssh manager
|
||||||
[rancher/os](//github.com/rancher/os/issues) with a title starting with `[os-vagrant] `.
|
manager$ docker run -d -p 2375:2375 swarm manage token://fd243153d366c4fc088de73681b884ad
|
||||||
|
```
|
||||||
|
|
||||||
Or just [click here](//github.com/rancher/os/issues/new?title=%5Bos-vagrant%5D%20) to create a new issue.
|
You now have a working cluster. Now to prove it:
|
||||||
|
|
||||||
|
```console
|
||||||
|
$ docker -H tcp://172.19.8.104:2375 info
|
||||||
|
Containers: 3
|
||||||
|
Images: 3
|
||||||
|
Role: primary
|
||||||
|
Strategy: spread
|
||||||
|
Filters: affinity, health, constraint, port, dependency
|
||||||
|
Nodes: 3
|
||||||
|
runner-01: 172.19.8.101:2375
|
||||||
|
└ Containers: 1
|
||||||
|
└ Reserved CPUs: 0 / 1
|
||||||
|
└ Reserved Memory: 0 B / 1.025 GiB
|
||||||
|
└ Labels: executiondriver=native-0.2, kernelversion=3.19.8-ckt1-rancher, operatingsystem=<unknown>, storagedriver=overlay
|
||||||
|
runner-02: 172.19.8.102:2375
|
||||||
|
└ Containers: 1
|
||||||
|
└ Reserved CPUs: 0 / 1
|
||||||
|
└ Reserved Memory: 0 B / 1.025 GiB
|
||||||
|
└ Labels: executiondriver=native-0.2, kernelversion=3.19.8-ckt1-rancher, operatingsystem=<unknown>, storagedriver=overlay
|
||||||
|
runner-03: 172.19.8.103:2375
|
||||||
|
└ Containers: 1
|
||||||
|
└ Reserved CPUs: 0 / 1
|
||||||
|
└ Reserved Memory: 0 B / 1.025 GiB
|
||||||
|
└ Labels: executiondriver=native-0.2, kernelversion=3.19.8-ckt1-rancher, operatingsystem=<unknown>, storagedriver=overlay
|
||||||
|
CPUs: 3
|
||||||
|
Total Memory: 3.075 GiB
|
||||||
|
Name: 66d026cc952c
|
||||||
|
```
|
||||||
|
|
||||||
# License
|
You may need to unset `DOCKER_TLS_VERIFY` depending on your configuration.
|
||||||
Copyright (c) 2014-2015 [Rancher Labs, Inc.](http://rancher.com)
|
|
||||||
|
|
||||||
Licensed under the Apache License, Version 2.0 (the "License");
|
|
||||||
you may not use this file except in compliance with the License.
|
|
||||||
You may obtain a copy of the License at
|
|
||||||
|
|
||||||
[http://www.apache.org/licenses/LICENSE-2.0](http://www.apache.org/licenses/LICENSE-2.0)
|
|
||||||
|
|
||||||
Unless required by applicable law or agreed to in writing, software
|
|
||||||
distributed under the License is distributed on an "AS IS" BASIS,
|
|
||||||
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
||||||
See the License for the specific language governing permissions and
|
|
||||||
limitations under the License.
|
|
||||||
|
|
||||||
|
Now you have a working docker swarm!
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue