Enhance the readability of the docker-machine part

This commit is contained in:
niusmallnan
2018-08-16 09:48:59 -07:00
committed by Denise
parent 6c4d1e0f52
commit ffc6bc93a3
2 changed files with 32 additions and 29 deletions
@@ -9,7 +9,13 @@ Before we get started, you'll need to make sure that you have docker machine ins
### Downloading RancherOS
Get the latest `rancheros.iso` artifact from the RancherOS [releases](https://github.com/rancher/os/releases).
Get the latest ISO artifact from the RancherOS [releases](https://github.com/rancher/os/releases).
Machine Driver | ISO Name
-------------- | --------------------
VirtualBox | rancheros.iso
VMWare VSphere | rancheros-vmware.iso
VMWare Fusion | rancheros-vmware.iso
### Using Docker Machine
@@ -19,20 +25,16 @@ You can use Docker Machine to launch VMs for various providers. Currently Virtua
Before moving forward, you'll need to have VirtualBox installed. Download it directly from [VirtualBox](https://www.virtualbox.org/wiki/Downloads). Once you have VirtualBox and Docker Machine installed, it's just one command to get RancherOS running.
```
$ docker-machine create -d virtualbox --virtualbox-boot2docker-url <LOCATION-OF-RANCHEROS-ISO> <MACHINE-NAME>
```
Here is an example about using the RancherOS latest link:
<br>
```
$ docker-machine create -d virtualbox \
--virtualbox-boot2docker-url https://releases.rancher.com/os/latest/rancheros.iso \
<MACHINE-NAME>
```
> **Note:** Instead of downloading the ISO, you can directly use the URL for the `rancheros.iso`.
Example using the RancherOS latest link:
```
$ docker-machine create -d virtualbox --virtualbox-boot2docker-url https://releases.rancher.com/os/latest/rancheros.iso <MACHINE-NAME>
```
That's it! You should now have a RancherOS host running on VirtualBox. You can verify that you have a VirtualBox VM running on your host.
> **Note:** After the machine is created, Docker Machine may display some errors regarding creation, but if the VirtualBox VM is running, you should be able to [log in](#logging-into-rancheros).
@@ -49,16 +51,18 @@ _Available as of v1.4_
Before moving forward, you’ll need to have VMWare VSphere installed. Once you have VMWare VSphere and Docker Machine installed, it’s just one command to get RancherOS running.
```
$ docker-machine create --driver vmwarevsphere --vmwarevsphere-username=<USERNAME> --vmwarevsphere-password=<PASSWORD> --vmwarevsphere-memory-size=<MEMORY-SIZE> --vmwarevsphere-boot2docker-url=<LOCATION-OF-RANCHEROS-VMWARE-ISO> --vmwarevsphere-vcenter=<IP-ADDRESS> --vmwarevsphere-vcenter-port=<PORT> --vmwarevsphere-disk-size=<DISK-SIZE> <MACHINE-NAME>
```
> **Note:** Instead of downloading the RancherOS VMWare ISO, you can directly use the URL for the rancheros-vmware.iso.
Example using the RancherOS VMWare latest link:
Here is an example about using the RancherOS latest link:
```
$ docker-machine create --driver vmwarevsphere --vmwarevsphere-username <USERNAME> --vmwarevsphere-password <PASSWORD> --vmwarevsphere-memory-size <MEMORY-SIZE> --vmwarevsphere-boot2docker-url https://releases.rancher.com/os/latest/rancheros-vmware.iso --vmwarevsphere-vcenter <IP-ADDRESS> --vmwarevsphere-vcenter-port <PORT> --vmwarevsphere-disk-size <DISK-SIZE> <MACHINE-NAME>
$ docker-machine create -d vmwarevsphere \
--vmwarevsphere-username <USERNAME> \
--vmwarevsphere-password <PASSWORD> \
--vmwarevsphere-memory-size <MEMORY-SIZE> \
--vmwarevsphere-boot2docker-url https://releases.rancher.com/os/latest/rancheros-vmware.iso \
--vmwarevsphere-vcenter <IP-ADDRESS> \
--vmwarevsphere-vcenter-port <PORT> \
--vmwarevsphere-disk-size <DISK-SIZE> \
<MACHINE-NAME>
```
That’s it! You should now have a RancherOS host running on VMWare VSphere. You can verify that you have a VMWare(ESXi) VM running on your host.
@@ -69,21 +73,18 @@ _Available as of v1.4_
Before moving forward, you’ll need to have VMWare Fusion installed. Once you have VMWare Fusion and Docker Machine installed, it’s just one command to get RancherOS running.
```
$ docker-machine create --driver vmwarefusion --vmwarefusion-no-share --vmwarefusion-memory-size <MEMORY> --vmwarefusion-boot2docker-url <LOCATION-OF-RANCHEROS-VMWARE-ISO> <MACHINE_NAME>
```
> **Note:** Instead of downloading the RancherOS VMWare ISO, you can directly use the URL for the rancheros-vmware.iso.
Example using the RancherOS VMWare latest link:
Here is an example about using the RancherOS latest link:
```
$ docker-machine create --driver vmwarefusion --vmwarefusion-no-share --vmwarefusion-memory-size <MEMORY> --vmwarefusion-boot2docker-url https://releases.rancher.com/os/latest/rancheros-vmware.iso <MACHINE_NAME>
$ docker-machine create -d vmwarefusion \
--vmwarefusion-no-share \
--vmwarefusion-memory-size <MEMORY> \
--vmwarefusion-boot2docker-url https://releases.rancher.com/os/latest/rancheros-vmware.iso \
<MACHINE_NAME>
```
That’s it! You should now have a RancherOS host running on VMWare Fusion. You can verify that you have a VMWare Fusion VM running on your host.
### Logging into RancherOS
Logging into RancherOS follows the standard Docker Machine commands. To login into your newly provisioned RancherOS VM.
@@ -10,7 +10,9 @@ If you have a specific RanchersOS machine requirements, please check out our [gu
Before moving forward, you'll need to have [Docker Machine](https://docs.docker.com/machine/) and [VirtualBox](https://www.virtualbox.org/wiki/Downloads) installed. Once you have VirtualBox and Docker Machine installed, it's just one command to get RancherOS running.
```
$ docker-machine create -d virtualbox --virtualbox-boot2docker-url https://releases.rancher.com/os/latest/rancheros.iso <MACHINE-NAME>
$ docker-machine create -d virtualbox \
--virtualbox-boot2docker-url https://releases.rancher.com/os/latest/rancheros.iso \
<MACHINE-NAME>
```
That's it! You're up and running a RancherOS instance.