docker-compose教程（安装，使用, 快速入门）

时间  2019-11-17
标签 docker compose 教程 安装 使用 快速 入门 栏目 Docker 繁體版
原文   原文链接

教程基于ubuntu下最新的compose版本3 
参考： https://docs.docker.com/compose/overview/css

1.Compose介绍

Docker Compose是一个用来定义和运行复杂应用的Docker工具。一个使用Docker容器的应用，一般由多个容器组成。使用Docker Compose再也不须要使用shell脚原本启动容器。 
Compose 经过一个配置文件来管理多个Docker容器，在配置文件中，全部的容器经过services来定义，而后使用docker-compose脚原本启动，中止和重启应用，和应用中的服务以及全部依赖服务的容器，很是适合组合使用多个容器进行开发的场景。node

2.Compose和Docker兼容性

compose文件格式版本 docker版本
3.4 17.09.0+
3.3 17.06.0+
3.2 17.04.0+
3.1 1.13.1+
3.0 1.13.0+
2.3 17.06.0+
2.2 1.13.0+
2.1 1.12.0+
2.0 1.10.0+
1.0 1.9.1.+
 
Docker版本变化说明：

Docker从1.13.x版本开始，版本分为企业版EE和社区版CE，版本号也改成按照时间线来发布，好比17.03就是2017年3月。python

Docker的linux发行版的软件仓库从之前的https://apt.dockerproject.org和https://yum.dockerproject.org变动为目前的https://download.docker.com, 软件包名字改成docker-ce和docker-ee。mysql


3.安装docker

Docker的社区版（Docker Community Edition）叫作docker-ce。老版本的Docker包叫作docker或者docker-engine，若是安装了老版本的docker得先卸载而后再安装新版本的docker。docker的发展很是迅速，apt源的更新每每比较滞后。因此docker官网推荐的安装方式都是下载docker安装脚本安装。 
卸载老旧的版本（若未安装过可省略此步）：linux

$ sudo apt-get remove docker docker-engine docker.io
  • 1

安装最新的docker：git

  1. $ curl -fsSL get.docker.com -o get-docker.sh
  2. $ sudo sh get-docker.sh
  • 1
  • 2

shell会提示你输入sudo的密码，而后开始执行最新的docker过程 
或者github

$ curl -sSL https://get.docker.com/ | sh
  • 1

确认Docker成功最新的docker：web

$ sudo docker run hello-world
  • 1

4.安装docker-compose

两种最新的docker安装方式redis

1.从github上下载docker-compose二进制文件安装

  • 下载最新版的docker-compose文件 
    $ sudo curl -L https://github.com/docker/compose/releases/download/1.16.1/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose
  • 添加可执行权限 
    $ sudo chmod +x /usr/local/bin/docker-compose
  • 测试安装结果 
    $ docker-compose --version 
    docker-compose version 1.16.1, build 1719ceb

2.pip安装

$ sudo pip install docker-composesql

5.docker-compose文件结构和示例

docker-compose文件结构

docker-compose.yml:

  1.  
  2. version: "3"
  3. services:
  4.  
  5. redis:
  6. image: redis:alpine
  7. ports:
  8. - "6379"
  9. networks:
  10. - frontend
  11. deploy:
  12. replicas: 2
  13. update_config:
  14. parallelism: 2
  15. delay: 10s
  16. restart_policy:
  17. condition: on-failure
  18.  
  19. db:
  20. image: postgres: 9.4
  21. volumes:
  22. - db-data:/var/lib/postgresql/data
  23. networks:
  24. - backend
  25. deploy:
  26. placement:
  27. constraints: [node.role == manager]
  28.  
  29. vote:
  30. image: dockersamples/examplevotingapp_vote:before
  31. ports:
  32. - 5000:80
  33. networks:
  34. - frontend
  35. depends_on:
  36. - redis
  37. deploy:
  38. replicas: 2
  39. update_config:
  40. parallelism: 2
  41. restart_policy:
  42. condition: on-failure
  43.  
  44. result:
  45. image: dockersamples/examplevotingapp_result:before
  46. ports:
  47. - 5001:80
  48. networks:
  49. - backend
  50. depends_on:
  51. - db
  52. deploy:
  53. replicas: 1
  54. update_config:
  55. parallelism: 2
  56. delay: 10s
  57. restart_policy:
  58. condition: on-failure
  59.  
  60. worker:
  61. image: dockersamples/examplevotingapp_worker
  62. networks:
  63. - frontend
  64. - backend
  65. deploy:
  66. mode: replicated
  67. replicas: 1
  68. labels: [APP=VOTING]
  69. restart_policy:
  70. condition: on-failure
  71. delay: 10s
  72. max_attempts: 3
  73. window: 120s
  74. placement:
  75. constraints: [node.role == manager]
  76.  
  77. visualizer:
  78. image: dockersamples/visualizer:stable
  79. ports:
  80. - "8080:8080"
  81. stop_grace_period: 1m30s
  82. volumes:
  83. - "/var/run/docker.sock:/var/run/docker.sock"
  84. deploy:
  85. placement:
  86. constraints: [node.role == manager]
  87.  
  88. networks:
  89. frontend:
  90. backend:
  91.  
  92. volumes:
  93. db-data:
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93

docker-compose使用示例

经过docker-compose构建一个在docker中运行的基于python flask框架的web应用。

注意：确保你已经安装了Docker Engine和Docker Compose。 您不须要安装Python或Redis，由于这两个都是由Docker镜像提供的。

Step 1: 定义python应用

  • 1 .建立工程目录
  1. $ mkdir compose_test
  2. $ cd compose_test
  3. $ mkdir src # 源码文件夹
  4. $ mkdir docker # docker配置文件夹
  • 1
  • 2
  • 3
  • 4

目录结构以下： 
这里写图片描述

  • 2 .在compose_test/src/目录下建立python flask应用 compose_test/src/app.py文件。
  1. from flask import Flask
  2. from redis import Redis
  3.  
  4. app = Flask(__name__)
  5. redis = Redis(host= 'redis', port=6379)
  6.  
  7. @app.route('/')
  8. def hello():
  9. count = redis.incr( 'hits')
  10. return 'Hello World! I have been seen {} times.\n'.format(count)
  11.  
  12. if __name__ == "__main__":
  13. app.run(host= "0.0.0.0", debug=True)
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 3 .建立python 需求文件 compose_test/docker/requirements.txt
  1. flask
  2. redis
  • 1
  • 2

Step 2: 建立容器的Dockerfile文件

一个容器一个Dockerfile文件 
为了工程目录更加清晰，在compose_test/docker/目录下建立compose_test/docker/web目录

  1. $ cd docker
  2. $ mkdir web
  • 1
  • 2

在compose_test/docker/web/目录中建立Dockerfile文件：

FROM python:3.4
  1. ADD . /docker
  2. ADD ../../src /src # ADD的源路径应该在Dockerfile文件的上下文环境中（即Dockerfile文件所在根目录及其子目录下，如ADD . /src是合法的，而ADD ../../src /src不合法），此处为了清晰的项目结构，只是展现ADD指令，实际中应该用volumes挂载
  3. WORKDIR /src
  4. RUN pip install -r /docker/requirements .txt
  5. CMD ["python", "app.py"]
  • 1
  • 1
  • 2
  • 3
  • 4
  • 5

Dockerfile文件告诉docker了以下信息：

从Python 3.4镜像开始构建一个容器镜像。 

复杂当前 . （即compose_test/docker）目录到容器的/docker目录。

复制../../src目录（即compose_test/src） 到容器中的/src目录（此处../../src是不合法的路径，ADD的源路径必须在Dockerfile文件的上下文环境中，即Dockerfile文件所在根目录或起子目录中，实际应该使用volumes挂载项目源文件）。 

将容器的工做目录设置为/src。 
安装Python依赖关系。
将容器的默认命令设置为python app.py。

Step 3: 定义docker-compose脚本

在compose_test/docker/目录下建立docker-compose.yml文件，并在里面定义服务，内容以下：

  1. version: '3'
  2. services:
  3. web:
  4. build: ./web/
  5. ports:
  6. - "5000:5000"
  7. redis:
  8. image: "redis:3.0.7"
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8

这个compose文件定义了两个服务，即定义了web和redis两个容器。 
web容器： 
* 使用当前的web目录（compose_test/docker/web/）中的Dockerfile构建映像。 
* 将容器上的暴露端口5000映射到主机上的端口5000。 咱们使用Flask Web服务器的默认端口5000。 
redis容器： 
* redis服务使用从Docker Hub提取的官方redis镜像3.0.7版本。

Step 4: 使用Compose构建并运行您的应用程序

在compose_test/docker/目录下执行docker-compose.yml文件：

  1. $ docker-compose up
  2. # 如果要后台运行： $ docker-compose up -d
  3. # 若不使用默认的docker-compose.yml 文件名：
  4. $ docker-compose -f server.yml up -d
  • 1
  • 2
  • 3
  • 4

而后在浏览器中输入http://0.0.0.0:5000/查看运行的应用程序。

Step 5: 编辑compose文件以添加文件绑定挂载

上面的代码是在构建时静态复制到容器中的，即经过Dockerfile文件中的ADD ./src /src命令实现物理主机中的源码复制到容器中，这样在后续物理主机src目录中代码的更改不会反应到容器中。 
能够经过volumes 关键字实现物理主机目录挂载到容器中的功能（同时删除Dockerfile中的ADD指令，不须要建立镜像时将代码打包进镜像，而是经过volums动态挂载，容器和物理host共享数据卷）：

  1. version: '3'
  2. services:
  3. web:
  4. build: .
  5. ports:
  6. - "5000:5000"
  7. volumes:
  8. - ../src :/src
  9. redis:
  10. image: "redis:3.0.7"
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10

经过volumes（卷）将主机上的项目目录（compose_test/src）挂载到容器中的/src目录下，容许您即时修改代码，而无需从新构建映像。

Step 6: 从新构建和运行应用程序

使用更新的compose文件构建应用程序，而后运行它。

$ docker-compose up -d
  • 1

6.compose经常使用服务配置参考

Compose文件是一个定义服务，网络和卷的YAML文件。 Compose文件的默认文件名为docker-compose.yml。

**提示：您能够对此文件使用.yml或.yaml扩展名。 他们都工做。

与docker运行同样，默认状况下，Dockerfile中指定的选项（例如，CMD，EXPOSE，VOLUME，ENV）都被遵照，你不须要在docker-compose.yml中再次指定它们。

同时你可使用相似Bash的$ {VARIABLE} 语法在配置值中使用环境变量，有关详细信息，请参阅变量替换。

本节包含版本3中服务定义支持的全部配置选项。

build

build 能够指定包含构建上下文的路径：

  1. version: '2'
  2. services:
  3. webapp:
  4. build: ./dir
  • 1
  • 2
  • 3
  • 4

或者，做为一个对象，该对象具备上下文路径和指定的Dockerfile文件以及args参数值：

  1. version: '2'
  2. services:
  3. webapp:
  4. build:
  5. context: ./dir
  6. dockerfile: Dockerfile-alternate
  7. args:
  8. buildno: 1
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8

webapp服务将会经过./dir目录下的Dockerfile-alternate文件构建容器镜像。 
若是你同时指定image和build，则compose会经过build指定的目录构建容器镜像，而构建的镜像名为image中指定的镜像名和标签。

  1. build: ./dir
  2. image: webapp:tag
  • 1
  • 2

这将由./dir构建的名为webapp和标记为tag的镜像。

context

包含Dockerfile文件的目录路径，或者是git仓库的URL。 
当提供的值是相对路径时，它被解释为相对于当前compose文件的位置。 该目录也是发送到Docker守护程序构建镜像的上下文。

dockerfile

备用Docker文件。Compose将使用备用文件来构建。 还必须指定构建路径。

args

添加构建镜像的参数，环境变量只能在构建过程当中访问。 
首先，在Dockerfile中指定要使用的参数：

  1. ARG buildno
  2. ARG password
  3.  
  4. RUN echo "Build number: $buildno"
  5. RUN script-requiring-password.sh "$password"
  • 1
  • 2
  • 3
  • 4
  • 5

而后在args键下指定参数。 你能够传递映射或列表：

  1. build:
  2. context: .
  3. args:
  4. buildno: 1
  5. password: secret
  6.  
  7. build:
  8. context: .
  9. args:
  10. - buildno=1
  11. - password=secret
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11

** 注意：YAML布尔值（true，false，yes，no，on，off）必须用引号括起来，以便解析器将它们解释为字符串。

image

指定启动容器的镜像，能够是镜像仓库/标签或者镜像id（或者id的前一部分）

  1. image: redis
  2. image: ubuntu:14.04
  3. image: tutum/influxdb
  4. image: example-registry.com:4000/postgresql
  5. image: a4bc65fd
  • 1
  • 2
  • 3
  • 4
  • 5

若是镜像不存在，Compose将尝试从官方镜像仓库将其pull下来，若是你还指定了build，在这种状况下，它将使用指定的build选项构建它，并使用image指定的名字和标记对其进行标记。

container_name

指定一个自定义容器名称，而不是生成的默认名称。

container_name: my-web-container
  • 1

因为Docker容器名称必须是惟一的，所以若是指定了自定义名称，则没法将服务扩展到多个容器。

volumes

卷挂载路径设置。能够设置宿主机路径 （HOST:CONTAINER） 或加上访问模式 （HOST:CONTAINER:ro）,挂载数据卷的默认权限是读写（rw），能够经过ro指定为只读。 
你能够在主机上挂载相对路径，该路径将相对于当前正在使用的Compose配置文件的目录进行扩展。 相对路径应始终以 . 或者 .. 开始。

  1. volumes:
  2. # 只需指定一个路径，让引擎建立一个卷
  3. - /var/lib/mysql
  5. # 指定绝对路径映射
  6. - /opt/data:/var/lib/mysql
  8. # 相对于当前compose文件的相对路径
  9. - ./cache:/tmp/cache
  11. # 用户家目录相对路径
  12. - ~/configs:/etc/configs/:ro
  14. # 命名卷
  15. - datavolume:/var/lib/mysql
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15

可是，若是要跨多个服务并重用挂载卷，请在顶级volumes关键字中命名挂在卷，可是并不强制，以下的示例亦有重用挂载卷的功能，可是不提倡。

  1. version: "3"
  2.  
  3. services:
  4. web1:
  5. build: ./web/
  6. volumes:
  7. - ../code:/opt/web/code
  8. web2:
  9. build: ./web/
  10. volumes:
  11. - ../code:/opt/web/code
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12

** 注意：经过顶级volumes定义一个挂载卷，并从每一个服务的卷列表中引用它， 这会替换早期版本的Compose文件格式中volumes_from。

  1. version: "3"
  2.  
  3. services:
  4. db:
  5. image: db
  6. volumes:
  7. - data-volume:/var/lib/db
  8. backup:
  9. image: backup -service
  10. volumes:
  11. - data-volume:/var/lib/backup/data
  12.  
  13. volumes:
  14. data-volume:
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14

command

覆盖容器启动后默认执行的命令。

command: bundle exec thin -p 3000
  • 1
  • 2

该命令也能够是一个相似于dockerfile的列表：

command: ["bundle", "exec", "thin", "-p", "3000"]
  • 1
  • 2

links

连接到另外一个服务中的容器。 请指定服务名称和连接别名（SERVICE：ALIAS），或者仅指定服务名称。

  1. web:
  2. links:
  3. - db
  4. - db:database
  5. - redis
  • 1
  • 2
  • 3
  • 4
  • 5

在当前的web服务的容器中能够经过连接的db服务的别名database访问db容器中的数据库应用，若是没有指定别名，则可直接使用服务名访问。

连接不须要启用服务进行通讯 - 默认状况下，任何服务均可以以该服务的名称到达任何其余服务。 （实际是经过设置/etc/hosts的域名解析，从而实现容器间的通讯。故能够像在应用中使用localhost同样使用服务的别名连接其余容器的服务，前提是多个服务容器在一个网络中可路由联通）

links也能够起到和depends_on类似的功能，即定义服务之间的依赖关系，从而肯定服务启动的顺序。

external_links

连接到docker-compose.yml 外部的容器，甚至并不是 Compose 管理的容器。参数格式跟 links 相似。

  1. external_links:
  2. - redis_1
  3. - project_db_1:mysql
  4. - project_db_1:postgresql
  • 1
  • 2
  • 3
  • 4

expose

暴露端口，但不映射到宿主机，只被链接的服务访问。 
仅能够指定内部端口为参数

  1. expose:
  2. - "3000"
  3. - "8000"
  • 1
  • 2
  • 3

ports

暴露端口信息。 
经常使用的简单格式：使用宿主：容器 （HOST:CONTAINER）格式或者仅仅指定容器的端口（宿主将会随机选择端口）均可以。

** 注意：当使用 HOST:CONTAINER 格式来映射端口时，若是你使用的容器端口小于 60 你可能会获得错误得结果，由于 YAML 将会解析 xx:yy 这种数字格式为 60 进制。因此建议采用字符串格式。

简单的短格式：

  1. ports:
  2. - "3000"
  3. - "3000-3005"
  4. - "8000:8000"
  5. - "9090-9091:8080-8081"
  6. - "49100:22"
  7. - "127.0.0.1:8001:8001"
  8. - "127.0.0.1:5000-5010:5000-5010"
  9. - "6060:6060/udp"
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9

在v3.2中ports的长格式的语法容许配置不能用短格式表示的附加字段。 
长格式：

  1. ports:
  2. - target: 80
  3. published: 8080
  4. protocol: tcp
  5. mode: host
  • 1
  • 2
  • 3
  • 4
  • 5

target：容器内的端口 
published：物理主机的端口 
protocol：端口协议（tcp或udp） 
mode：host 和ingress 两总模式，host用于在每一个节点上发布主机端口，ingress 用于被负载平衡的swarm模式端口。

restart

no是默认的重启策略，在任何状况下都不会重启容器。 指定为always时，容器老是从新启动。 若是退出代码指示出现故障错误，则on-failure将从新启动容器。

  1. restart: "no"
  2. restart: always
  3. restart: on-failure
  4. restart: unless-stopped
  • 1
  • 2
  • 3
  • 4

environment

添加环境变量。 你可使用数组或字典两种形式。 任何布尔值; true，false，yes，no须要用引号括起来，以确保它们不被YML解析器转换为True或False。 
只给定名称的变量会自动获取它在 Compose 主机上的值，能够用来防止泄露没必要要的数据。

  1. environment:
  2. RACK_ENV: development
  3. SHOW: 'true'
  4. SESSION_SECRET:
  5.  
  6. environment:
  7. - RACK_ENV=development
  8. - SHOW=true
  9. - SESSION_SECRET
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9

** 注意：若是你的服务指定了build选项，那么在构建过程当中经过environment定义的环境变量将不会起做用。 将使用build的args子选项来定义构建时的环境变量。

pid

将PID模式设置为主机PID模式。 这就打开了容器与主机操做系统之间的共享PID地址空间。 使用此标志启动的容器将可以访问和操做裸机的命名空间中的其余容器，反之亦然。即打开该选项的容器能够相互经过进程 ID 来访问和操做。

pid: "host"
  • 1

dns

配置 DNS 服务器。能够是一个值，也能够是一个列表。

  1. dns: 8.8.8.8
  2. dns:
  3. - 8.8.8.8
  4. - 9.9.9.9
  • 1
  • 2
  • 3
  • 4
相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程