Dockerfile教程

Dockerfile文件

  学会使用image文件以后，接下来的问题就是，如何可以生成image文件？如果你要推广自己的软件，势必要自己制作image文件。
  这就需要用到Dockerfile文件，它是一个文本文件，用来配置image。Docker根据该文件生成二进制的image文件。
  下面通过一个实例，演示如何编写Dockerfile文件。

制作Docker容器

  下面以koa-demos项目为例，介绍怎么写Dockerfile文件，实现让用户在Docker容器里面运行Koa框架。
  作为准备工作，请先下载源码：

$ git clone https://github.com/ruanyf/koa-demos.git
$ cd koa-demos

编写Dockerfile文件

  首先，在项目的根目录下，新建一个文本文件.dockerignore，写入下面的内容。

.git
node_modules
npm-debug.log

上面代码表示，这3个路径要排除，不要打包进入image文件。如果你没有路径要排除，这个文件可以不新建。
  然后，在项目的根目录下，新建一个文本文件Dockerfile，写入下面的内容。

FROM node:8.4
COPY . /app
WORKDIR /app
RUN npm install --registry=https://registry.npm.taobao.org
EXPOSE 3000

含义如下：

• FROM node:8.4：该image文件继承官方的node image，冒号表示标签，这里标签是8.4，即8.4版本的node。
• COPY . /app：将当前目录下的所有文件(除了.dockerignore排除的路径)，都拷贝进入image文件的/app目录。
• WORKDIR /app：指定接下来的工作路径为/app。
• RUN npm install：在/app目录下，运行npm install命令安装依赖。注意，安装后所有的依赖，都将打包进入image文件。
• EXPOSE 3000：将容器3000端口暴露出来，允许外部连接这个端口。

创建image文件

  有了Dockerfile文件以后，就可以使用docker image build命令创建image文件了：

$ docker image build -t koa-demo .
# 或者
$ docker image build -t koa-demo:0.0.1 .

在上面代码中，-t参数用来指定image文件的名字，后面还可以用冒号:指定标签。如果不指定，默认的标签就是latest。最后的那个点.表示Dockerfile文件所在的路径，因为当前路径，所以是一个点。
  如果运行成功，就可以看到新生成的image文件koa-demo了：

$ docker image ls

生成容器

  docker container run命令会从image文件生成容器：

$ docker container run -p 8000:3000 -it koa-demo /bin/bash
# 或者
$ docker container run -p 8000:3000 -it koa-demo:0.0.1 /bin/bash

上面命令的各个参数含义如下：

• -p：容器的3000端口映射到本机的8000端口。
• -it：容器的Shell映射到当前的Shell，然后你在本机窗口输入的命令，就会传入容器。
• koa-demo:0.0.1：image文件的名字。如果有标签，还需要提供标签，默认是latest标签。
• /bin/bash：容器启动以后，内部第一个执行的命令。这里是启动Bash，保证用户可以使用Shell。

如果一切正常，运行上面的命令以后，就会返回一个命令行提示符：

root@66d80f4aaf1e:/app#

这表示你已经在容器里面了，返回的提示符就是容器内部的Shell提示符。执行下面的命令：

root@66d80f4aaf1e:/app# node demos/01.js

这时，Koa框架已经运行起来了。打开本机的浏览器，访问http://127.0.0.1:8000，网页显示Not Found，这是因为这个demo没有写路由。
  这个例子中，Node进程运行在Docker容器的虚拟环境里面，进程接触到的文件系统和网络接口都是虚拟的，与本机的文件系统和网络接口是隔离的，因此需要定义容器与物理机的端口映射(Map)。
  现在，在容器的命令行，按下Ctrl + c停止Node进程，然后按下Ctrl + d(或者输入exit)退出容器。此外，也可以用docker container kill终止容器运行。

# 在本机的另一个终端窗口，查出容器的ID
$ docker container ls
# 停止指定的容器运行
$ docker container kill [containerID]

容器停止运行之后，并不会消失，用下面的命令删除容器文件：

# 查出容器的ID
$ docker container ls --all
# 删除指定的容器文件
$ docker container rm [containerID]

也可以使用docker container run命令的--rm参数，在容器终止运行后自动删除容器文件。

$ docker container run --rm -p 8000:3000 -it koa-demo /bin/bash

CMD命令

  上一节的例子里面，容器启动以后，需要手动输入命令node demos/01.js。我们可以把这个命令写在Dockerfile里面，这样容器启动以后，这个命令就已经执行了，不用再手动输入了：

FROM node:8.4
COPY . /app
WORKDIR /app
RUN npm install --registry=https://registry.npm.taobao.org
EXPOSE 3000
CMD node demos/01.js

上面的Dockerfile多了最后一行CMD node demos/01.js，它表示容器启动后自动执行node demos/01.js。
  你可能会问，RUN命令与CMD命令的区别在哪里？简单说，RUN命令在image文件的构建阶段执行，执行结果都会打包进入image文件；CMD命令则是在容器启动后执行。另外，一个Dockerfile可以包含多个RUN命令，但是只能有一个CMD命令。
  注意，指定了CMD命令以后，docker container run命令就不能附加命令了(比如前面的/bin/bash)，否则它会覆盖CMD命令。现在，启动容器可以使用下面的命令。

$ docker container run --rm -p 8000:3000 -it koa-demo:0.0.1