Dockerfile
文章目录
1.Dockerfile简介
1.1基本结构
Dockerfile 是一个文本格式的配置文件,用户可以使用 Dockerfile 快速创建自定义镜像。
Dockerfile 由一行行命令语句组成,并且支持以 # 开头的注释行。
Docker分为四部分:
- 基础镜像信息
- 维护者信息
- 镜像操作指令
- 容器启动时默认要执行的指令
例如:
# This dockerfile uses the ubuntu image
# VERSION 2 - EDITION 1
# Author: seancheng
# Command format: Instruction [arguments / command] ...
# 第一行必须指定基于的基础镜像
FROM ubuntu
# 维护者信息
LABEL MAINTAINER='seancheng xianshangxian@126.com'
# 镜像操作指令
RUN echo "deb http://archive.ubuntu.com/ubuntu/ raring main universe" >> /etc/apt/sources.list
RUN apt-get update && apt-get install -y nginx
RUN echo "\ndaemon off;" >> /etc/nginx/nginx.conf
# 容器启动时默认要执行的指令
CMD /usr/sbin/nginx
其中,一开始必须指明所基于的镜像名称,接下来一般会说明维护者信息。
后面则是镜像操作指令,例如RUN指令,RUN指令将对镜像执行跟随的命令。每运行一条RUN指令,镜像添加新的一层,并提交。
最后是CMD指令来指定运行容器时的操作指令。
1.2Dockerfile构建过程
基础知识
1.每个保留关键字(指令)都是必须是⼤写字⺟
2.执⾏从上到下顺序执⾏
3.表示注释
4.每⼀个指令都会创建⼀个新的镜像层,并提交
步骤
-
docker从基础镜像运⾏⼀个容器,执⾏⼀条指令并对容器做出修改
-
执⾏类似 docker commit 的操作提交⼀个新的镜像层
-
Docker再基于刚提交的镜像运⾏⼀个新容器
-
执⾏dockerfile中的下⼀条指令直到所有指令都执⾏完成
具体说明
dockerfile是⾯向开发的,以后要发布项⽬,做镜像,就需要编写dockerfile⽂件。
DockerFile: 构建⽂件,定义了⼀切步骤,源代码!!!
DockerImages:在DockerFile 定义了⼀个⽂件之后,Docker build 时会产⽣⼀个Docker镜像,当运⾏
Docker 镜像时,会真正开始提供服务。
Docker容器:容器就是镜像运⾏起来的提供服务器
1.3dockerfile常用指令
-
FROM 这个镜像的父亲是谁?(指定基础【base】镜像)
-
MAINTAINER 告诉别人,它的作者?(指定维护者信息,可以没有)
-
RUN 容器构建时需要运行的命令(在命令前面加上RUN即可 ps:用来执行shell 命令)
-
ADD 将宿主机目录下的文件拷贝进镜像且会自动处理URL和解压tar压缩包
-
WORKDIR 指定在创建容器后,终端默认登陆的进来工作目录,一个落脚点(设置当前工作目录)
-
VOLUME 容器数据卷,用于数据保存和持久化工作(设置卷,挂载主机目录)
-
EXPOSE 当前容器对外暴露出的端口(指定对外的端口)
-
CMD 指定容器启动后的要干的事情
-
Dockerfile 中可以有多个 CMD 指令,但只有最后一个生效,CMD 会被 docker run 之后的参数替换
-
COPY 复制文件 (从容器外 复制到容器内,ps:建议同一目录下)
-
ENV 用来在构建镜像过程中设置环境变量
-
USER 指定该镜像以什么样的用户去执行,如果都不指定,默认是root
-
ENTRYPOINT 容器启动后执行的命令
FROM
格式为FROM <image>
或FROM <image>:<tag>
。
第一条指令必须为FROM指令。并且,如果在同一个Dockerfile中创建多个镜像时,可以使用多个FROM指令(每个镜像一次)。
LABEL MAINTAINER
格式为LABEL MAINTAINER <name email_address>
,指定维护者信息
RUN
格式为RUN <command>
或RUN ["executable","param1","param2"]
。
前者将在shell终端中运行命令,即/bin/sh -c;后者则使用exec执行。指定使用其他终端可以通过第二种方式实现,例如:
RUN ["/bin/bash","-c","echo hello"]
每条RUN指令将在当前镜像基础上执行指定命令,并提交为新的镜像。当命令较长时可以使用 \ 来换行,例如:
RUN echo "hello world\nhello tom" > /tmp/abc && \
cat /tmp/abc
CMD
CMD支持三种格式:
CMD ["executable","param1","param2"]
使用exec执行,推荐方式CMD command param1 param2
在/bin/sh中执行,提供给需要交互的应用CMD ["param1","param2"]
提供给ENTRYPOINT的默认参数
CMD用于指定启动容器时默认要执行的命令,每个Dockerfile只能有一条CMD命令。如果指定了多条命令,只有最后一条会被执行。
如果用户启动容器时指定了运行的命令,则会覆盖掉CMD指定的命令。
EXPOSE
格式为EXPOSE <port> [<port>...]
。
例如:
EXPOSE 22 80 8443
EXPOSE用于告诉Docker服务器容器暴露的端口号,供互联系统使用。
在启动容器时通过-P,Docker主机会自动分配一个端口转发到指定的端口;
使用-p则可以具体指定哪个本地端口映射过来。
ENV
格式为ENV <key> <value>
。指定一个环境变量,会被后续RUN指令使用,并在容器运行时保持。例如:
ENV PG_MAJOR 9.3
ENV PG_VERSION 9.3.4
RUN curl -SL http://example.com/postgres-$PG_VERSION.tar.xz | tar -xJC /usr/src/postgress && ...
ENV PATH /usr/local/postgres-$PG_MAJOR/bin:$PATH
ADD
格式为ADD <src> <dest>
。
该命令将复制指定的到容器中的。其中可以是Dockerfile所在目录的一个相对路径(文件或目录);也可以是一个URL;还可以是一个tar文件(会自动解压为目录)。
COPY
格式为COPY <src> <dest>
。
复制本地主机的(为Dockerfile所在目录的相对路径,文件或目录)为容器中的。目标路径不存在时会自动创建。
当使用本地目录为源目录时,推荐使用COPY。
ENTRYPOINT
ENTRYPOINT有两种格式:
- ENTRYPOINT [“executable”,“param1”,“param2”]
- ENTRYPOINT command param1 param2(在shell中执行)
配置容器启动后执行的命令,并且不可被docker run提供的参数覆盖。而且,如果在docker run的后面提供了参数,这些命令行参数会被当作参数传递给ENTRYPOINT指定的程序。
每个Dockerfile中只能有一个ENTRYPOINT,当指定多个ENTRYPOINT时,只有最后一个生效。
VOLUME
格式为VOLUME ["/data"]
。
创建一个可以从本地主机或其他容器挂载的挂载点,一般用来存放数据库和需要保持的数据等。
USER
格式为USER daemon
。
指定运行容器时的用户名或UID,后续的RUN也会使用指定用户。
当服务不需要管理员权限时,可以通过该命令指定运行用户。并且可以在之前创建所需要的用户,例如:
RUN groupadd -r postgres && useradd -r -g postgres postgres
要临时获取管理员权限可以使用gosu,而不推荐sudo。如果不指定,容器默认是root运行。
WORKDIR
格式为WORKDIR /path/to/workdir
。
为后续的RUN、CMD、ENTRYPOINT指令配置工作目录。
可以使用多个WORKDIR指令,后续命令如果参数是相对路径,则会基于之前命令指定的路径。例如:
WORKDIR /a
WORKDIR b
WORKDIR c
RUN pwd
则最终路径为/a/b/c。
ONBUILD
格式为ONBUILD [INSTRUCTION]
。
配置当所创建的镜像作为其他镜像的基础镜像时,所执行的操作指令。
例如,Dockerfile使用如下的内容创建了镜像image-A
[...]
ONBUILD ADD . /app/src
ONBUILD RUN /usr/local/bin/python-build --dir /app/src
[...]
此时,如果基于image-A创建新的镜像时,新的Dockerfile中使用FROM image-A指定基础镜像时,会自动执行ONBUILD指令的内容,等价于在后面添加了两条指令。
FROM image-A
# Automatically run the following
ADD . /app/src
RUN /usr/local/bin/python-build --dir /app/src
使用ONBUILD指令的镜像,推荐在标签中注明,例如ruby:1.9-onbuild。
2创建镜像
2.1项目目录
[root@192 httpd]# tree
.
|-- Dockerfile
`-- files
|-- apr-1.6.5.tar.gz
|-- apr-util-1.6.1.tar.gz
|-- entrypoint.sh
`-- httpd-2.4.54.tar.gz
1 directory, 5 files
[root@192 httpd]# ls
Dockerfile files
entrypoint.sh脚本文件内容
[root@192 httpd]# cd files/
[root@192 files]# cat entrypoint.sh
#!/bin/bash
sed -i '/#ServerName/s/#//g' /usr/local/apache/conf/httpd.conf
exec "$@"
2.2基于alpine制作httpd镜像的dockerfile
[root@192 httpd]# cat Dockerfile
FROM alpine
LABEL MAINTAINER "lx 2327303224@qq.com"
ENV httpd_version=2.4.54
ENV PATH=/usr/local/apache/bin:$PATH
ADD files/apr-1.6.5.tar.gz files/apr-util-1.6.1.tar.gz files/httpd-${httpd_version}.tar.gz /tmp/
RUN sed -i 's/dl-cdn.alpinelinux.org/mirrors.aliyun.com/g' /etc/apk/repositories && \
apk update && \
apk add --no-cache -U gcc make libc-dev openssl-dev expat-dev libtool pcre-dev && \
adduser -H -S -s /sbin/nologin apache && \
cd /tmp/apr-1.6.5 && \
sed -i '/$RM "$cfgfile"/d' configure && \
./configure --prefix=/usr/local/apr && \
make && make install && \
cd ../apr-util-1.6.1 && \
./configure --prefix=/usr/local/apr-util --with-apr=/usr/local/apr && \
make && make install && \
cd ../httpd-$httpd_version && \
./configure --prefix=/usr/local/apache \
--enable-so \
--enable-ssl \
--enable-cgi \
--enable-rewrite \
--with-zlib \
--with-pcre \
--with-apr=/usr/local/apr \
--with-apr-util=/usr/local/apr-util/ \
--enable-modules=most \
--enable-mpms-shared=all \
--with-mpm=prefork && make -j $(nproc) && make install && \
sed -i '/#ServerName/s/#//g' /usr/local/apache/conf/httpd.conf && \
apk del gcc make && \
rm -rf /tmp/* && \
rm -rf /var/cache/*
WORKDIR /usr/local/apache
EXPOSE 80
CMD ["-D","FOREGROUND"]
ENTRYPOINT ["apachectl"]
2.3 创建镜像
[root@192 httpd]# podman build -t docker.io/xiaopihai123/httpd:v0.6 .
2.4创建容器测试
[root@192 httpd]# podman images
REPOSITORY TAG IMAGE ID CREATED SIZE
docker.io/xiaopihai123/httpd v0.6 aabf9a4202cd About a minute ago 119 MB
localhost/httpd v0.3 5a72c8d16336 34 hours ago 404 MB
docker.io/library/alpine latest 9c6f07244728 3 weeks ago 5.83 MB
localhost/xiaopihai123/alpine v0.1 9c6f07244728 3 weeks ago 5.83 MB
docker.io/library/busybox latest 7a80323521cc 4 weeks ago 1.47 MB
docker.io/library/centos latest 5d0da3dc9764 11 months ago 239 MB
registry.fedoraproject.org/f29/httpd latest 25c76f9dcdb5 3 years ago 482 MB
[root@192 httpd]# podman run -d docker.io/xiaopihai123/httpd:v0.6
1bf8d1c1c847cf7fc48fcb612d5817f1178345114707c5e908d4f21832fcba8b
[root@192 httpd]# podman ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
1bf8d1c1c847 docker.io/xiaopihai123/httpd:v0.6 -D FOREGROUND 6 seconds ago Up 6 seconds ago nostalgic_lehmann
[root@192 httpd]# podman inspect -l | grep 'ipaddr'
[root@192 httpd]# podman inspect -l | grep -i ipaddr
"IPAddress": "10.88.0.2",
"IPAddress": "10.88.0.2",
[root@192 httpd]# crul 10.88.0.2
-bash: crul: command not found
[root@192 httpd]# curl 10.88.0.2
<html><body><h1>It works!</h1></body></html>
上传镜像
[root@192 httpd]# docker login
Username: xiaopihai123
Password:
Login Succeeded!
[root@192 httpd]# docker push docker.io/xiaopihai123/httpd:v0.6
Getting image source signatures
Copying blob b62ec57c2d6e done
Copying blob 5210c423cfb5 done
Copying blob 994393dc58e7 skipped: already exists
Copying config aabf9a4202 done
Writing manifest to image destination
Storing signatures
pd]# docker login
Username: xiaopihai123
Password:
Login Succeeded!
[root@192 httpd]# docker push docker.io/xiaopihai123/httpd:v0.6
Getting image source signatures
Copying blob b62ec57c2d6e done
Copying blob 5210c423cfb5 done
Copying blob 994393dc58e7 skipped: already exists
Copying config aabf9a4202 done
Writing manifest to image destination
Storing signatures