docs/installconfigure/Install_Docker.rst

   1 .. This work is licensed under a Creative Commons Attribution 4.0 International License.
   2 .. http://creativecommons.org/licenses/by/4.0
   3 .. Copyright 2018 Huawei Technologies Co., Ltd.
   4
   5 Install Docker
   6 ===============
   7
   8 Make sure curl is installed on the Ubuntu VM:
   9
  10 .. code-block:: bash
  11
  12         sudo apt update
  13         sudo apt install curl
  14
  15 If 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
  18 Otherwise:
  19         curl -fsSL https://apt.dockerproject.org/gpg | sudo apt-key add -
  20 Expected Response:
  21         OK
  22 Add the docker package repository:
  23         sudo apt-add-repository "deb https://apt.dockerproject.org/repo ubuntu-xenial main"
  24
  25 Install 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
  34 If 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
  65 Add 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
  71 Log out and log back in so that the user group change will takeeffect.
  72
  73 Verify that you can connect to docker as yourself (i.e. not as root):
  74
  75 .. code-block:: bash
  76
  77     docker ps
  78
  79 Verify 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