docker-compose语法

docker-compose基础语法

简介

​ Docker Compose是一个用来定义和运行复杂应用的Docker工具。一个使用Docker容器的应用，通常由多个容器组成。使用Docker Compose不再需要使用shell脚本来启动容器。
​ Compose 通过一个配置文件来管理多个Docker容器，在配置文件中，所有的容器通过services来定义，然后使用docker-compose脚本来启动，停止和重启应用，和应用中的服务以及所有依赖服务的容器，非常适合组合使用多个容器进行开发的场景。

​ docker-compose标准的配置文件应该包含version、services、networks但大部分

​ version：定义容器的版本

​ services:定义各个容器的服务

​ networks：定义需要使用到的网络

## docker-compose.yml 文件
version: '3'
services:
  httpd:
    image: dockercloud/hello-world
    ports:
      - 8080
    networks:
      - front-tier
      - back-tier
 
  redis:
    image: redis
    links:
      - web
    networks:
      - back-tier
 
  lb:
    image: dockercloud/haproxy
    ports:
      - 80:80
    links:
      - web
    networks:
      - front-tier
      - back-tier
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock 
 
networks:
  front-tier:
    driver: bridge
  back-tier:
	driver: bridge
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

image

指定服务的镜像名称或镜像id，如果镜像在本地存在，就会使用本地的镜像，如果不存在，compose就会自动去尝试拉取这个镜像

image: nginx
image: httpd:v0.1
image: tutum/influxdb
image: example-registry.com:4000/postgresql
image: a4bc65fd
1
2
3
4
5

build

基于dockerfile,在使用up启动的时候会自动执行构建任务，可以指定dockerfile所在的文件夹的路径，compose会将他自动构建这个镜像，让后使用这个镜像启动服务容器

build: /tmp/httpd/Dockerfile
1

也可以是相对路径，只要上下文确定就可以读取到 Dockerfile。

build: ./dir
1

command

使用command可以覆盖容器启动后默认执行的命令的命令，跟dockerfile中的CMD一样，当dockerfile定义了entry point的时候，docker-compose.yml定义的command会被覆盖

version: '3'
services:
    web:
        build: ./
        command: env
1
2
3
4
5

entry point

可以覆盖dockerfile中定义的entry point命令

##entrypoint没有执行启动server的命令，而是echo hello world, 那么在docker-compose up的过程中不会打印出hello worl, docker logs 查看容器才能看到hello world
version: '3'
services:
    httpd:
        build: ./
        entrypoint: 
            - echo
            - hello world

[root@localhost ~]# docker logs composetest_web_1
hello world
1
2
3
4
5
6
7
8
9
10
11

ports

将容器端口映射到宿主机上

ports:
    - "8080:80"
    - "127.0.0.1:8080:80"
1
2
3

expose

与dockerfile中的expose一样，是用来暴露指定的端口号

expose:
 - "80"
 - "8080"
1
2
3

links

容器的连接，会连接到其它服务中的容器

links:
 - db
 - db:database
 - redis
1
2
3
4

如果使用的别名将会自动在服务容器中的/etc/hosts里创建

192.168.240.10  db
192.168.240.20  database
192.168.240.30  redis
1
2
3

logging

这个标签用于配置日志服务。

logging:
  driver: syslog
  options:
    syslog-address: "tcp://192.168.240.30:80"
1
2
3
4

stop_signal

设置另一个信号来停止容器。在默认情况下使用的是SIGTERM停止容器。设置另一个信号可以使用stop_signal标签。

stop_signal: SIGUSR1
1

network_mode

网络模式，与Docker client的–net参数类似，只是相对多了一个service:[service name] 的格式。

network_mode: "bridge"
network_mode: "host"
network_mode: "none"
network_mode: "service:[service name]"
network_mode: "container:[container name/id]"
1
2
3
4
5

networks

加入指定网络，格式如下

services:
  some-service:
    networks:
     - some-network
     - other-network
1
2
3
4
5