kotovalexarian-likes-github
/
moby--moby
mirror of https://github.com/moby/moby.git
1
0
Fork 0
Code Releases Activity

Merge pull request #15462 from moxiegirl/add-migrate-windows-15454 

Updating new vm name, add migrate, and Windows 10 limitation
This commit is contained in:
moxiegirl 2015-08-10 15:13:08 -07:00
parent 0bfad28b86 e5c160e1d6
commit 4bfbeb80a6
2 changed files with 61 additions and 37 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

50
docs/installation/mac.md
View File

@ -47,7 +47,7 @@ Docker container using standard localhost addressing such as `localhost:8000` or
![Linux Architecture Diagram](/installation/images/linux_docker_host.svg) ![Linux Architecture Diagram](/installation/images/linux_docker_host.svg)
In an OS X installation, the `docker` daemon is running inside a Linux VM called In an OS X installation, the `docker` daemon is running inside a Linux VM called
`docker-vm`. The `docker-vm` is a lightweight Linux VM made specifically to run `default`. The `default` is a lightweight Linux VM made specifically to run
the Docker daemon on Mac OS X. The VM runs completely from RAM, is a small ~24MB the Docker daemon on Mac OS X. The VM runs completely from RAM, is a small ~24MB
download, and boots in approximately 5s. download, and boots in approximately 5s.
@ -130,7 +130,7 @@ There are two ways to use the installed tools, from the Docker Quickstart Termin
The application: The application:
* opens a terminal window * opens a terminal window
* creates a VM called `docker-vm` if it doesn't exists, starts the VM if it does * creates a VM called `default` if it doesn't exists, starts the VM if it does
* points the terminal environment to this VM * points the terminal environment to this VM
Once the launch completes, the Docker Quickstart Terminal reports: Once the launch completes, the Docker Quickstart Terminal reports:
@ -178,19 +178,19 @@ different shell such as C Shell but the commands are the same.
1. Create a new Docker VM. 1. Create a new Docker VM.
$ docker-machine create --driver virtualbox docker-vm $ docker-machine create --driver virtualbox default
Creating VirtualBox VM... Creating VirtualBox VM...
Creating SSH key... Creating SSH key...
Starting VirtualBox VM... Starting VirtualBox VM...
Starting VM... Starting VM...
To see how to connect Docker to this machine, run: docker-machine env docker-vm To see how to connect Docker to this machine, run: docker-machine env default
This creates a new `docker-vm` in VirtualBox. This creates a new `default` in VirtualBox.
![docker-vm](/installation/images/docker-vm.png) ![default](/installation/images/default.png)
The command also creates a machine configuration in the The command also creates a machine configuration in the
`~/.docker/machine/machines/docker-vm` directory. You only need to run the `~/.docker/machine/machines/default` directory. You only need to run the
`create` command once. Then, you can use `docker-machine` to start, stop, `create` command once. Then, you can use `docker-machine` to start, stop,
query, and otherwise manage the VM from the command line. query, and otherwise manage the VM from the command line.
@ -198,26 +198,26 @@ different shell such as C Shell but the commands are the same.
$ docker-machine ls $ docker-machine ls
NAME ACTIVE DRIVER STATE URL SWARM NAME ACTIVE DRIVER STATE URL SWARM
docker-vm * virtualbox Running tcp://192.168.99.101:2376 default * virtualbox Running tcp://192.168.99.101:2376
If you have previously installed the deprecated Boot2Docker application or If you have previously installed the deprecated Boot2Docker application or
run the Docker Quickstart Terminal, you may have a `dev` VM as well. When you run the Docker Quickstart Terminal, you may have a `dev` VM as well. When you
created `docker-vm`, the `docker-machine` command provided instructions created `default`, the `docker-machine` command provided instructions
for learning how to connect the VM. for learning how to connect the VM.
3. Get the environment commands for your new VM. 3. Get the environment commands for your new VM.
$ docker-machine env docker-vm $ docker-machine env default
export DOCKER_TLS_VERIFY="1" export DOCKER_TLS_VERIFY="1"
export DOCKER_HOST="tcp://192.168.99.101:2376" export DOCKER_HOST="tcp://192.168.99.101:2376"
export DOCKER_CERT_PATH="/Users/mary/.docker/machine/machines/docker-vm" export DOCKER_CERT_PATH="/Users/mary/.docker/machine/machines/default"
export DOCKER_MACHINE_NAME="docker-vm" export DOCKER_MACHINE_NAME="default"
# Run this command to configure your shell: # Run this command to configure your shell:
# eval "$(docker-machine env docker-vm)" # eval "$(docker-machine env default)"
4. Connect your shell to the `docker-vm` machine. 4. Connect your shell to the `default` machine.
$ eval "$(docker-machine env docker-vm)" $ eval "$(docker-machine env default)"
5. Run the `hello-world` container to verify your setup. 5. Run the `hello-world` container to verify your setup.
@ -227,14 +227,28 @@ different shell such as C Shell but the commands are the same.
## Learn about your Toolbox installation ## Learn about your Toolbox installation
Toolbox installs the Docker Engine binary, the Docker binary on your system. When you Toolbox installs the Docker Engine binary, the Docker binary on your system. When you
use the Docker Quickstart Terminal or create a `docker-vm` manually, Docker use the Docker Quickstart Terminal or create a `default` manually, Docker
Machine updates the `~/.docker/machine/machines/docker-vm` folder to your Machine updates the `~/.docker/machine/machines/default` folder to your
system. This folder contains the configuration for the VM. system. This folder contains the configuration for the VM.
You can create multiple VMs on your system with Docker Machine. So, you may have You can create multiple VMs on your system with Docker Machine. So, you may have
more than one VM folder if you have more than one VM. To remove a VM, use the more than one VM folder if you have more than one VM. To remove a VM, use the
`docker-machine rm <machine-name>` command. `docker-machine rm <machine-name>` command.
## Migrate from Boot2Docker
If you were using Boot2Docker previously, you have a pre-existing Docker
`boot2docker-vm` VM on your local system. To allow Docker Machine to manage
this older VM, you can migrate it.
1. Open a terminal or the Docker CLI on your system.
2. Type the following command.
$ docker-machine create -d virtualbox --virtualbox-import-boot2docker-vm boot2docker-vm docker-vm
3. Use the `docker-machine` command to interact with the migrated VM.
The `docker-machine` subcommands are slightly different than the `boot2docker` The `docker-machine` subcommands are slightly different than the `boot2docker`
subcommands. The table below lists the equivalent `docker-machine` subcommand subcommands. The table below lists the equivalent `docker-machine` subcommand
and what it does: and what it does:
@ -388,7 +402,7 @@ To uninstall, do the following:
NAME ACTIVE DRIVER STATE URL SWARM NAME ACTIVE DRIVER STATE URL SWARM
dev * virtualbox Running tcp://192.168.99.100:2376 dev * virtualbox Running tcp://192.168.99.100:2376
my-docker-machine virtualbox Stopped my-docker-machine virtualbox Stopped
docker-vm virtualbox Stopped default virtualbox Stopped
2. Remove each machine. 2. Remove each machine.

48
docs/installation/windows.md
View File

@ -29,12 +29,9 @@ The Docker VM is lightweight Linux virtual machine made specifically to run the
Docker daemon on Windows. The VirtualBox VM runs completely from RAM, is a Docker daemon on Windows. The VirtualBox VM runs completely from RAM, is a
small ~24MB download, and boots in approximately 5s. small ~24MB download, and boots in approximately 5s.
## Requirements ## Requirements
Your machine must be running Windows 7.1, 8/8.1 or newer to run Docker. Your machine must be running Windows 7.1, 8/8.1 or newer to run Docker. Windows 10 is not currently supported. To find out what version of Windows you have:
To find out what version of Windows you have:
1. Right click the Windows message and choose **System**. 1. Right click the Windows message and choose **System**.
@ -135,7 +132,6 @@ installer.
7. Press "Close" to exit. 7. Press "Close" to exit.
## Running a Docker Container ## Running a Docker Container
To run a Docker container, you: To run a Docker container, you:
@ -157,7 +153,7 @@ There are several ways to use the installed tools, from the Docker Quickstart Te
The application: The application:
* opens a terminal window * opens a terminal window
* creates a `docker-vm` if it doesn't exist, starts the VM if it does * creates a `default` if it doesn't exist, starts the VM if it does
* points the terminal environment to this VM * points the terminal environment to this VM
Once the launch completes, you can run `docker` commands. Once the launch completes, you can run `docker` commands.
@ -205,12 +201,12 @@ There are several ways to use the installed tools, from the Docker Quickstart Te
3. Create a new Docker VM. 3. Create a new Docker VM.
docker-machine create --driver virtualbox my-docker-vm docker-machine create --driver virtualbox my-default
Creating VirtualBox VM... Creating VirtualBox VM...
Creating SSH key... Creating SSH key...
Starting VirtualBox VM... Starting VirtualBox VM...
Starting VM... Starting VM...
To see how to connect Docker to this machine, run: docker-machine env my-docker-vm To see how to connect Docker to this machine, run: docker-machine env my-default
The command also creates a machine configuration in the The command also creates a machine configuration in the
`C:\USERS\USERNAME\.docker\machine\machines` directory. You only need to run the `create` `C:\USERS\USERNAME\.docker\machine\machines` directory. You only need to run the `create`
@ -221,18 +217,18 @@ There are several ways to use the installed tools, from the Docker Quickstart Te
C:\Users\mary> docker-machine ls C:\Users\mary> docker-machine ls
NAME ACTIVE DRIVER STATE URL SWARM NAME ACTIVE DRIVER STATE URL SWARM
my-docker-vm * virtualbox Running tcp://192.168.99.101:2376 my-default * virtualbox Running tcp://192.168.99.101:2376
If you have previously installed the deprecated Boot2Docker application or If you have previously installed the deprecated Boot2Docker application or
run the Docker Quickstart Terminal, you may have a `dev` VM as well. run the Docker Quickstart Terminal, you may have a `dev` VM as well.
5. Get the environment commands for your new VM. 5. Get the environment commands for your new VM.
C:\Users\mary> docker-machine env --shell cmd my-docker-vm C:\Users\mary> docker-machine env --shell cmd my-default
6. Connect your shell to the `my-docker-vm` machine. 6. Connect your shell to the `my-default` machine.
C:\Users\mary> eval "$(docker-machine env my-docker-vm)" C:\Users\mary> eval "$(docker-machine env my-default)"
7. Run the `hello-world` container to verify your setup. 7. Run the `hello-world` container to verify your setup.
@ -248,21 +244,21 @@ There are several ways to use the installed tools, from the Docker Quickstart Te
3. Create a new Docker VM. 3. Create a new Docker VM.
PS C:\Users\mary> docker-machine create --driver virtualbox my-docker-vm PS C:\Users\mary> docker-machine create --driver virtualbox my-default
4. List your available machines. 4. List your available machines.
C:\Users\mary> docker-machine ls C:\Users\mary> docker-machine ls
NAME ACTIVE DRIVER STATE URL SWARM NAME ACTIVE DRIVER STATE URL SWARM
my-docker-vm * virtualbox Running tcp://192.168.99.101:2376 my-default * virtualbox Running tcp://192.168.99.101:2376
5. Get the environment commands for your new VM. 5. Get the environment commands for your new VM.
C:\Users\mary> docker-machine env --shell powershell my-docker-vm C:\Users\mary> docker-machine env --shell powershell my-default
6. Connect your shell to the `my-docker-vm` machine. 6. Connect your shell to the `my-default` machine.
C:\Users\mary> eval "$(docker-machine env my-docker-vm)" C:\Users\mary> eval "$(docker-machine env my-default)"
7. Run the `hello-world` container to verify your setup. 7. Run the `hello-world` container to verify your setup.
@ -273,14 +269,28 @@ There are several ways to use the installed tools, from the Docker Quickstart Te
Toolbox installs the Docker Engine binary in the `C:\Program Files\Docker Toolbox installs the Docker Engine binary in the `C:\Program Files\Docker
Toolbox` directory. When you use the Docker Quickstart Terminal or create a Toolbox` directory. When you use the Docker Quickstart Terminal or create a
`docker-vm` manually, Docker Machine updates the `default` manually, Docker Machine updates the
`C:\USERS\USERNAME\.docker\machine\machines\docker-vm` folder to your `C:\USERS\USERNAME\.docker\machine\machines\default` folder to your
system. This folder contains the configuration for the VM. system. This folder contains the configuration for the VM.
You can create multiple VMs on your system with Docker Machine. So, you may have You can create multiple VMs on your system with Docker Machine. So, you may have
more than one VM folder if you have more than one VM. To remove a VM, use the more than one VM folder if you have more than one VM. To remove a VM, use the
`docker-machine rm <machine-name>` command. `docker-machine rm <machine-name>` command.
## Migrate from Boot2Docker
If you were using Boot2Docker previously, you have a pre-existing Docker
`boot2docker-vm` VM on your local system. To allow Docker Machine to manage
this older VM, you can migrate it.
1. Open a terminal or the Docker CLI on your system.
2. Type the following command.
$ docker-machine create -d virtualbox --virtualbox-import-boot2docker-vm boot2docker-vm docker-vm
3. Use the `docker-machine` command to interact with the migrated VM.
The `docker-machine` subcommands are slightly different than the `boot2docker` The `docker-machine` subcommands are slightly different than the `boot2docker`
subcommands. The table below lists the equivalent `docker-machine` subcommand subcommands. The table below lists the equivalent `docker-machine` subcommand
and what it does: and what it does: