kotovalexarian-likes-github/moby--moby
1
0
Fork 0
mirror of https://github.com/moby/moby.git synced 2022-11-09 12:21:53 -05:00
Code Releases Activity

Adding Kitematic link to Mac OS X install instructions

Browse source 
Signed-off-by: Jeffrey Morgan <jeff@kitematic.com>
This commit is contained in:
Jeffrey Morgan 2015-03-17 16:59:59 -07:00
parent f42acd070a
commit 3ddf5d7517
2 changed files with 40 additions and 33 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

BIN
docs/sources/installation/images/kitematic.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 14 KiB

73
docs/sources/installation/mac.md
View file

@ -1,5 +1,5 @@
page_title: Installation on Mac OS X page_title: Installation on Mac OS X
page_description: Instructions for installing Docker on OS X using boot2docker. page_description: Instructions for installing Docker on OS X using boot2docker.
page_keywords: Docker, Docker documentation, requirements, boot2docker, VirtualBox, SSH, Linux, OSX, OS X, Mac page_keywords: Docker, Docker documentation, requirements, boot2docker, VirtualBox, SSH, Linux, OSX, OS X, Mac
# Install Docker on Mac OS X # Install Docker on Mac OS X
@ -17,12 +17,20 @@ completely from RAM, is a small ~24MB download, and boots in approximately 5s.
Your Mac must be running OS X 10.6 "Snow Leopard" or newer to run Boot2Docker. Your Mac must be running OS X 10.6 "Snow Leopard" or newer to run Boot2Docker.
## How do you want to work with Docker?
You can set up Docker using the command line with Boot2Docker and the guide
below. Alternatively, you may want to try <a href="https://kitematic.com/" target="_blank">Kitematic</a>,
an application that lets you set up Docker and run containers using a graphical
user interface (GUI).
<a href="https://kitematic.com/" target="_blank"><img src="/installation/images/kitematic.png" alt="Download Kitematic"></a>
## Learn the key concepts before installing ## Learn the key concepts before installing
In a Docker installation on Linux, your machine is both the localhost and the In a Docker installation on Linux, your machine is both the localhost and the
Docker host. In networking, localhost means your computer. The Docker host is Docker host. In networking, localhost means your computer. The Docker host is
the machine on which the containers run. the machine on which the containers run.
On a typical Linux installation, the Docker client, the Docker daemon, and any On a typical Linux installation, the Docker client, the Docker daemon, and any
containers run directly on your localhost. This means you can address ports on a containers run directly on your localhost. This means you can address ports on a
@ -43,7 +51,7 @@ practice, work through the exercises on this page.
## Install Boot2Docker ## Install Boot2Docker
1. Go to the [boot2docker/osx-installer ]( 1. Go to the [boot2docker/osx-installer ](
https://github.com/boot2docker/osx-installer/releases/latest) release page. https://github.com/boot2docker/osx-installer/releases/latest) release page.
@ -65,10 +73,10 @@ To run a Docker container, you first start the `boot2docker` VM and then issue
`boot2docker` from your Applications folder or from the command line. `boot2docker` from your Applications folder or from the command line.
> **NOTE**: Boot2Docker is designed as a development tool. You should not use > **NOTE**: Boot2Docker is designed as a development tool. You should not use
> it in production environments. > it in production environments.
### From the Applications folder ### From the Applications folder
When you launch the "Boot2Docker" application from your "Applications" folder, the When you launch the "Boot2Docker" application from your "Applications" folder, the
application: application:
@ -85,9 +93,9 @@ your setup succeeded is to run the `hello-world` container.
$ docker run hello-world $ docker run hello-world
Unable to find image 'hello-world:latest' locally Unable to find image 'hello-world:latest' locally
511136ea3c5a: Pull complete 511136ea3c5a: Pull complete
31cbccb51277: Pull complete 31cbccb51277: Pull complete
e45a5af57b00: Pull complete e45a5af57b00: Pull complete
hello-world:latest: The image you are pulling has been verified. Important: image verification is a tech preview feature and should not be relied on to provide security. hello-world:latest: The image you are pulling has been verified. Important: image verification is a tech preview feature and should not be relied on to provide security.
Status: Downloaded newer image for hello-world:latest Status: Downloaded newer image for hello-world:latest
Hello from Docker. Hello from Docker.
@ -108,7 +116,7 @@ your setup succeeded is to run the `hello-world` container.
For more examples and ideas, visit: For more examples and ideas, visit:
http://docs.docker.com/userguide/ http://docs.docker.com/userguide/
A more typical way to start and stop `boot2docker` is using the command line. A more typical way to start and stop `boot2docker` is using the command line.
### From your command line ### From your command line
@ -121,7 +129,7 @@ Initialize and run `boot2docker` from the command line, do the following:
This creates a new virtual machine. You only need to run this command once. This creates a new virtual machine. You only need to run this command once.
2. Start the `boot2docker` VM. 2. Start the `boot2docker` VM.
$ boot2docker start $ boot2docker start
@ -134,19 +142,19 @@ Initialize and run `boot2docker` from the command line, do the following:
export DOCKER_HOST=tcp://192.168.59.103:2376 export DOCKER_HOST=tcp://192.168.59.103:2376
export DOCKER_CERT_PATH=/Users/mary/.boot2docker/certs/boot2docker-vm export DOCKER_CERT_PATH=/Users/mary/.boot2docker/certs/boot2docker-vm
export DOCKER_TLS_VERIFY=1 export DOCKER_TLS_VERIFY=1
The specific paths and address on your machine will be different. The specific paths and address on your machine will be different.
4. To set the environment variables in your shell do the following: 4. To set the environment variables in your shell do the following:
$ eval "$(boot2docker shellinit)" $ eval "$(boot2docker shellinit)"
You can also set them manually by using the `export` commands `boot2docker` You can also set them manually by using the `export` commands `boot2docker`
returns. returns.
5. Run the `hello-world` container to verify your setup. 5. Run the `hello-world` container to verify your setup.
$ docker run hello-world $ docker run hello-world
## Basic Boot2Docker Exercises ## Basic Boot2Docker Exercises
@ -156,7 +164,7 @@ environment initialized. To verify this, run the following commands:
$ boot2docker status $ boot2docker status
$ docker version $ docker version
Work through this section to try some practical container tasks using `boot2docker` VM. Work through this section to try some practical container tasks using `boot2docker` VM.
### Access container ports ### Access container ports
@ -164,25 +172,25 @@ Work through this section to try some practical container tasks using `boot2dock
1. Start an NGINX container on the DOCKER_HOST. 1. Start an NGINX container on the DOCKER_HOST.
$ docker run -d -P --name web nginx $ docker run -d -P --name web nginx
Normally, the `docker run` commands starts a container, runs it, and then Normally, the `docker run` commands starts a container, runs it, and then
exits. The `-d` flag keeps the container running in the background exits. The `-d` flag keeps the container running in the background
after the `docker run` command completes. The `-P` flag publishes exposed ports from the after the `docker run` command completes. The `-P` flag publishes exposed ports from the
container to your local host; this lets you access them from your Mac. container to your local host; this lets you access them from your Mac.
2. Display your running container with `docker ps` command 2. Display your running container with `docker ps` command
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
5fb65ff765e9 nginx:latest "nginx -g 'daemon of 3 minutes ago Up 3 minutes 0.0.0.0:49156->443/tcp, 0.0.0.0:49157->80/tcp web 5fb65ff765e9 nginx:latest "nginx -g 'daemon of 3 minutes ago Up 3 minutes 0.0.0.0:49156->443/tcp, 0.0.0.0:49157->80/tcp web
At this point, you can see `nginx` is running as a daemon. At this point, you can see `nginx` is running as a daemon.
3. View just the container's ports. 3. View just the container's ports.
$ docker port web $ docker port web
443/tcp -> 0.0.0.0:49156 443/tcp -> 0.0.0.0:49156
80/tcp -> 0.0.0.0:49157 80/tcp -> 0.0.0.0:49157
This tells you that the `web` container's port `80` is mapped to port This tells you that the `web` container's port `80` is mapped to port
`49157` on your Docker host. `49157` on your Docker host.
@ -198,7 +206,7 @@ Work through this section to try some practical container tasks using `boot2dock
$ boot2docker ip $ boot2docker ip
192.168.59.103 192.168.59.103
6. Enter the `http://192.168.59.103:49157` address in your browser: 6. Enter the `http://192.168.59.103:49157` address in your browser:
![Correct Addressing](/installation/images/good_host.png) ![Correct Addressing](/installation/images/good_host.png)
@ -209,7 +217,7 @@ Work through this section to try some practical container tasks using `boot2dock
$ docker stop web $ docker stop web
$ docker rm web $ docker rm web
### Mount a volume on the container ### Mount a volume on the container
When you start `boot2docker`, it automatically shares your `/Users` directory When you start `boot2docker`, it automatically shares your `/Users` directory
@ -219,7 +227,7 @@ The next exercise demonstrates how to do this.
1. Change to your user `$HOME` directory. 1. Change to your user `$HOME` directory.
$ cd $HOME $ cd $HOME
2. Make a new `site` directory. 2. Make a new `site` directory.
$ mkdir site $ mkdir site
@ -231,17 +239,17 @@ The next exercise demonstrates how to do this.
4. Create a new `index.html` file. 4. Create a new `index.html` file.
$ echo "my new site" > index.html $ echo "my new site" > index.html
5. Start a new `nginx` container and replace the `html` folder with your `site` directory. 5. Start a new `nginx` container and replace the `html` folder with your `site` directory.
$ docker run -d -P -v $HOME/site:/usr/share/nginx/html --name mysite nginx $ docker run -d -P -v $HOME/site:/usr/share/nginx/html --name mysite nginx
6. Get the `mysite` container's port. 6. Get the `mysite` container's port.
$ docker port mysite $ docker port mysite
80/tcp -> 0.0.0.0:49166 80/tcp -> 0.0.0.0:49166
443/tcp -> 0.0.0.0:49165 443/tcp -> 0.0.0.0:49165
7. Open the site in a browser: 7. Open the site in a browser:
![My site page](/installation/images/newsite_view.png) ![My site page](/installation/images/newsite_view.png)
@ -249,7 +257,7 @@ The next exercise demonstrates how to do this.
8. Try adding a page to your `$HOME/site` in real time. 8. Try adding a page to your `$HOME/site` in real time.
$ echo "This is cool" > cool.html $ echo "This is cool" > cool.html
9. Open the new page in the browser. 9. Open the new page in the browser.
![Cool page](/installation/images/cool_view.png) ![Cool page](/installation/images/cool_view.png)
@ -259,7 +267,7 @@ The next exercise demonstrates how to do this.
$ docker stop mysite $ docker stop mysite
$ docker rm mysite $ docker rm mysite
## Upgrade Boot2Docker ## Upgrade Boot2Docker
If you running Boot2Docker 1.4.1 or greater, you can upgrade Boot2Docker from If you running Boot2Docker 1.4.1 or greater, you can upgrade Boot2Docker from
the command line. If you are running an older version, you should use the the command line. If you are running an older version, you should use the
@ -274,7 +282,7 @@ To upgrade from 1.4.1 or greater, you can do this:
2. Stop the `boot2docker` application. 2. Stop the `boot2docker` application.
$ boot2docker stop $ boot2docker stop
3. Run the upgrade command. 3. Run the upgrade command.
$ boot2docker upgrade $ boot2docker upgrade
@ -292,13 +300,13 @@ To upgrade any version of Boot2Docker, do this:
3. Go to the [boot2docker/osx-installer ]( 3. Go to the [boot2docker/osx-installer ](
https://github.com/boot2docker/osx-installer/releases/latest) release page. https://github.com/boot2docker/osx-installer/releases/latest) release page.
4. Download Boot2Docker by clicking `Boot2Docker-x.x.x.pkg` in the "Downloads" 4. Download Boot2Docker by clicking `Boot2Docker-x.x.x.pkg` in the "Downloads"
section. section.
2. Install Boot2Docker by double-clicking the package. 2. Install Boot2Docker by double-clicking the package.
The installer places Boot2Docker in your "Applications" folder. The installer places Boot2Docker in your "Applications" folder.
## Learning more and Acknowledgement ## Learning more and Acknowledgement
@ -312,4 +320,3 @@ Thanks to Chris Jones whose [blog](http://goo.gl/Be6cCk) inspired me to redo
this page. this page.
Continue with the [Docker User Guide](/userguide/). Continue with the [Docker User Guide](/userguide/).