Dockerfile 是一个包含了如何创建一个 image 的指令的文件。文件开头通常指定用于创建这个 image 所使用的 base image。例如，想要创建一个基于 python 的 API，可以使用安装了 python 的 Linux 系统组成的 base image。指定了 base image 后，其他指令需要指定以下信息：
- container 需要设置的环境变量
- image 暴露的端口
- 需要被拷贝至 image 的文件
- 需要安装的依赖
- 运行 container 需要的命令（e.g
yarn start） - 更多其他信息...
下面是一个生成 Node.js API 的 image 的 Dockerfile：
# Base image that has Node version 12.16.1 installed on a Linux OS.
# This is an alpine Linux image that is smaller than the non-alpine Linux equivalent images.
FROM node:12.16.1-alpine3.11
# Installs some dependencies required for the Node.js API
RUN apk add --no-cache make g++
# Indicates that the API exposes port 3000
EXPOSE 3000
# Specifies the working directory. All the paths referenced after this point will be relative to this directory.
WORKDIR /usr/src/app
# Copy all local source files into the Docker container's working directory
COPY . .
# Installs NPM dependencies using yarn
RUN yarn install
# Command to start the API which will get executed when a Docker container using this image is started.
CMD [ "yarn", "start" ]下面表格列出了一些经常用的的指令。完整的指令可以在 Docker reference 文档中找到。
| Instruction | Description |
|---|---|
| FROM | 定义一个 base image |
| RUN | 需要执行的命令 |
| CMD | 运行 container 需要执行的命令 |
| EXPOSE | 指定暴露的端口信息 |
| ENV | 设定环境变量 |
| COPY | 拷贝文件或者目录至 image |
| ADD | COPY 指令的高级版本，COPY 比 ADD 命令更好 |
| ENTRYPOINT | 定义容器的可执行文件，查看与 CMD 之间的区别 |
| VOLUME | 指定 image 中的一个目录存储 volume。volume 将会被给予一个随机的名称，可以用 docker inspect 命令查看 |
| WORKDIR | 为 Dockerfile 中后续的指令指定工作目录 |
| ARG | 定义可以传递给 docker build --build-arg 命令的变量，并且可以用在 Dockerfile 文件中 |
为了防止某些文件被拷贝到 Docker image 中，可以在 Dockerfile 同级目录下创建一个 .dockerignore 文件，文件内容指定了那些不允许拷贝到 Docker image 中的文件，类似于 .gitignore。使用 .dockerignore 文件之前，确保你清楚它的正确语法。