blob: 5712691dbfd7a578d74371302099780f24663a7d [file] [log] [blame]
seshukmbbb1a2c2017-11-06 11:58:51 +05301.. This work is licensed under a Creative Commons Attribution 4.0 International License.
2.. http://creativecommons.org/licenses/by/4.0
3.. Copyright 2017 Huawei Technologies Co., Ltd.
4
5Install Docker
6===============
7
8Make sure curl is installed on the Ubuntu VM:
9
10.. code-block:: bash
11
12 sudo apt update
13 sudo apt install curl
14
15If you are behind a corporate firewall (replace "proxyhost:port" with your actual proxy information)
16 https_proxy="https://*proxyhost:port*" curl -fsSL https://apt.dockerproject.org/gpg | sudo apt-key add -
17
18Otherwise:
19 curl -fsSL https://apt.dockerproject.org/gpg | sudo apt-key add -
20Expected Response:
21 OK
22Add the docker package repository:
23 sudo apt-add-repository "deb https://apt.dockerproject.org/repo ubuntu-xenial main"
24
25Install packages:
26
27.. code-block:: bash
28
29 sudo apt update
30 sudo apt-cache policy docker-engine
31 sudo apt install docker-engine
32 sudo apt install docker-compose
33
34If you are behind a corporate firewall, you will need to configure proxy settings for docker so that images may be obtained from internet repositories. In the commands shown here, replace *"proxyhost:port"*, *"yourdomain1.com"*, and *"yourdomain2.com"* with appropriate values.
35
36 Make the docker configuration directory:
37
38.. code-block:: bash
39
40 sudo mkdir -p /etc/systemd/system/docker.service.d
41
42 Edit (create) this file:
43
44.. code-block:: bash
45
46 sudo vi /etc/systemd/system/docker.service.d/http-proxy.conf
47
48 Add these lines:
49
50 [Service]
51
52 Environment="HTTP_PROXY=https://*proxyhost:port*"
53
54 Environment="HTTPS_PROXY=https://*proxyhost:port*"
55
56 Environment="NO_PROXY=localhost,127.0.0.1,.yourdomain1.com,.yourdomain2.com"
57
58 Restart docker:
59
60.. code-block:: bash
61
62 sudo systemctl daemon-reload
63 sudo systemctl restart docker
64
65Add yourself to the docker user group (replace "userid" with your user ID):
66
67.. code-block:: bash
68
69 sudo usermod -a -G docker *userid*
70
71Log out and log back in so that the user group change will takeeffect.
72
73Verify that you can connect to docker as yourself (i.e. not as root):
74
75.. code-block:: bash
76
77 docker ps
78
79Verify that you can download and run the hello-world container
80
81.. code-block:: bash
82
83 docker run hello-world
84
85.. image:: images/Docker_install_1.png