Dockerfile及Docker-compose Yaml

Dockerfile

一、结构：

1. 基础镜像信息

2. 维护者信息

3. 镜像操作指令

4. 容器启动时执行指令

   

---

FROM

指明构建的新镜像是来自于哪个基础镜像，例如：

FROM centos:6

---

MAINTAINER

指明镜像维护着及其联系方式（一般是邮箱地址），例如：

MAINTAINER Edison Zhou <xxx@xxx.com>

不过，MAINTAINER并不推荐使用，更推荐使用LABEL来指定镜像作者，例如：

LABEL maintainer="xxxxx.cn"

---

RUN

构建镜像时运行的Shell命令，例如：

RUN ["yum", "install", "httpd"]
RUN yum install httpd

---

CMD

启动容器时执行的Shell命令，例如：

CMD ["-C", "/start.sh"] 
CMD ["/usr/sbin/sshd", "-D"] 
CMD /usr/sbin/sshd -D

---

EXPOSE

声明容器运行的服务端口，例如：

EXPOSE 80 443

---

ENV

设置环境内环境变量，例如：

ENV MYSQL_ROOT_PASSWORD 123456
ENV JAVA_HOME /usr/local/jdk1.8.0_45

---

ADD

拷贝文件或目录到镜像中，例如：

ADD <src>...<dest>
ADD html.tar.gz /var/www/html
ADD https://xxx.com/html.tar.gz /var/www/html

***PS：***如果是URL或压缩包，会自动下载或自动解压

---

COPY

拷贝文件或目录到镜像中，用法同ADD，只是不支持自动下载和解压，例如：

COPY ./start.sh /start.sh

---

ENTRYPOINT

​ 启动容器时执行的Shell命令，同CMD类似，只是由ENTRYPOINT启动的程序不会被docker run命令行指定的参数所覆盖，而且，这些命令行参数会被当作参数传递给ENTRYPOINT指定指定的程序，例如：

ENTRYPOINT ["/bin/bash", "-C", "/start.sh"]
ENTRYPOINT /bin/bash -C '/start.sh'

***PS：***Dockerfile文件中也可以存在多个ENTRYPOINT指令，但仅有最后一个会生效。

---

VOLUME

​ 指定容器挂载点到宿主机自动生成的目录或其他容器，例如：

VOLUME ["/var/lib/mysql"]

***PS：***一般不会在Dockerfile中用到，更常见的还是在docker run的时候指定-v数据卷。

---

USER

为RUN、CMD和ENTRYPOINT执行Shell命令指定运行用户，例如：

USER <user>[:<usergroup>]
USER <UID>[:<UID>]
USER edisonzhou

---

WORKDIR

为RUN、CMD、ENTRYPOINT以及COPY和AND设置工作目录，例如：

WORKDIR /data

---

HEALTHCHECK

告诉Docker如何测试容器以检查它是否仍在工作，即健康检查，例如：

HEALTHCHECK --interval=5m --timeout=3s --retries=3 \
    CMD curl -f http:/localhost/ || exit 1

其中，一些选项的说明：

• –interval=DURATION (default: 30s)：每隔多长时间探测一次，默认30秒
• – timeout= DURATION (default: 30s)：服务响应超时时长，默认30秒
• –start-period= DURATION (default: 0s)：服务启动多久后开始探测，默认0秒
• –retries=N (default: 3)：认为检测失败几次为宕机，默认3次

一些返回值的说明：

• 0：容器成功是健康的，随时可以使用
• 1：不健康的容器无法正常工作
• 2：保留不使用此退出代码

---

ARG

在构建镜像时，指定一些参数，例如：

FROM centos:6
ARG user # ARG user=root
USER $user

这时，在docker build时可以带上自定义参数user了，如下所示：

docker build --build-arg user=xxxxx Dockerfile .

二、注意事项：

构建镜像最具挑战性的一点是使镜像体积尽可能的小

---

使用 .dockerignore 排除构建无关文件

.dockerignore` 语法与 `.gitignore` 语法一致。使用它排除构建无关的文件及目录，如 `node_modules

---

使用多阶段构建

​ 对于多阶段构建，可以在 Dockerfile 中使用多个 FROM 语句。每个 FROM 指令都可以使用不同的基镜像，并且它们都开始了构建的新阶段，示例如下：

FROM golang:1.7.3
WORKDIR /go/src/github.com/alexellis/href-counter/
RUN go get -d -v golang.org/x/net/html  
COPY app.go .
RUN CGO_ENABLED=0 GOOS=linux go build -a -installsuffix cgo -o app .

FROM alpine:latest  
RUN apk --no-cache add ca-certificates
WORKDIR /root/
COPY --from=0 /go/src/github.com/alexell