Docker镜像构建
Posted lonelyxmas
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Docker镜像构建相关的知识,希望对你有一定的参考价值。
一、简介
- 使用现有的容器使用docker commit 生成镜像
- 使用Dockerfile进行镜像构建
二、Dockerfile介绍
语法规则
环境变量引用
docker build命令
- -t, --tag list 指定生成镜像标签,格式为name:tag
- -f, --file string 单独指定Dockerfile文件位置
- --build-arg list 设置构建时的变量
- --no-cache 构建镜像时候不使用缓存
快速开始
mkdir /opt/demo -p
cd /opt/demo/
FROM centos:latest #指定基础镜像为centos LABEL Author=“wd” #指明作者 RUN yum install -y yum epel-release && yum install -y nginx && echo "${HOSTNAME}-nginx server" > /usr/share/nginx/html/index.html #运行命令安装Nginx CMD [ "/usr/sbin/nginx", "-g", "daemon off;", "-c", "/etc/nginx/nginx.conf”] #启动容器运行的命令
[[email protected] demo]# docker build -t nginx:v1 ./ Sending build context to Docker daemon 2.048kB Step 1/4 : FROM centos:latest ---> 1e1148e4cc2c Step 2/4 : LABEL Author="wd" ---> Using cache ---> 8eb3ffcb8ba3 Step 3/4 : RUN yum install -y yum epel-release && yum install -y nginx && echo "${HOSTNAME}-nginx server" > /usr/share/nginx/html/index.html ---> Using cache ---> ac91999a716e Step 4/4 : CMD [ "/usr/sbin/nginx", "-g", "daemon off;", "-c", "/etc/nginx/nginx.conf"] ---> Running in 323afd4ac89d Removing intermediate container 323afd4ac89d ---> 6403c553fd04 Successfully built 6403c553fd04 Successfully tagged nginx:v1
[[email protected] demo]# docker run -d --name nginx-demo-c1 -p 8088:80 nginx:v1 08812b7def62c9ad7879dfa4182bc28a20f524e2dbc5eb6e4fe63d2b67be3cc9 [[email protected] demo]# curl http://127.0.0.1:8088 60e5de135132-nginx server #访问成功 [[email protected] demo]#
三、指令详解
FROM
FROM <repository> FROM <repository>[:<tag>] FROM <repository>@<digest>
FROM centos:latest
LABEL
LABEL <key>=<value> <key>=<value> <key>=<value> ...
示例:
LABEL "com.example.vendor"="ACME Incorporated” LABEL maintainer="[email protected]"
MAINTAINER (deprecated)
MAINTAINER <message>
MAINTAINER "wd <[email protected]>"
COPY
用于主机中的文件或者复制到镜像中
语法:
COPY [--chown=<user>:<group>] <src>... <dest> COPY [--chown=<user>:<group>] ["<src>",... "<dest>"]
- 如果复制的src或dest中存在空格字符需使用第二种加双引号方式
- src必须是 build的上下文目录(Dockerfile同级目录或子目录),不能是父目录或者绝对路径
- 如果指定来多个src或者src中使用了通配符,则dest必须是一个目录,且必须以/结尾
COPY hom* /mydir/ #拷贝以hom开头的的所有文件 COPY hom?.txt /mydir/ #?代表占位符,可以拷贝
ADD
ADD指令类似于COPY,但是ADD比COPY更强大,支持TAR文件和URL路径
语法:
ADD [--chown=<user>:<group>] <src>... <dest> ADD [--chown=<user>:<group>] ["<src>",... "<dest>"]
- 当src是URL时,如果dest不以/结尾,则src指定的文件将被下载并且被创建为dest,如果dest以/结尾,则src指定下载的文件会保存在dest目录下。
- 当src是一个本地目录的一个tar压缩格式文件,其在容器中会被展开为目录,类型与tar -x命令,通过URL下载的tar文件则不会被解压。
- 如果指定来多个src或者src中使用了通配符,则dest必须是一个目录,且必须以/结尾,多个文件一同被复制在dest目录下
ADD hom* /mydir/
ADD hom?.txt /mydir/
WORKDIR
WORKDIR dirpath
示例:
WORKDIR /usr/local
ENV
用于为镜像定义所需的环境变量,并可被Dockfile中位于其以后的指令所调用,如ADD、COPY、RUN等调用格式为$variable_name或者${variable_name},此外在启动容器时候这些变量也是存在的。
语法:
ENV <key> <value>
ENV <key>=<value> ...
- 第一种格式中key之后的所有值会被作为value,因此一次只能设置一个变量
- 第二种格式可一次性设置多个变量,每个变量为一个key=value的键值对,如果value种包含空格,可以用反斜线()转义,也可以通过对value加引号进行标识,此外反斜线也可用于续行,多个变量时候建议使用。
示例:
ENV myName="John Doe” myDog=Rex myCat=fluffy ENV myCat fluffy
RUN
用于在build过程中运行的程序,可以是任何指令,可以指定多个RUN
语法:
RUN <command> #shell 格式默认linux采用/bin/sh -c,windows采用cmd /S /C RUN ["executable", "param1", "param2”] #可执行程序格式
示例:
RUN yum install -y nginx RUN ["/bin/bash", "-c", "echo hello"]
EXPOSE
用于为容器暴露端口到外部,用于实现通讯,类似于docker run的-p选项
语法:
EXPOSE <port> [<port>/<protocol>...]
EXPOSE 8080
EXPOSE 8080/udp 8088/tcp
VOLUME
用于在image中创建一个挂载目录,以挂载宿主机上的目录
语法:
VOLUME <path> VOLUME ["path"]
VOLUME ["/var/log/“] VOLUME /myvol
CMD
CMD command param1 param2 #shell格式,含有shell环境 CMD ["executable","param1","param2”] #可执行程序格式 CMD ["param1","param2”] #第三种用于为ENTRYPOINT提供默认参数
注意:
- 在第一种格式中command 通常是一个shell命令,且默认以/bin/sh -c来运行它,这意味着此进程在容器的的PID不为1,不能接受unix信号,因此使用docker stop <container>命令停止容器时,此进程接受不到SIGTERM信号。
- 第二种格式是可执行程序运行方式,不会以"/bin/sh -c”来发起,无shell环境,所有shell变量不能引用,但是可以用"/bin/bash -c”作为启动命令达到第一种格式效果
- 第三种格式需要结合ENTRYPOINT使用,作用是为其提供默认参数
ENTRYPOINT
ENTRYPOINT <command> ENTRYPOINT ["<executable>", "<param1>", "<param2>"]
- 与CMD类似,第一种方式默认会以/bin/sh -c 启动,而第二种则不会,也就意味着没有shell环境
- 通常ENTRPOINT用于使用ENTRPOINT脚本启动
- 当CMD与ENTRYPOINT同时存在时,CMD的参数为ENTRYPOINT提供
示例:
[“nginx”,"-g","daemon off"]
USER
USER <user>[:<group>]
USER <UID>[:<GID>]
- 指定的USER或者GROUP必须在容器中存在,否则指令会运行失败
USER nginx
STOPSIGNAL
语法:
STOPSIGNAL signal
示例:
STOPSIGNAL SIGKILL
- 向容器发送信号只能被PID=1的进程所接收,当PID=1进程不是应用进程时候,应用进程收不到终止信号。
HEALTHCHECK
HEALTHCHECK [OPTIONS] CMD command
其中OPTIONS有如下选项:
- --interval=DURATION 检查间隔(默认: 30s)
- --timeout=DURATION 超时时间(默认t: 30s)
- --start-period=DURATION 等待检查的时间,默认0s代表一启动就检查 (默认: 0s)
- --retries=N (default: 3) 重试次数
示例:
HEALTHCHECK --interval=5m --timeout=3s CMD curl -f http://localhost/ || exit 1
SHELL
将可执行程序运行为shell环境,默认以/bin/sh -c运行
语法:
SHELL ["executable", "parameters"]
示例:
SHELL ["echo", “hello"] #等价于 RUN echo hello
ARG
ARG <name>[=<default value>]
FROM nginx ARG CONF="/tmp/nginx.conf" LABEL Author=wd RUN touch "${CONF}"
构建镜像:
[[email protected] ~]# docker build --build-arg CONF=‘/etc/test.conf‘ -t nginx:v15.2 ./ Sending build context to Docker daemon 225.6MB Step 1/4 : FROM nginx ---> f09fe80eb0e7 Step 2/4 : ARG CONF="/tmp/nginx.conf" ---> Using cache ---> ac081589c644 Step 3/4 : LABEL Author=wd ---> Using cache ---> 53b9b0ba4460 Step 4/4 : RUN touch "${CONF}" ---> Running in 50debe96f876 Removing intermediate container 50debe96f876 ---> d8680a2433bc Successfully built d8680a2433bc Successfully tagged nginx:v15.2
运行容器查看:
[[email protected] ~]# docker run --rm nginx:v15.2 ls /etc/test.conf -l -rw-r--r-- 1 root root 0 Feb 27 11:18 /etc/test.conf
ONBULD
用于在Dockerfile中定义一个触发器,当制作出来的镜像被别人用于基础镜像时候自动触发。
语法:
ONBUILD [INSTRUCTION]
- ONBUILD不会触发FROM指令。
- 在镜像标签中应明确指出onbuild关键字,以标记使用其基础镜像会触发其他指令
示例:
ONBUILD ADD . /app/src
ONBUILD RUN /usr/local/bin/python-build --dir /app/src
四、使用multi-stage
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/alexellis/href-counter/app . CMD ["./app"]
命名stage
默认情况下,stage未命名,可以通过整数来引用它们,第一个stage表示0,第二个表1以此类推。 但是,当有多个stage时候,这样会显得麻烦,Docker提供AS 语法可以为stage命名:
FROM golang:1.7.3 as builder
然后在另一个stage中使用:
COPY --from=builder /go/src/github.com/alexellis/href-counter/app .
使用本地stage
除了可以使用Dockerfile中的stage外,构建镜像时候还可以直接使用本地已存在的环境和产物,例如:
COPY --from=nginx:latest /etc/nginx/nginx.conf /nginx.conf
构建镜像建议
- 基础镜像尽量选择比体积较小的镜像,如每个官方发行的alpine镜像。虽然这版本镜像比较小,但是与之带来的是利用该类镜像运行的容器中排错的命令很少;
- 使用RUN指令时候,尽量把多个RUN指令合并为一个,通常做法是使用&&符号;
- 通过multi-stage方法减少一些不必要使用的环境来减小镜像;
- 安装完成软件同时删除一些不需要的文件或目录;
以上是关于Docker镜像构建的主要内容,如果未能解决你的问题,请参考以下文章
构建Docker镜像两种方式的比较-Dockerfile方式和S2I方式
Docker删除报错:Error response from daemon: conflict: unable to delete 08b152afcfae (must be forced)(代码片段