Dockerfile 入门实践

Dockerfile 入门实践

一些事项

  • 书写Dockerfile文件时，设定工作目录时，如果要忽略工作目录下的一些文件，可以使用 .dockerignore 文件
  • 变量设定默认值：${variable:-word}，当 variable 不存在或者为空是，最后的值为 word
  • 还有另一种格式：${variable:+word}，它表示当 variable 存在或者为真时，则返回 word

指令

FROM

  • FROM <registry>:<tag>

COPY

  • COPY <src> <dest>
  • 其中src是上下文中的目录（工作目录或工作子目录）；dest表示镜像中的目标路径
  • 目录自身不会复制过去，但其内容会全部复制过去（下方会做实践）
  • dest必须以 / 结尾，以表示目录
  • 先来个简单的Dockerfile：
FROM docker.io/nginx:1.15-alpine
MAINTAINER "SUHANYU <suhanyujie@qq.com>"
COPY index.html /mydata/
  • 此时进行构建：docker build -t testnginx:v0.1.0 .
  • 接着可以启动容器，并查看对应的目录 /mydata 下的文件 index.html 是否存在：docker run --name myinginx1 --rm testnginx:v0.1.0 cat /mydata/index.html
  • 接下来做个试验：将/etc/yum.repos.d目录下的文件复制到镜像中
  • 在之前的Dockerfile内容基础上继续写：
FROM docker.io/nginx:1.15-alpine
MAINTAINER "SUHANYU <suhanyujie@qq.com>"
COPY index.html /mydata/
COPY yum.repos.d /mydata/yumRepos/
  • 构建镜像：docker build -t testnginx:v0.1.2 .
  • 启动容器并查看：docker run --name myinginx1 --rm testnginx:v0.1.2 ls /mydata/yumRepos
  • 可以看到yum.repos.d目录本身并没有被拷贝进入 /mydata/yumRepos 中

ADD

  • ADD <src> <dest>
  • 向目标镜像文件中打包文件，如果 src 是上下文目录下的文件，并且是tar.gz之类的压缩文件，会进行解压到目标路径下。
  • src 如果是网络地址，则只会下载该文件，而不会解压。
  • dest 代表目标路径，路径必须以 / 结尾

ADD实践

  • 在Dockerfile中使用ADD：
FROM docker.io/nginx:1.15-alpine
MAINTAINER "SUHANYU <suhanyujie@qq.com>"
COPY index.html /mydata/
COPY yum.repos.d /mydata/yumRepos/
ADD http://nginx.org/download/nginx-1.15.8.tar.gz /usr/local/nginx/
  • 构建：docker build -t testnginx:v0.1.3 .，不要忘记后边有个 .
  • 启动容器，验证容器中是否存在下载后的文件：docker run --name myinginx1 --rm testnginx:v0.1.3 ls /usr/local/nginx

[root@localhost t0117]# docker run --name myinginx1 --rm testnginx:v0.1.3 ls /usr/local/nginx

nginx-1.15.8.tar.gz

WORKDIR

  • WORKDIR <dirpath>
  • 用于为Dockerfile中所有的RUN、CMD、ENTRYPOINT、COPY、ADD等指令设定工作目录

实践WORKDIR

  • 在Dockerfile中使用WORKDIR：
FROM docker.io/nginx:1.15-alpine
MAINTAINER "SUHANYU <suhanyujie@qq.com>"
COPY index.html /mydata/
COPY yum.repos.d /mydata/yumRepos/
WORKDIR /usr/local/nginx
ADD http://nginx.org/download/nginx-1.15.8.tar.gz ./src/
  • 在上面的指令中，在镜像里，先将工作目录切换到 /usr/local/nginx，然后下载 nginx-1.15.8.tar.gz 文件到基于工作目录/usr/local/nginx 下的 src 目录下
  • 构建镜像：docker build -t testnginx:v0.1.4 .
  • 启动容器，验证容器中是否存在下载后的文件：docker run --name myinginx1 --rm testnginx:v0.1.4 ls /usr/local/nginx/src

VOLUME

  • VOLUME <mountPoint>
  • 挂载数据卷

实践VOLUME

FROM docker.io/nginx:1.15-alpine
MAINTAINER "SUHANYU <suhanyujie@qq.com>"
COPY index.html /mydata/
COPY yum.repos.d /mydata/yumRepos/
WORKDIR /usr/local/nginx
ADD http://nginx.org/download/nginx-1.15.8.tar.gz ./src/
VOLUME /data/mysql
  • 构建镜像：docker build -t testnginx:v0.1.5 .
  • 启动容器，并查看挂载的情况：docker run --name myinginx1 --rm testnginx:v0.1.5 mount
  • 此时可以看到显示的结果中有一行如下：

/dev/mapper/centos-root on /data/mysql type xfs (rw,relatime,attr2,inode64,noquota)

  • 也可以使用 docker inspect {container} 的方式，查看挂载卷情况：
  • 启动容器：docker run --name myinginx1 --rm testnginx:v0.1.5 sleep 60
  • 此时，新开一个shell窗口，用命令行查看：docker inspect testginx:v0.1.5
  • 或者进入容器内部查看：docker exec -it myinginx1 sh
  • 可以看到存在文件夹：/data/mysql

EXPOSE

  • EXPOSE <port>[/protocol]
  • 其中protocol是指协议，值为：tcp或udp，默认为tcp
  • 也可暴露多个端口：EXPOSE 80/tcp 91/udp

EXPOSE实践

  • 编写Dockerfile：
FROM docker.io/nginx:1.15-alpine
MAINTAINER "SUHANYU <suhanyujie@qq.com>"
COPY index.html /mydata/
COPY yum.repos.d /mydata/yumRepos/
WORKDIR /usr/local/nginx
ADD nginx-1.15.8.tar.gz ./src/
VOLUME /data/mysql
EXPOSE 80/tcp
  • 构建：docker build -t testnginx:v0.1.6.1
  • 运行：docker run --name myinginx1 -P --rm testnginx:v0.1.6.1 sleep 60
  • -P 的作用就是暴露镜像中设定好的对外端口，而不用则命令行中额外指定
  • 此时可以查看docker port myinginx1，显示的是容器的端口对应宿主机上的端口

ENV

  • ENV <key> <value>
  • ENV <key>=<value>
  • 为镜像定义所需的环境变量
  • 第一种方式只能设置一个变量。第2中可以设置多个，如果value中包含空格，可以使用 \ 转义

实践ENV

  • 编写Dockerfile
FROM docker.io/nginx:1.15-alpine
MAINTAINER "SUHANYU <suhanyujie@qq.com>"
COPY index.html /mydata/
COPY yum.repos.d /mydata/yumRepos/
ENV PACKAGE_NAME=/nginx-1.15.8
WORKDIR /usr/local/nginx
ADD ${PACKAGE_NAME}.tar.gz ./src/
VOLUME /data/mysql
EXPOSE 80/tcp
  • 构建：docker build -t testnginx:v0.1.7 .
  • 启动：docker run --name myinginx1 -P --rm testnginx:v0.1.7 ls /usr/local/nginx/src/nginx-1.15.8
  • 此时之前的将nginx包放入镜像中的操作还是正常运行的。
  • 以上，是在build阶段，设定好环境变量，实际上在容器启动阶段，也可以进行设定环境变量，可以通过 docker run --help 查看命令，其中有一个 -e 参数，可以在run阶段设定环境变量

CMD

  • CMD <command>
  • CMD ["<executable>","<param1>","<param2>"]
  • CMD ["<param1>","<param2>"]
  • Dockerfile中可以有多个CMD指令，但只有最后一个会生效
  • 第3种方式，没有命令只有参数，它的作用可以用于为 ENTRYPOINT 提供参数

ENTRYPOINT

  • ENTRYPOINT [<"excutable","param1","param2">]
  • 启动容器时，可以使用自定义的命令覆盖镜像中默认的命令

ENTRYPOINT实践

  • 编写Dockerfile
FROM docker.io/nginx:1.15-alpine
MAINTAINER "SUHANYU <suhanyujie@qq.com>"
COPY index.html /mydata/
COPY yum.repos.d /mydata/yumRepos/
ENV PACKAGE_NAME=nginx-1.15.8
WORKDIR /usr/local/nginx
#ADD ${PACKAGE_NAME}.tar.gz ./src/
COPY ${PACKAGE_NAME}.tar.gz ./src/
#ADD http://nginx.org/download/${PACKAGE_NAME}.tar.gz ./src/
RUN mkdir -p /data/nginx && \
        tar xf ./src/${PACKAGE_NAME}.tar.gz -C /data/nginx
ADD entrypoint.sh /bin/

VOLUME /data/mysql
EXPOSE 80/tcp
CMD ["/usr/sbin/nginx","-g","daemon off;"]
ENTRYPOINT ["/bin/entrypoint.sh"]
  • 其中entrypoint.sh的内容如下：
#!/bin/sh
#
cat > /etc/nginx/conf.d/www.conf << EOF
server{
        server_name $HOSTNAME;
        listen ${IP:-0.0.0.0}:${PORT:-80};
        root ${NGX_DOC_ROOT:-/usr/share/nginx/html};
}
EOF
exec "$@";
  • 注意，在ENTRYPOINT的命令里，不可写成 ENTRYPOINT ["/bin/entrypoint.sh;"]，也即是不能加上分号
  • 构建：docker build -t testnginx:v0.1.9.14 .
  • 启动容器查看：docker run --name myinginx1 -P --rm testnginx:v0.1.9.14 ls /bin

USER

  • USER <uid>/<userName>
  • 运行容器时指定用户名或用户id

HEALTHCHECK

  • HEALTHCHECK <option> <command>
  • 健康检查，检查容器的状态是否正常
  • 例如：HEALTHCHECK --start-period=3s CMD wget -0 - -q http://${IP:-0.0.0.0}:${PORT:-80}/

ARG

  • ARG <name>[=<default value>]
  • 适用于build时
  • 在构建的命令中，可以使用 --build-arg <name>=<value> 进行设定

ARG实践

  • 例如在编写Dockerfile时：
FROM docker.io/nginx:1.15-alpine
#MAINTAINER "SUHANYU <suhanyujie@qq.com>"
ARG maintainer="SUHANYU <suhanyujie@qq.com>"
LABEL "maintainer ${maintainer}"
COPY index.html /mydata/
COPY yum.repos.d /mydata/yumRepos/
ENV PACKAGE_NAME=nginx-1.15.8
WORKDIR /usr/local/nginx
#ADD ${PACKAGE_NAME}.tar.gz ./src/
COPY ${PACKAGE_NAME}.tar.gz ./src/
#ADD http://nginx.org/download/${PACKAGE_NAME}.tar.gz ./src/
RUN mkdir -p /data/nginx && \
        tar xf ./src/${PACKAGE_NAME}.tar.gz -C /data/nginx
ADD entrypoint.sh /bin/

VOLUME /data/mysql
EXPOSE 80/tcp
CMD ["/usr/sbin/nginx","-g","daemon off;"]
ENTRYPOINT ["/bin/entrypoint.sh"]
  • 构建：docker build -t testnginx:v.0.1.10.1 .
  • 查看：docker image inspect testnginx:v0.1.10.1
  • 此时，可以看到其中的LABEL中有所设定的值
  • 重新构建，在构建的命令中设定arg：docker build --build-arg maintainer="<suhanyujie@qq.com>" -t testnginx:v0.1.10.2 .
  • 查看：docker image inspect testnginx:v0.1.10.2
  • 此时，可以在输出中看到，包含如下的LABEL内容：
"Labels": {
                "maintainer": "<suhanyujie@qq.com>"
            },

ONBUILD

  • ONBUILD <instruction>
  • 在Dockerfile中定义一个触发器
  • 例如你已经构建了一个镜像 testnginx:v0.1.10.1，并且在你构建 testnginx:v0.1.10.1 时，你使用了 ONBUILD。在此基础上，如果构建一个新的镜像是，并且是 FROM testnginx:v0.1.10.1，此时构建这个新镜像时就会触发执行上一个镜像的 ONBUILD 所对应的指令。

RUN

RUN

* RUN <command>
* RUN ["<executable>","<param1>","<param2>"]
* 第1中方式中，command通常是一个shell命令，以 `/bin/sh -c` 的方式运行
  • RUN <command>
  • RUN ["<executable>","<param1>","<param2>"]
  • 如果要运行的命令依赖于shell特性，可以使用如下的方式：

RUN ["/bin/sh","-c","<executable>","<param1>"]

其他

  • 运行在docker容器中的服务，一般是shell的子进程
  • 在linux系统中，后台运行的服务程序一般是init的子进程，也就是管理进程的子进程
posted @ 2019-10-17 23:51  浪淘沙&  阅读(42)  评论(0)  编辑  收藏  举报