docker-compose：Dockerfile参数以及说明_dockerfile参数详解

---

一、Dockerfile

FROM

选择基础镜像，docker当前要生成的镜像以哪个镜像为基础。

FROM java
1

RUN

容器 构建时 需要运行的命令(区别于后面的CMD)

有两种格式：

• shell命令格式

RUN commond
构如：建时，打印hello world
RUN echo "Hello World !"   
1
2
3

• exec 格式

RUN ["executable", "param1", "param2"]
RUN ["echo","Hello world !"] 
1
2

CMD

容器启动之后要运行的命令

注意 CMD一个文件中只能有一条指令Dockerfile。如果您列出多个，CMD 则只有最后一个会生效。

三种格式：

• shell命令格式

CMD echo "Hello World !"   
1

• exec格式

CMD ["executable", "param1", "param2"]
CMD ["echo","Hello world !"] 
1
2

• 作为 ENTRYPOINT 的参数使用

若 变量 ENTRYPOINT 存在,CMD将作为参数进行传递，而不是执行。

ENTRYPOINT

容器启动之后要运行的命令，同上述CMD ，同样若有多个参数，只有最后一个参数生效。

也是两种形式：

ENTRYPOINT ["executable", "param1", "param2"]
ENTRYPOINT command param1 param2
1
2

1、docker至少指定一个CMD 或者 ENTRYPOINT命令

2、CMD 在运行时会被参数覆盖

不同格式下CMD与ENTRYPOINT的关系:

所以若指定nginx配置文件应该使用 ENTRYPOINT ["nginx","-c"]和 CMD ["nginx.conf"]，并且CMD命令可被替换，所以通常用这种格式。

LABLE

标签 键值对的形式

LABEL <key>=<value> <key>=<value> <key>=<value> ...

如 打上作者标签
LABLE author = '杀生丸'
若要引用变量请使用双引号，单引号会直接解析成字符串输出
LABLE author = "xxx-${author}"
1
2
3
4
5
6

LABLE替换了 MAINTAINER 的使用

MAINTAINER <name>
1

EXPOSE

对外暴露的端口

EXPOSE <port> [<port>/<protocol>...]
1

ADD

将主机的文件复制到镜像中，如仅限本地的 tar 提取和远程 URL 支持

ADD [--chown=<user>:<group>] [--checksum=<checksum>] <src>... <dest>
ADD [--chown=<user>:<group>] ["<src>",... "<dest>"]

将home开头的所有文件复制到mydir文件夹下
ADD hom* /mydir/
1
2
3
4
5

COPY

同ADD，复制文件,只能从主机复制文件到镜像中。

COPY [--chown=<user>:<group>] [--checksum=<checksum>] <src>... <dest>
COPY [--chown=<user>:<group>] ["<src>",... "<dest>"]

将home开头的所有文件复制到mydir文件夹下
COPY hom* /mydir/
1
2
3
4
5

VOLUME

容器卷，也就是挂在数据，用于数据保存和持久化工作

VOLUME ["/data"]
1

USER

指定该镜像以什么样的用户去执行，如果都不指定，默认是root

WORKDIR

工作目录，进入容器后的落脚点，如果不指定则是 /.

WORKDIR /xxx/
1

ENV

环境变量、键值对的形式，运行时ENV 依然有效。

ENV <key>=<value> ...

ENV MY_NAME="John Doe"
ENV MY_DOG=Rex\ The\ Dog
ENV MY_CAT=fluffy
1
2
3
4
5

ARG

使用ARG或ENV指令来指定指令可用的变量RUN。若变量同名，ENV有更高优先级。运行时ARG无效。

FROM ubuntu
ARG CONT_IMG_VER
ENV CONT_IMG_VER=${CONT_IMG_VER:-v1.0.0}
RUN echo $CONT_IMG_VER
1
2
3
4

示例

FROM alpine
WORKDIR /app
COPY src/ /app  #相似命令ADD,ADD自带解压
RUN echo >> 1.txt
CMD tail -f 1.txt #ENTRYPOINT俩如果未指定都是继承自父镜像，如果祖辈也都没指定CMD或ENTRYPOINT，则镜像无法构建
1
2
3
4
5

最后构建镜像

docker build -t test .
-t tag 镜像名称 . 当前目录
1
2

运行镜像,生成新的容器。

docker run test
1

二、docker-compose编排

images

指定镜像

# 描述 Compose 文件的版本信息
version: "3.9"

# 定义服务，可以多个
services:
  redis-6382: # 服务名称
    image: redis:7.0 # 创建容器时所需的镜像
1
2
3
4
5
6
7

container_name

默认事故services下标签作为容器名，也可自己指定。

container_name: app
1

build

指定dockerfile 进行构建，在dockerfile文件中设置的参数无需再docker-compose.yml中再次设置。

可以直接指定目录，默认读取Dockerfile文件，也可以如下所示指定文件

 build: /path/to/build/dir

 build:
  context: ./dir
   dockerfile: Dockerfile-alternate
1
2
3
4
5

command

容器启动后的命令，如指定redis的配置文件

command: redis-server /etc/redis/redis.conf
1

depends_on

表示指定镜像之间的依赖关系，以及启动顺序。理解成sping的依赖即可。

如下，web依赖了db以及redis，所以会先加载redis和db容器，最后加载web容器。

services:
  web:
    build: .
    depends_on:
      - db
      - redis
  redis:
    image: redis
  db:
    image: postgres
1
2
3
4
5
6
7
8
9
10

entrypoint

同Dockerfile中的作用。

env_file

指定文件，可将文件内容作为环境变量添加到容器中，但是在容器构建期间环境变量无效。

env_file:
  - ./a.env
  - ./b.env
1
2
3

environment

设置环境变量，可以将变量保存到容器中。

environment:
  RACK_ENV: development
  SHOW: "true"
  USER_INPUT:
1
2
3
4

external_links

在使用Docker过程中，我们会有许多单独使用docker run启动的容器，为了使Compose能够连接这些不在docker-compose.yml中定义的容器，我们需要一个特殊的标签，就是external_links，它可以让Compose项目里面的容器连接到那些项目配置外部的容器（前提是外部容器中必须至少有一个容器是连接到与项目内的服务的同一个网络里面）。

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

labels

容器中打上标签，同Dockerfile的lable作用

labels:
  com.example.description: "Accounting webapp"
  com.example.department: "Finance"
  com.example.label-with-empty-value: ""
1
2
3
4

links

定义在不同容器的网络链接。 链接到其它服务中的容器。使用服务名称（同时作为别名），或者“服务名称:服务别名”

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

ports

宿主机与容器映射的端口。 [HOST:]CONTAINER[/PROTOCOL]

ports:
 - "3000"
 - "8000:8000"
1
2
3

network_mode

网络模式

network_mode: "host"
network_mode: "none"
network_mode: "service:[service name]"
1
2
3

networks

定义容器附加的网络，默认是bridge模式

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

也可指定别名使用子标签 aliases ，相同的服务可以在不同的网络有不同的别名。

services:
  some-service:
    networks:
      some-network:
        aliases:
         - alias1
         - alias3
      other-network:
        aliases:
         - alias2
1
2
3
4
5
6
7
8
9
10

restart

重启策略

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

volumes

挂载一个目录或者一个已存在的数据卷容器

services:
  redis-6382: # 服务名称
    volumes: # 数据卷，目录挂载
      - /var/lib/mysql # 只指定一个目录，在容器内部创建容器卷
      - /usr/local/redis_cluster/master01/conf:/etc/redis
      - /usr/local/redis_cluster/master01/data:/data
1
2
3
4
5
6

volumes_from

从其他容器或服务挂载数据卷。

volumes_from:
  - service_name
  - service_name:ro
  - container:container_name
  - container:container_name:rw
1
2
3
4
5

working_dir

工作目录

示例

安装mysql以及redis集群

具体说明参考：

redis集群搭建过程

Mysql集群搭建过程

# 描述 Compose 文件的版本信息
version: "3.9"

# 定义服务，可以多个
services:
  mysql_master: # 服务名称
    image: mysql # 创建容器时所需的镜像
    container_name: mysql_master # 容器名称
    restart: always # 容器总是重新启动
    privileged: true
    volumes: # 数据卷，目录挂载
      - /usr/local/mysql_cluster/master/data:/var/lib/mysql:rw
      - /usr/local/mysql_cluster/master/conf/my.cnf:/etc/mysql/my.cnf
    environment:
        - MYSQL_ROOT_PASSWORD=******
  mysql_slave: # 服务名称
    image: mysql # 创建容器时所需的镜像
    container_name: mysql_slave # 容器名称
    restart: always # 容器总是重新启动
    privileged: true
    volumes: # 数据卷，目录挂载
      - /usr/local/mysql_cluster/slave/data:/var/lib/mysql:rw
      - /usr/local/mysql_cluster/slave/conf/my.cnf:/etc/mysql/my.cnf
    environment:
        - MYSQL_ROOT_PASSWORD=******
   redis-6382: # 服务名称
    image: redis:7.0 # 创建容器时所需的镜像
    container_name: redis-6382 # 容器名称
    restart: always # 容器总是重新启动
    network_mode: "host" # host 网络模式
    volumes: # 数据卷，目录挂载
      - /usr/local/redis_cluster/master01/conf:/etc/redis
      - /usr/local/redis_cluster/master01/data:/data
    command: redis-server /etc/redis/redis.conf # 覆盖容器启动后默认执行的命令

  redis-6383:
    image: redis:7.0 # 创建容器时所需的镜像
    container_name: redis-6383
    network_mode: "host"
    volumes:
      - /usr/local/redis_cluster/master02/conf:/etc/redis
      - /usr/local/redis_cluster/master02/data:/data
    command: redis-server /etc/redis/redis.conf

  redis-6384:
    image: redis:7.0 # 创建容器时所需的镜像
    container_name: redis-6384
    network_mode: "host"
    volumes:
      - /usr/local/redis_cluster/master03/conf:/etc/redis
      - /usr/local/redis_cluster/master03/data:/data
    command: redis-server /etc/redis/redis.conf

  redis-6385: # 服务名称
    image: redis:7.0 # 创建容器时所需的镜像
    container_name: redis-6385 # 容器名称
    restart: always # 容器总是重新启动
    network_mode: "host" # host 网络模式
    volumes: # 数据卷，目录挂载
      - /usr/local/redis_cluster/slave01/conf:/etc/redis
      - /usr/local/redis_cluster/slave01/data:/data
    command: redis-server /etc/redis/redis.conf

  redis-6386:
    image: redis:7.0 # 创建容器时所需的镜像
    container_name: redis-6386
    network_mode: "host"
    volumes:
      - /usr/local/redis_cluster/slave02/conf:/etc/redis
      - /usr/local/redis_cluster/slave02/data:/data
    command: redis-server /etc/redis/redis.conf

  redis-6387:
    image: redis:7.0 # 创建容器时所需的镜像
    container_name: redis-6387
    network_mode: "host"
    volumes:
      - /usr/local/redis_cluster/slave03/conf:/etc/redis
      - /usr/local/redis_cluster/slave03/data:/data
    command: redis-server /etc/redis/redis.conf

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