mirror of https://github.com/docker/docs.git
Restructure navigation for Editions
This commit is contained in:
parent
132f33de6f
commit
50de4479a1
192
_data/toc.yaml
192
_data/toc.yaml
|
@ -1,6 +1,96 @@
|
|||
toc:
|
||||
- title: Welcome to the Docs
|
||||
path: /
|
||||
- sectiontitle: Get Docker
|
||||
section:
|
||||
- path: /engine/installation/
|
||||
title: Install Docker Engine
|
||||
- sectiontitle: Docker for Mac
|
||||
section:
|
||||
- path: /docker-for-mac/
|
||||
title: Getting Started
|
||||
- path: /docker-for-mac/docker-toolbox/
|
||||
title: Docker for Mac vs. Docker Toolbox
|
||||
- path: /docker-for-mac/multi-arch/
|
||||
title: Leveraging Multi-CPU Architecture Support
|
||||
- path: /docker-for-mac/networking/
|
||||
title: Networking
|
||||
- path: /docker-for-mac/osxfs/
|
||||
title: File system sharing
|
||||
- path: /docker-for-mac/troubleshoot/
|
||||
title: Logs and Troubleshooting
|
||||
- path: /docker-for-mac/faqs/
|
||||
title: FAQs
|
||||
- path: /docker-for-mac/examples/
|
||||
title: Example Applications
|
||||
- path: /docker-for-mac/opensource/
|
||||
title: Open Source Licensing
|
||||
- path: /docker-for-mac/release-notes/
|
||||
title: Release Notes
|
||||
- sectiontitle: Docker for Windows
|
||||
section:
|
||||
- path: /docker-for-windows/
|
||||
title: Getting Started
|
||||
- path: /docker-for-windows/troubleshoot/
|
||||
title: Logs and Troubleshooting
|
||||
- path: /docker-for-windows/faqs/
|
||||
title: FAQs
|
||||
- path: /docker-for-windows/examples/
|
||||
title: Example Applications
|
||||
- path: /docker-for-windows/opensource/
|
||||
title: Open Source Licensing
|
||||
- path: /docker-for-windows/release-notes/
|
||||
title: Release Notes
|
||||
- sectiontitle: Docker for Linux
|
||||
section:
|
||||
- path: /engine/installation/linux/ubuntulinux/
|
||||
title: Installation on Ubuntu
|
||||
- path: /engine/installation/linux/rhel/
|
||||
title: Installation on Red Hat Enterprise Linux
|
||||
- path: /engine/installation/linux/centos/
|
||||
title: Installation on CentOS
|
||||
- path: /engine/installation/linux/fedora/
|
||||
title: Installation on Fedora
|
||||
- path: /engine/installation/linux/debian/
|
||||
title: Installation on Debian
|
||||
- path: /engine/installation/linux/archlinux/
|
||||
title: Installation on Arch Linux
|
||||
- path: /engine/installation/linux/cruxlinux/
|
||||
title: Installation on CRUX Linux
|
||||
- path: /engine/installation/linux/gentoolinux/
|
||||
title: Installation on Gentoo
|
||||
- path: /engine/installation/linux/oracle/
|
||||
title: Installation on Oracle Linux
|
||||
- path: /engine/installation/linux/SUSE/
|
||||
title: Installation on openSUSE and SUSE Linux Enterprise
|
||||
- path: /engine/installation/binaries/
|
||||
title: Installation from binaries
|
||||
- sectiontitle: Docker for AWS
|
||||
section:
|
||||
- path: /docker-for-aws/
|
||||
title: Setup & Prerequisites
|
||||
- path: /docker-for-aws/scaling/
|
||||
title: Scaling
|
||||
- path: /docker-for-aws/upgrade/
|
||||
title: Upgrading
|
||||
- path: /docker-for-aws/faqs/
|
||||
title: FAQs
|
||||
- path: /docker-for-aws/opensource/
|
||||
title: Open Source Licensing
|
||||
- path: /docker-for-aws/release-notes/
|
||||
title: Release Notes
|
||||
- sectiontitle: Docker for Azure
|
||||
section:
|
||||
- path: /docker-for-azure/
|
||||
title: Setup & Prerequisites
|
||||
- path: /docker-for-azure/upgrade/
|
||||
title: Upgrading
|
||||
- path: /docker-for-azure/faqs/
|
||||
title: FAQs
|
||||
- path: /docker-for-azure/opensource/
|
||||
title: Open Source Licensing
|
||||
- path: /docker-for-azure/release-notes/
|
||||
title: Release Notes
|
||||
- sectiontitle: Docker ID
|
||||
section:
|
||||
- path: /docker-id/
|
||||
|
@ -9,44 +99,6 @@ toc:
|
|||
title: API Reference
|
||||
- sectiontitle: Docker Engine
|
||||
section:
|
||||
- sectiontitle: Install
|
||||
section:
|
||||
- path: /engine/installation/mac/
|
||||
title: Installation on macOS
|
||||
- path: /engine/installation/windows/
|
||||
title: Installation on Windows
|
||||
- sectiontitle: On Linux distributions
|
||||
section:
|
||||
- path: /engine/installation/linux/ubuntulinux/
|
||||
title: Installation on Ubuntu
|
||||
- path: /engine/installation/linux/rhel/
|
||||
title: Installation on Red Hat Enterprise Linux
|
||||
- path: /engine/installation/linux/centos/
|
||||
title: Installation on CentOS
|
||||
- path: /engine/installation/linux/fedora/
|
||||
title: Installation on Fedora
|
||||
- path: /engine/installation/linux/debian/
|
||||
title: Installation on Debian
|
||||
- path: /engine/installation/linux/archlinux/
|
||||
title: Installation on Arch Linux
|
||||
- path: /engine/installation/linux/cruxlinux/
|
||||
title: Installation on CRUX Linux
|
||||
- path: /engine/installation/linux/gentoolinux/
|
||||
title: Installation on Gentoo
|
||||
- path: /engine/installation/linux/oracle/
|
||||
title: Installation on Oracle Linux
|
||||
- path: /engine/installation/linux/SUSE/
|
||||
title: Installation on openSUSE and SUSE Linux Enterprise
|
||||
- sectiontitle: On cloud providers
|
||||
section:
|
||||
- path: /engine/installation/cloud/overview/
|
||||
title: Choose how to install
|
||||
- path: /engine/installation/cloud/cloud-ex-aws/
|
||||
title: "Example: Manual install on cloud provider"
|
||||
- path: /engine/installation/cloud/cloud-ex-machine-ocean/
|
||||
title: "Example: Use Docker Machine to provision cloud hosts"
|
||||
- path: /engine/installation/binaries/
|
||||
title: Installation from binaries
|
||||
- sectiontitle: Get Started with Docker
|
||||
section:
|
||||
- path: /engine/getstarted/
|
||||
|
@ -513,70 +565,6 @@ toc:
|
|||
title: Deprecated Engine Features
|
||||
- path: /engine/faq/
|
||||
title: FAQ
|
||||
- sectiontitle: Get Docker
|
||||
section:
|
||||
- sectiontitle: Docker for Mac
|
||||
section:
|
||||
- path: /docker-for-mac/
|
||||
title: Getting Started
|
||||
- path: /docker-for-mac/docker-toolbox/
|
||||
title: Docker for Mac vs. Docker Toolbox
|
||||
- path: /docker-for-mac/multi-arch/
|
||||
title: Leveraging Multi-CPU Architecture Support
|
||||
- path: /docker-for-mac/networking/
|
||||
title: Networking
|
||||
- path: /docker-for-mac/osxfs/
|
||||
title: File system sharing
|
||||
- path: /docker-for-mac/troubleshoot/
|
||||
title: Logs and Troubleshooting
|
||||
- path: /docker-for-mac/faqs/
|
||||
title: FAQs
|
||||
- path: /docker-for-mac/examples/
|
||||
title: Example Applications
|
||||
- path: /docker-for-mac/opensource/
|
||||
title: Open Source Licensing
|
||||
- path: /docker-for-mac/release-notes/
|
||||
title: Release Notes
|
||||
- sectiontitle: Docker for Windows
|
||||
section:
|
||||
- path: /docker-for-windows/
|
||||
title: Getting Started
|
||||
- path: /docker-for-windows/troubleshoot/
|
||||
title: Logs and Troubleshooting
|
||||
- path: /docker-for-windows/faqs/
|
||||
title: FAQs
|
||||
- path: /docker-for-windows/examples/
|
||||
title: Example Applications
|
||||
- path: /docker-for-windows/opensource/
|
||||
title: Open Source Licensing
|
||||
- path: /docker-for-windows/release-notes/
|
||||
title: Release Notes
|
||||
- sectiontitle: Docker for AWS
|
||||
section:
|
||||
- path: /docker-for-aws/
|
||||
title: Setup & Prerequisites
|
||||
- path: /docker-for-aws/scaling/
|
||||
title: Scaling
|
||||
- path: /docker-for-aws/upgrade/
|
||||
title: Upgrading
|
||||
- path: /docker-for-aws/faqs/
|
||||
title: FAQs
|
||||
- path: /docker-for-aws/opensource/
|
||||
title: Open Source Licensing
|
||||
- path: /docker-for-aws/release-notes/
|
||||
title: Release Notes
|
||||
- sectiontitle: Docker for Azure
|
||||
section:
|
||||
- path: /docker-for-azure/
|
||||
title: Setup & Prerequisites
|
||||
- path: /docker-for-azure/upgrade/
|
||||
title: Upgrading
|
||||
- path: /docker-for-azure/faqs/
|
||||
title: FAQs
|
||||
- path: /docker-for-azure/opensource/
|
||||
title: Open Source Licensing
|
||||
- path: /docker-for-azure/release-notes/
|
||||
title: Release Notes
|
||||
- sectiontitle: Docker Compose
|
||||
section:
|
||||
- path: /compose/overview/
|
||||
|
|
|
@ -1,9 +1,16 @@
|
|||
---
|
||||
description: Docker Cloud
|
||||
keywords: Docker, cloud, overview
|
||||
keywords: Docker, cloud
|
||||
notoc: true
|
||||
title: Welcome to the Docker Cloud docs!
|
||||
redirect_from:
|
||||
- docker-cloud/overview
|
||||
title: Docker Cloud Documentation
|
||||
- /engine/installation/cloud/cloud/
|
||||
- /engine/installation/cloud/
|
||||
- /engine/installation/cloud/overview/
|
||||
- /engine/installation/google/
|
||||
- /engine/installation/softlayer/
|
||||
- /engine/installation/rackspace/
|
||||
- /engine/installation/joyent/
|
||||
---
|
||||
<style type="text/css">
|
||||
.tg td {
|
||||
|
@ -28,7 +35,7 @@ title: Docker Cloud Documentation
|
|||
</style>
|
||||
|
||||
<center>
|
||||
<div class="whale"><a href="https://cloud.docker.com/" target="_blank"><img src="images/Docker-Cloud-Blue.svg" height="150" width="150" fill="#1488C6" alt="Docker Cloud logo" title="Let's go! Click to go to Docker Cloud." float="right"></a></div>
|
||||
<div class="whale"><a href="https://cloud.docker.com/" target="_blank" class="_"><img src="images/Docker-Cloud-Blue.svg" height="150" width="150" fill="#1488C6" alt="Docker Cloud logo" title="Let's go! Click to go to Docker Cloud." float="right"></a></div>
|
||||
</center>
|
||||
|
||||
Docker Cloud provides a hosted [registry service](builds/repos.md) with
|
||||
|
|
|
@ -4,6 +4,7 @@ keywords: link, DigitalOcean, account
|
|||
redirect_from:
|
||||
- /docker-cloud/getting-started/beginner/link-do/
|
||||
- /docker-cloud/getting-started/link-do/
|
||||
- /engine/installation/cloud/cloud-ex-machine-ocean/
|
||||
title: Link a DigitalOcean account
|
||||
---
|
||||
|
||||
|
|
|
@ -2,6 +2,9 @@
|
|||
description: Setup & Prerequisites
|
||||
keywords: aws, amazon, iaas, tutorial
|
||||
title: Docker for AWS Setup & Prerequisites
|
||||
redirect_from:
|
||||
- /engine/installation/cloud/cloud-ex-aws/
|
||||
- /engine/installation/amazon/
|
||||
---
|
||||
|
||||
## Prerequisites
|
||||
|
|
|
@ -2,6 +2,8 @@
|
|||
description: Setup & Prerequisites
|
||||
keywords: azure, microsoft, iaas, tutorial
|
||||
title: Docker for Azure Setup & Prerequisites
|
||||
redirect_from:
|
||||
- /engine/installation/azure/
|
||||
---
|
||||
|
||||
## Prerequisites
|
||||
|
@ -60,4 +62,4 @@ You can also invoke the Docker for Azure template from the Azure CLI:
|
|||
Here is an example of how to use the CLI. Make sure you populate all of the parameters and their values:
|
||||
```
|
||||
$ azure group create --name DockerGroup --location centralus --deployment-name docker.template --template-file <templateurl>
|
||||
```
|
||||
```
|
||||
|
|
|
@ -8,6 +8,7 @@ redirect_from:
|
|||
- /mac/started/
|
||||
- /docker-for-mac/started/
|
||||
- /installation/mac/
|
||||
- /engine/installation/mac/
|
||||
title: Get started with Docker for Mac
|
||||
---
|
||||
|
||||
|
|
|
@ -8,6 +8,7 @@ redirect_from:
|
|||
- /windows/started/
|
||||
- /docker-for-windows/started/
|
||||
- /installation/windows/
|
||||
- /engine/installation/windows/
|
||||
title: Get started with Docker for Windows
|
||||
---
|
||||
Welcome to Docker for Windows!
|
||||
|
|
|
@ -1,202 +0,0 @@
|
|||
---
|
||||
description: Example of a manual install of Docker Engine on a cloud provider, using Amazon Web Services (AWS) EC2. Shows how to create an EC2 instance, and install Docker Engine on it.
|
||||
keywords: cloud, docker, machine, documentation, installation, AWS, EC2
|
||||
title: 'Example: Manual installation on a cloud provider'
|
||||
---
|
||||
|
||||
You can install Docker Engine directly to servers you have on cloud providers. This example shows how to create an <a href="https://aws.amazon.com/" target="_blank"> Amazon Web Services (AWS)</a> EC2 instance, and install Docker Engine on it.
|
||||
|
||||
You can use this same general approach to create Dockerized hosts on other cloud providers.
|
||||
|
||||
### Step 1. Sign up for AWS
|
||||
|
||||
1. If you are not already an AWS user, sign up for <a href="https://aws.amazon.com/" target="_blank"> AWS</a> to create an account and get root access to EC2 cloud computers. If you have an Amazon account, you can use it as your root user account.
|
||||
|
||||
2. Create an IAM (Identity and Access Management) administrator user, an admin group, and a key pair associated with a region.
|
||||
|
||||
From the AWS menus, select **Services** > **IAM** to get started.
|
||||
|
||||
See the AWS documentation on <a href="http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/get-set-up-for-amazon-ec2.html" target="_blank">Setting Up with Amazon EC2</a>. Follow the steps for "Create an IAM User" and "Create a Key Pair".
|
||||
|
||||
If you are just getting started with AWS and EC2, you do not need to create a virtual private cloud (VPC) or specify a subnet. The newer EC2-VPC platform (accounts created after 2013-12-04) comes with a default VPC and subnet in each availability zone. When you launch an instance, it automatically uses the default VPC.
|
||||
|
||||
### Step 2. Configure and start an EC2 instance
|
||||
|
||||
Launch an instance to create a virtual machine (VM) with a specified operating system (OS) as follows.
|
||||
|
||||
1. Log into AWS with your IAM credentials.
|
||||
|
||||
On the AWS home page, click **EC2** to go to the dashboard, then click **Launch Instance**.
|
||||
|
||||

|
||||
|
||||
AWS EC2 virtual servers are called *instances* in Amazon parlance. Once you set up an account, IAM user and key pair, you are ready to launch an instance. It is at this point that you select the OS for the VM.
|
||||
|
||||
2. Choose an Amazon Machine Image (AMI) with the OS and applications you want. For this example, we select an Ubuntu server.
|
||||
|
||||

|
||||
|
||||
3. Choose an instance type.
|
||||
|
||||

|
||||
|
||||
4. Configure the instance.
|
||||
|
||||
You can select the default network and subnet, which are inherently linked to a region and availability zone.
|
||||
|
||||

|
||||
|
||||
5. Click **Review and Launch**.
|
||||
|
||||
6. Select a key pair to use for this instance.
|
||||
|
||||
When you choose to launch, you need to select a key pair to use. Save the `.pem` file to use in the next steps.
|
||||
|
||||
The instance is now up-and-running. The menu path to get back to your EC2 instance on AWS is: **EC2 (Virtual Servers in Cloud)** > **EC2 Dashboard** > **Resources** > **Running instances**.
|
||||
|
||||
To get help with your private key file, instance IP address, and how to log into the instance via SSH, click the **Connect** button at the top of the AWS instance dashboard.
|
||||
|
||||
|
||||
### Step 3. Log in from a terminal, configure apt, and get packages
|
||||
|
||||
1. Log in to the EC2 instance from a command line terminal.
|
||||
|
||||
Change directories into the directory containing the SSH key and run this command (or give the path to it as part of the command):
|
||||
|
||||
$ ssh -i "YourKey" ubuntu@xx.xxx.xxx.xxx
|
||||
|
||||
For our example:
|
||||
|
||||
$ cd ~/Desktop/keys/amazon_ec2
|
||||
$ ssh -i "my-key-pair.pem" ubuntu@xx.xxx.xxx.xxx
|
||||
|
||||
We'll follow the instructions for installing Docker on Ubuntu [the instructions for installing Docker on Ubuntu](/engine/installation/linux/ubuntulinux.md). The next few steps reflect those instructions.
|
||||
|
||||
2. Check the kernel version to make sure it's 3.10 or higher.
|
||||
|
||||
ubuntu@ip-xxx-xx-x-xxx:~$ uname -r
|
||||
3.13.0-48-generic
|
||||
|
||||
3. Add the new `gpg` key.
|
||||
|
||||
ubuntu@ip-xxx-xx-x-xxx:~$ sudo apt-key adv --keyserver hkp://p80.pool.sks-keyservers.net:80 --recv-keys 58118E89F3A912897C070ADBF76221572C52609D
|
||||
Executing: gpg --ignore-time-conflict --no-options --no-default-keyring --homedir /tmp/tmp.jNZLKNnKte --no-auto-check-trustdb --trust-model always --keyring /etc/apt/trusted.gpg --primary-keyring /etc/apt/trusted.gpg --keyserver hkp://p80.pool.sks-keyservers.net:80 --recv-keys 58118E89F3A912897C070ADBF76221572C52609D
|
||||
gpg: requesting key 2C52609D from hkp server p80.pool.sks-keyservers.net
|
||||
gpg: key 2C52609D: public key "Docker Release Tool (releasedocker) <docker@docker.com>" imported
|
||||
gpg: Total number processed: 1
|
||||
gpg: imported: 1 (RSA: 1)
|
||||
|
||||
4. Create a `docker.list` file, and add an entry for our OS, Ubuntu Trusty 14.04 (LTS).
|
||||
|
||||
ubuntu@ip-xxx-xx-x-xxx:~$ sudo vi /etc/apt/sources.list.d/docker.list
|
||||
|
||||
If we were updating an existing file, we'd delete any existing entries.
|
||||
|
||||
5. Update the `apt` package index.
|
||||
|
||||
ubuntu@ip-xxx-xx-x-xxx:~$ sudo apt-get update
|
||||
|
||||
6. Purge the old repo if it exists.
|
||||
|
||||
In our case the repo doesn't because this is a new VM, but let's run it anyway just to be sure.
|
||||
|
||||
ubuntu@ip-xxx-xx-x-xxx:~$ sudo apt-get purge lxc-docker
|
||||
Reading package lists... Done
|
||||
Building dependency tree
|
||||
Reading state information... Done
|
||||
Package 'lxc-docker' is not installed, so not removed
|
||||
0 upgraded, 0 newly installed, 0 to remove and 139 not upgraded.
|
||||
|
||||
7. Verify that `apt` is pulling from the correct repository.
|
||||
|
||||
ubuntu@ip-172-31-0-151:~$ sudo apt-cache policy docker-engine
|
||||
docker-engine:
|
||||
Installed: (none)
|
||||
Candidate: 1.9.1-0~trusty
|
||||
Version table:
|
||||
1.9.1-0~trusty 0
|
||||
500 https://apt.dockerproject.org/repo/ ubuntu-trusty/main amd64 Packages
|
||||
1.9.0-0~trusty 0
|
||||
500 https://apt.dockerproject.org/repo/ ubuntu-trusty/main amd64 Packages
|
||||
. . .
|
||||
|
||||
From now on when you run `apt-get upgrade`, `apt` pulls from the new repository.
|
||||
|
||||
### Step 4. Install recommended prerequisites for the OS
|
||||
|
||||
For Ubuntu Trusty (and some other versions), it’s recommended to install the `linux-image-extra` kernel package, which allows you use the `aufs` storage driver, so we'll do that now.
|
||||
|
||||
ubuntu@ip-xxx-xx-x-xxx:~$ sudo apt-get update
|
||||
ubuntu@ip-172-31-0-151:~$ sudo apt-get install linux-image-extra-$(uname -r)
|
||||
|
||||
### Step 5. Install Docker Engine on the remote instance
|
||||
|
||||
1. Update the apt package index.
|
||||
|
||||
ubuntu@ip-xxx-xx-x-xxx:~$ sudo apt-get update
|
||||
|
||||
2. Install Docker Engine.
|
||||
|
||||
ubuntu@ip-xxx-xx-x-xxx:~$ sudo apt-get install docker-engine
|
||||
Reading package lists... Done
|
||||
Building dependency tree
|
||||
Reading state information... Done
|
||||
The following extra packages will be installed:
|
||||
aufs-tools cgroup-lite git git-man liberror-perl
|
||||
Suggested packages:
|
||||
git-daemon-run git-daemon-sysvinit git-doc git-el git-email git-gui gitk
|
||||
gitweb git-arch git-bzr git-cvs git-mediawiki git-svn
|
||||
The following NEW packages will be installed:
|
||||
aufs-tools cgroup-lite docker-engine git git-man liberror-perl
|
||||
0 upgraded, 6 newly installed, 0 to remove and 139 not upgraded.
|
||||
Need to get 11.0 MB of archives.
|
||||
After this operation, 60.3 MB of additional disk space will be used.
|
||||
Do you want to continue? [Y/n] y
|
||||
Get:1 http://us-west-1.ec2.archive.ubuntu.com/ubuntu/ trusty/universe aufs-tools amd64 1:3.2+20130722-1.1 [92.3 kB]
|
||||
Get:2 http://us-west-1.ec2.archive.ubuntu.com/ubuntu/ trusty/main liberror-perl all 0.17-1.1 [21.1 kB]
|
||||
. . .
|
||||
|
||||
3. Start the Docker daemon.
|
||||
|
||||
ubuntu@ip-xxx-xx-x-xxx:~$ sudo service docker start
|
||||
|
||||
4. Verify Docker Engine is installed correctly by running `docker run hello-world`.
|
||||
|
||||
ubuntu@ip-xxx-xx-x-xxx:~$ sudo docker run hello-world
|
||||
ubuntu@ip-172-31-0-151:~$ sudo docker run hello-world
|
||||
Unable to find image 'hello-world:latest' locally
|
||||
latest: Pulling from library/hello-world
|
||||
b901d36b6f2f: Pull complete
|
||||
0a6ba66e537a: Pull complete
|
||||
Digest: sha256:8be990ef2aeb16dbcb9271ddfe2610fa6658d13f6dfb8bc72074cc1ca36966a7
|
||||
Status: Downloaded newer image for hello-world:latest
|
||||
|
||||
Hello from Docker.
|
||||
This message shows that your installation appears to be working correctly.
|
||||
|
||||
To generate this message, Docker took the following steps:
|
||||
1. The Docker client contacted the Docker daemon.
|
||||
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
|
||||
3. The Docker daemon created a new container from that image which runs the executable that produces the output you are currently reading.
|
||||
4. The Docker daemon streamed that output to the Docker client, which sent it to your terminal.
|
||||
|
||||
To try something more ambitious, you can run an Ubuntu container with:
|
||||
$ docker run -it ubuntu bash
|
||||
|
||||
Share images, automate workflows, and more with a free Docker Hub account:
|
||||
https://hub.docker.com
|
||||
|
||||
For more examples and ideas, visit:
|
||||
https://docs.docker.com/userguide/
|
||||
|
||||
## Where to go next
|
||||
|
||||
_Looking for a quicker way to do Docker cloud installs and provision multiple hosts?_ You can use [Docker Machine](/machine/overview/) to provision hosts.
|
||||
|
||||
* [Use Docker Machine to provision hosts on cloud providers](/machine/get-started-cloud/)
|
||||
|
||||
* [Docker Machine driver reference](/machine/drivers/)
|
||||
|
||||
* [Install Docker Engine](../index.md)
|
||||
|
||||
* [Docker User Guide](../../userguide/intro.md)
|
|
@ -1,16 +0,0 @@
|
|||
---
|
||||
description: Cloud Installations
|
||||
keywords: Docker install
|
||||
redirect_from:
|
||||
- /engine/installation/amazon/
|
||||
- /engine/installation/google/
|
||||
- /engine/installation/softlayer/
|
||||
- /engine/installation/azure/
|
||||
- /engine/installation/rackspace/
|
||||
- /engine/installation/joyent/
|
||||
title: Install Engine on cloud hosts
|
||||
---
|
||||
|
||||
* [Understand cloud install options and choose one](overview.md)
|
||||
* [Example: Use Machine to provision cloud hosts](cloud-ex-machine-ocean.md)
|
||||
* [Example: Manual install on a cloud provider](cloud-ex-aws.md)
|
|
@ -1,48 +0,0 @@
|
|||
---
|
||||
description: Installation instructions for Docker on cloud.
|
||||
keywords: cloud, docker, machine, documentation, installation
|
||||
redirect_from:
|
||||
- /engine/installation/cloud/cloud/
|
||||
title: Choose an installation method
|
||||
---
|
||||
|
||||
You can install Docker Engine on any cloud platform that runs an operating system (OS) that Docker supports. This includes many flavors and versions of Linux, along with Mac and Windows.
|
||||
|
||||
You have two options for installing:
|
||||
|
||||
* Manually install on the cloud (create cloud hosts, then install Docker Engine on them)
|
||||
* Use Docker Machine to provision cloud hosts
|
||||
|
||||
## Manually install Docker Engine on a cloud host
|
||||
|
||||
To install on a cloud provider:
|
||||
|
||||
1. Create an account with the cloud provider, and read cloud provider documentation to understand their process for creating hosts.
|
||||
|
||||
2. Decide which OS you want to run on the cloud host.
|
||||
|
||||
3. Understand the Docker prerequisites and install process for the chosen OS. See [Install Docker Engine](../index.md) for a list of supported systems and links to the install guides.
|
||||
|
||||
4. Create a host with a Docker supported OS, and install Docker per the instructions for that OS.
|
||||
|
||||
[Example (AWS): Manual install on a cloud provider](cloud-ex-aws.md) shows how to create an <a href="https://aws.amazon.com/" target="_blank"> Amazon Web Services (AWS)</a> EC2 instance, and install Docker Engine on it.
|
||||
|
||||
|
||||
## Use Docker Machine to provision cloud hosts
|
||||
|
||||
Docker Machine driver plugins are available for several popular cloud platforms, so you can use Machine to provision one or more Dockerized hosts on those platforms.
|
||||
|
||||
With Docker Machine, you can use the same interface to create cloud hosts with Docker Engine on them, each configured per the options you specify.
|
||||
|
||||
To do this, you use the `docker-machine create` command with the driver for the cloud provider, and provider-specific flags for account verification, security credentials, and other configuration details.
|
||||
|
||||
[Example: Use Docker Machine to provision cloud hosts](cloud-ex-machine-ocean.md) walks you through the steps to set up Docker Machine and provision a Dockerized host on <a href="https://www.digitalocean.com/" target="_blank">Digital Ocean</a>).
|
||||
|
||||
## Where to go next
|
||||
* [Example: Manual install on a cloud provider](cloud-ex-aws.md) (AWS EC2)
|
||||
|
||||
* [Example: Use Docker Machine to provision cloud hosts](cloud-ex-machine-ocean.md) (Digital Ocean)
|
||||
|
||||
* For supported platforms, see [Install Docker Engine](../index.md).
|
||||
|
||||
* To get started with Docker post-install, see [Docker User Guide](../../userguide/intro.md).
|
|
@ -8,7 +8,8 @@ redirect_from:
|
|||
title: Install Docker Engine
|
||||
---
|
||||
|
||||
Docker Engine is supported on Linux, Cloud, Windows, and macOS. Installation instructions are available for the following:
|
||||
Docker Engine is supported on Linux, Cloud, Windows, and macOS. Installation
|
||||
instructions are available for the following:
|
||||
|
||||
## On Linux
|
||||
* [Arch Linux](linux/archlinux.md)
|
||||
|
@ -23,22 +24,43 @@ Docker Engine is supported on Linux, Cloud, Windows, and macOS. Installation ins
|
|||
* [openSUSE and SUSE Linux Enterprise](linux/SUSE.md)
|
||||
* [Ubuntu](linux/ubuntulinux.md)
|
||||
|
||||
If your linux distribution is not listed above, don't give up yet. To try out Docker on a distribution that is not listed above, go here: [Installation from binaries](binaries.md).
|
||||
If your linux distribution is not listed above, don't give up yet. To try out
|
||||
Docker on a distribution that is not listed above, go here:
|
||||
[Installation from binaries](binaries.md).
|
||||
|
||||
## On Cloud
|
||||
* [Choose how to Install](cloud/overview.md)
|
||||
* [Example: Manual install on a cloud provider](cloud/cloud-ex-aws.md)
|
||||
* [Example: Use Docker Machine to provision cloud hosts](cloud/cloud-ex-machine-ocean.md)
|
||||
|
||||
## On macOS and Windows
|
||||
* [macOS](mac.md)
|
||||
* [Windows](windows.md)
|
||||
|
||||
## The Docker Archives
|
||||
Instructions for installing prior releases of Docker can be found in the following docker archives:
|
||||
[Docker v1.7](/v1.7/), [Docker v1.6](/v1.6/), [Docker v1.5](/v1.5/), and [Docker v1.4](/v1.4/).
|
||||
* [Docker for Mac](/docker-for-mac/)
|
||||
* [Docker for Windows](/docker-for-windows/)
|
||||
|
||||
## Where to go after installing
|
||||
* [About Docker Engine](../index.md)
|
||||
* [Support](https://www.docker.com/support/)
|
||||
* [Training](https://training.docker.com//)
|
||||
|
||||
## On Cloud
|
||||
|
||||
You can use Docker Cloud to automatically provision and manage your cloud
|
||||
instances:
|
||||
|
||||
* [Amazon Web Services setup guide](link-aws.md)
|
||||
* [DigitalOcean setup guide](link-do.md)
|
||||
* [Microsoft Azure setup guide](link-azure.md)
|
||||
* [Packet setup guide](link-packet.md)
|
||||
* [SoftLayer setup guide](link-softlayer.md)
|
||||
* [Use the Docker Cloud Agent to Bring your Own Host](byoh.md)
|
||||
|
||||
You can also use our official Docker Editions if you'd like to manually manage
|
||||
your cloud instances:
|
||||
|
||||
* [Docker for AWS](/docker-for-aws/)
|
||||
* [Docker for Azure](/docker-for-azure/)
|
||||
|
||||
|
||||
## Prior releases
|
||||
|
||||
Instructions for installing prior releases of Docker can be found in the
|
||||
[Docker archives](/docsarchive/).
|
||||
|
||||
|
||||
## Get started
|
||||
|
||||
After setting up Docker, try learning the basics over at
|
||||
[Getting started with Docker](/engine/getstarted/).
|
||||
|
|
|
@ -1,49 +0,0 @@
|
|||
---
|
||||
description: Docker installation on macOS
|
||||
keywords: Docker, Docker documentation, requirements, boot2docker, VirtualBox, SSH, Linux, osx, os x, macOS, Mac
|
||||
title: Install Docker on macOS
|
||||
---
|
||||
|
||||
You have two options for installing Docker on Mac:
|
||||
|
||||
- [Docker for Mac](#docker-for-mac)
|
||||
- [Docker Toolbox](#docker-toolbox)
|
||||
|
||||
## Docker for Mac
|
||||
|
||||
Docker for Mac is our newest offering for the Mac. It runs as a native Mac application and uses <a href="https://github.com/mist64/xhyve/" target="_blank">xhyve</a> to virtualize the Docker Engine environment and Linux kernel-specific features for the Docker daemon.
|
||||
|
||||
Go to [Getting Started with Docker for Mac](/docker-for-mac/) for download and install instructions, and to learn all about Docker for Mac.
|
||||
|
||||
**Requirements**
|
||||
|
||||
- Mac must be a 2010 or newer model, with Intel's hardware support for memory management unit (MMU) virtualization; i.e., Extended Page Tables (EPT)
|
||||
|
||||
- macOS 10.10.3 Yosemite or newer
|
||||
|
||||
- At least 4GB of RAM
|
||||
|
||||
- VirtualBox prior to version 4.3.30 must NOT be installed (it is incompatible with Docker for Mac). Docker for Mac will error out on install in this case. Uninstall the older version of VirtualBox and re-try the install.
|
||||
|
||||
## Docker Toolbox
|
||||
|
||||
If you have an earlier Mac that doesn't meet the Docker for Mac requirements, <a href="https://www.docker.com/products/docker-toolbox" target="_blank">get Docker Toolbox</a> for the Mac.
|
||||
|
||||
See [Docker Toolbox Overview](/toolbox/overview.md) for help on installing Docker with Toolbox.
|
||||
|
||||
The Docker Toolbox setup does not run Docker natively in macOS. Instead, it uses `docker-machine` to create and attach to a virtual machine (VM). This machine is a Linux VM that hosts Docker for you on your Mac.
|
||||
|
||||
**Requirements**
|
||||
|
||||
Your Mac must be running macOS 10.8 "Mountain Lion" or newer to install the Docker Toolbox. Full install instructions are at [Toolbox install instructions for Mac](/toolbox/toolbox_install_mac.md).
|
||||
|
||||
|
||||
## Learning more
|
||||
|
||||
* If you are new to Docker, try out the [Getting Started](../getstarted/index.md) tutorial for a hands-on tour, including using Docker commands, running containers, building images, and working with Docker Hub.
|
||||
|
||||
* You can find more extensive examples in [Learn by example](../tutorials/index.md) and in the [Docker Engine User Guide](../userguide/index.md).
|
||||
|
||||
* If you are interested in using the Kitematic GUI, see the [Kitematic user guide](/kitematic/userguide/).
|
||||
|
||||
> **Note**: The Boot2Docker command line was deprecated several releases back in favor of Docker Machine, and now Docker for Mac.
|
|
@ -1,44 +0,0 @@
|
|||
---
|
||||
description: Docker installation on Microsoft Windows
|
||||
keywords: Docker, Docker documentation, Windows, requirements, virtualbox, boot2docker
|
||||
title: Install Docker on Windows
|
||||
---
|
||||
|
||||
You have two options for installing Docker on Windows:
|
||||
|
||||
- [Docker for Windows](#docker-for-windows)
|
||||
- [Docker Toolbox](#docker-toolbox)
|
||||
|
||||
## Docker for Windows
|
||||
|
||||
Docker for Windows is our newest offering for PCs. It runs as a native Windows application and uses Hyper-V to virtualize the Docker Engine environment and Linux kernel-specific features for the Docker daemon.
|
||||
|
||||
Go to [Getting Started with Docker for Windows](/docker-for-windows/) for download and install instructions, and to learn all about Docker for Windows.
|
||||
|
||||
**Requirements**
|
||||
|
||||
* 64bit Windows 10 Pro, Enterprise and Education (1511 November update, Build 10586 or later). In the future we will support more versions of Windows 10.
|
||||
|
||||
* The Hyper-V package must be enabled. The Docker for Windows installer will enable it for you, if needed. (This requires a reboot).
|
||||
|
||||
## Docker Toolbox
|
||||
|
||||
If you have an earlier Windows system that doesn't meet the Docker for Windows requirements, <a href="https://www.docker.com/products/docker-toolbox" target="_blank">get Docker Toolbox</a>.
|
||||
|
||||
See [Docker Toolbox Overview](/toolbox/overview.md) for help on installing Docker with Toolbox.
|
||||
|
||||
The Docker Toolbox setup does not run Docker natively on Windows. Instead, it uses `docker-machine` to create and attach to a virtual machine (VM). This machine is a Linux VM that hosts Docker for you on your Windows system.
|
||||
|
||||
**Requirements**
|
||||
|
||||
To run Docker, your machine must have a 64-bit operating system running Windows 7 or higher. Additionally, you must make sure that virtualization is enabled on your machine. For details, see the [Toolbox install instructions for Windows](/toolbox/toolbox_install_windows.md).
|
||||
|
||||
## Learning more
|
||||
|
||||
* If you are new to Docker, try out the [Getting Started](../getstarted/index.md) tutorial for a hands-on tour, including using Docker commands, running containers, building images, and working with Docker Hub.
|
||||
|
||||
* You can find more extensive examples in [Learn by example](../tutorials/index.md) and in the [Docker Engine User Guide](../userguide/index.md).
|
||||
|
||||
* If you are interested in using the Kitematic GUI, see the [Kitematic user guide](/kitematic/userguide/).
|
||||
|
||||
> **Note**: The Boot2Docker command line was deprecated several releases > back in favor of Docker Machine, and now Docker for Windows.
|
Loading…
Reference in New Issue