Dockerfile最佳实践

前言

本文参考Docker官方文档
撰写Dockerfile我们有几个大前提

1. 变化最少的部分放在Dockerfile的前面，变化大的放在后面，这样持续集成的时候可以重复使用之前的layer
2. 一个容器应该只运行单个应用，不要写一个脚本在一个容器中同时运行多个应用

构建高效和可维护的镜像

.dockerignore

1. 防止不需要的文件拷贝到build context
2. 写法和.gitignore相似，请参考

使用多阶段构建

FROM golang:1.11.1-alpine AS build

# Install tools required for project
# Run `docker build --no-cache .` to update dependencies
RUN apk add --no-cache git
RUN go get github.com/golang/dep/cmd/dep

# List project dependencies with Gopkg.toml and Gopkg.lock
# These layers are only re-built when Gopkg files are updated
COPY Gopkg.lock Gopkg.toml /go/src/project/
WORKDIR /go/src/project/
# Install library dependencies
RUN dep ensure -vendor-only

# Copy the entire project and build it
# This layer is rebuilt when a file changes in the project directory
COPY . /go/src/project/
RUN go build -o /bin/project

# This results in a single layer image
FROM scratch
COPY --from=build /bin/project /bin/project
ENTRYPOINT ["/bin/project"]
CMD ["--help"]

FROM

1. FROM基础镜像时最好精确到最小范围的版本，而不要直接使用大版本和latest。比如FROM golang:1.12.1, 而不是FROM golang:1.12, FROM golang:latest
2. 可以根据需要选择alpine镜像，不过编译时可能要添加CGO_ENABLED=0

RUN

1. 将多个RUN指令合并到一个
2. 每个RUN指令后删除多余文件，例如：

FROM ubuntu:16.04

RUN apt-get update \
    && apt-get install -y nodejs \
    # added lines
    && rm -rf /var/lib/apt/lists/*

ADD . /app
RUN cd /app && npm install

CMD npm start

COPY&ADD

1. 尽量将多个COPY指令合并到一个
2. 尽量将多个ADD指令合并到一个
3. COPY指令非常简单，仅用于将文件拷贝到镜像中。ADD相对来讲复杂一些，可以用于下载远程文件以及解压压缩包

• 如果你确定只是拷贝文件进入镜像中，那么直接使用COPY
• 如果你是需要下载文件等，那么使用ADD

COPY&RUN

我们应该把变化最少的部分放在 Dockerfile 的前面，这样可以充分利用镜像缓存。

示例中，源代码会经常变化，则每次构建镜像时都需要重新安装 NPM 模块，这显然不是我们希望看到的。因此我们可以先拷贝package.json，然后安装 NPM 模块，最后才拷贝其余的源代码。这样的话，即使源代码变化，也不需要重新安装 NPM 模块。

FROM node:10.18.1-alpine3.9

WORKDIR /app

COPY package.json /app
RUN npm install
COPY . /app

ENTRYPOINT ["./entrypoint.sh"]
CMD ["start"]

LABEL

1. 尽量把多个LABEL标签合并
   例如：

# Set multiple labels on one line
LABEL com.example.version="0.0.1-beta" com.example.release-date="2015-02-12"

# Set multiple labels at once, using line-continuation characters to break long lines
LABEL vendor=ACME\ Incorporated \
      com.example.is-beta= \
      com.example.is-production="" \
      com.example.version="0.0.1-beta" \
      com.example.release-date="2015-02-12"