标签:quota mapping echo entry 配置文件 cgroup des 也有 exec
FROM命令:repository为基础镜像(base image)的名称,tag为base image的标签,不指定就是latest。如果不指定registry,就从docker hub上拉取。
FROM <registry><repository>[:<tag>]
FROM <registry><repository>@<digest>
当从外部registry拉image时,image有可能被别人替换了,但是repository名字相同,所以不安全。digest是image的hash值,所以指定了digest就不会被别人替换掉了。
MAINTAINER(不推荐使用,被LABLE替代了)命令:用于让dockerfile制作者提供本人的详细信息。
MAINTAINER可以出现在任何位置,但推荐放到FROM后面。
LABEL命令:用于指定元数据,比如作者,文件大小等。
COPY命令:复制宿主机里的文件或目录到:要build出的image的文件系统的某个目录里。
语法:
文件复制准则:
src必须是dockerfile里面的文件或目录,不能是其父目录中的文件或路径。
如果src是目录,则其内部文件或子目录都会被递归复制,但src目录自身不会被复制。
相当于:cp src/* /dest。
如果指定了多个src,或在src中使用了通配符,则dest必须是目录,且必须以/结尾。
如果dest事先不存在,它将会被自动创建,其父目录也会被一并创建。
比如COPY命令,如果目标目录相同,则最好只使用一次COPY。虽然使用多次COPY也不出错误,但是会多出层,性能不好。
获取帮助信息:
# docker build --help
Usage: docker build [OPTIONS] PATH | URL | -
Build an image from a Dockerfile
Options:
--add-host list Add a custom host-to-IP mapping (host:ip)
--build-arg list Set build-time variables
--cache-from strings Images to consider as cache sources
--cgroup-parent string Optional parent cgroup for the container
--compress Compress the build context using gzip
--cpu-period int Limit the CPU CFS (Completely Fair Scheduler) period
--cpu-quota int Limit the CPU CFS (Completely Fair Scheduler) quota
-c, --cpu-shares int CPU shares (relative weight)
--cpuset-cpus string CPUs in which to allow execution (0-3, 0,1)
--cpuset-mems string MEMs in which to allow execution (0-3, 0,1)
--disable-content-trust Skip image verification (default true)
-f, --file string Name of the Dockerfile (Default is 'PATH/Dockerfile')
--force-rm Always remove intermediate containers
--iidfile string Write the image ID to the file
--isolation string Container isolation technology
--label list Set metadata for an image
-m, --memory bytes Memory limit
--memory-swap bytes Swap limit equal to memory plus swap: '-1' to enable
unlimited swap
--network string Set the networking mode for the RUN instructions
during build (default "default")
--no-cache Do not use cache when building the image
--pull Always attempt to pull a newer version of the image
-q, --quiet Suppress the build output and print image ID on success
--rm Remove intermediate containers after a successful
build (default true)
--security-opt strings Security options
--shm-size bytes Size of /dev/shm
-t, --tag list Name and optionally a tag in the 'name:tag' format
--target string Set the target build stage to build.
--ulimit ulimit Ulimit options (default [])
dockerfile 例子1:拷贝一个文件。
FROM busybox:latest
MAINTAINER "magedu <mage@magedu.com>"
LABEL maintainer="magedu <mage@magedu.com>"
COPY index.html /data/html/
build一下上面的dockerfile 试试,使用-t
,来指定image的名字和tag,发现build成功了。
# docker build -t tinyhttpd:v0.01 ./
Sending build context to Docker daemon 3.072kB
Step 1/4 : FROM busybox:latest
---> b534869c81f0
Step 2/4 : MAINTAINER "magedu <mage@magedu.com>"
---> Using cache
---> 5c5a1c47716c
Step 3/4 : LABEL maintainer="magedu <mage@magedu.com>"
---> Using cache
---> 88b87ddfdb22
Step 4/4 : COPY index.html /data/html/
---> Using cache
---> 59b7dd6c3eb8
Successfully built 59b7dd6c3eb8
Successfully tagged tinyhttpd:v0.01
启动这个image,看看里面有没有/data/html/index.html
# sudo docker run --name b1 --rm tinyhttpd:v0.01 cat /data/html/index.html
<h1>http server</h1>
dockerfile 例子2:拷贝一个目录。
FROM busybox:latest
MAINTAINER "magedu <mage@magedu.com>"
LABEL maintainer="magedu <mage@magedu.com>"
COPY index.html /data/html/
COPY yum.repos.d /etc/yum.repos.d/
执行build:
docker build -t tinyhttpd:v0.02 ./
Sending build context to Docker daemon 30.21kB
Step 1/5 : FROM busybox:latest
---> b534869c81f0
Step 2/5 : MAINTAINER "magedu <mage@magedu.com>"
---> Using cache
---> 5c5a1c47716c
Step 3/5 : LABEL maintainer="magedu <mage@magedu.com>"
---> Using cache
---> 88b87ddfdb22
Step 4/5 : COPY index.html /data/html/
---> Using cache
---> 59b7dd6c3eb8
Step 5/5 : COPY yum.repos.d /etc/yum.repos.d/
---> 99d306a25cc7
Successfully built 99d306a25cc7
Successfully tagged tinyhttpd:v0.02
验证:
docker run --name b1 -it --rm tinyhttpd:v0.02 ls /etc/yum.repos.d/
CentOS-Base.repo CentOS-Sources.repo
CentOS-Base.repo_20191129 CentOS-Vault.repo
CentOS-CR.repo CentOS-fasttrack.repo
CentOS-Debuginfo.repo docker-ce.repo
CentOS-Media.repo
ADD命令:类似COPY,比COPY多了支持压缩类文件的自动解压和从URL下载
语法:
ADD准则:
tar -x
;然而通过URL下载的压缩文件不会自动展开。例子1:使用URL
FROM busybox:latest
MAINTAINER "magedu <mage@magedu.com>"
LABEL maintainer="magedu <mage@magedu.com>"
COPY index.html /data/html/
COPY yum.repos.d /etc/yum.repos.d/
ADD http://nginx.org/download/nginx-1.2.9.tar.gz /usr/local/src
确认结果:
# docker run --name b1 --rm tinyhttpd:v0.03 ls /usr/local/src/
nginx-1.2.9.tar.gz
例子2:使用本地压缩文件
FROM busybox:latest
MAINTAINER "magedu <mage@magedu.com>"
LABEL maintainer="magedu <mage@magedu.com>"
COPY index.html /data/html/
COPY yum.repos.d /etc/yum.repos.d/
#ADD http://nginx.org/download/nginx-1.2.9.tar.gz /usr/local/src/
ADD nginx-1.2.9.tar.gz /usr/local/src/
确认结果:
# docker run --name b1 --rm tinyhttpd:v0.03 ls /usr/local/src/nginx-1.2.9
CHANGES
CHANGES.ru
LICENSE
README
auto
conf
configure
contrib
html
man
src
WORKDIR命令:用于dockerfile中所有RUN,CMD,ENTRYPOINT,COPY和ADD指定设定的工作目录。
WORKDIR可以出现多次,这些命名去上面去找离它最近的WORKDIR作为相对路径的起始。
语法:
例子:
FROM busybox:latest
MAINTAINER "magedu <mage@magedu.com>"
LABEL maintainer="magedu <mage@magedu.com>"
COPY index.html /data/html/
COPY yum.repos.d /etc/yum.repos.d/
#ADD http://nginx.org/download/nginx-1.2.9.tar.gz /usr/local/src/
WORKDIR /usr/local/
ADD nginx-1.2.9.tar.gz ./src1/
确认结果:
sudo docker run --name b1 --rm tinyhttpd:v0.03 ls /usr/local/src1/nginx-1.2.9
[sudo] password for ys:
CHANGES
CHANGES.ru
LICENSE
README
auto
conf
configure
contrib
html
man
src
VOLUME:和run -v类似,但只能指定image里的某个目录,而不能指定宿主机的目录。
语法:
注意:如果image挂载点目录下有文件,则启动容器后,会把挂载点下的文件拷贝到宿主机。
例子:
FROM busybox:latest
MAINTAINER "magedu <mage@magedu.com>"
LABEL maintainer="magedu <mage@magedu.com>"
COPY index.html /data/html/
COPY yum.repos.d /etc/yum.repos.d/
#ADD http://nginx.org/download/nginx-1.2.9.tar.gz /usr/local/src/
WORKDIR /usr/local/
ADD nginx-1.2.9.tar.gz ./src/
VOLUME /usr/local/src
确认结果:由于image的/usr/local/src目录下有nginx-1.2.9,所以nginx-1.2.9会被拷贝到宿主机。
# docker run --name b1 -it --rm tinyhttpd:v0.03
# ls /var/lib/docker/volumes/1240925e87efaa5d9ed375b268a6d804c29013c04792f9a0dde9e135aa7e9f9e/_data/
nginx-1.2.9
EXPOSE:和-p选项类型,指定容器要暴漏给外部的端口,但不能指定宿主机的端口,因为在作dockerfile的时候,无法确定此image运行在什么宿主机上。也就无法知道宿主机上哪些端口可以使用。所以是随机去找宿主机里可以使用的端口。
注意:即使使用了EXPOSE命令,但如果RUN时不加-P
选项的话,端口也不会被暴露出去的。
语法:EXPOSE <port>[/protocol] <port>[/protocol]
例子:
FROM busybox:latest
MAINTAINER "magedu <mage@magedu.com>"
LABEL maintainer="magedu <mage@magedu.com>"
COPY index.html /data/html/
COPY yum.repos.d /etc/yum.repos.d/
#ADD http://nginx.org/download/nginx-1.2.9.tar.gz /usr/local/src/
WORKDIR /usr/local/
ADD nginx-1.2.9.tar.gz ./src/
VOLUME /usr/local/src
EXPOSE 80
确认结果:
启动时先不指定-P
,用docker port查看,发现没有端口。
# docker run --name b1 --rm tinyhttpd:v0.03 /bin/httpd -f -h /data/html/
# docker port b1
启动时先指定-P
,用docker port查看,发现有端口。
# docker run --name b1 --rm -P tinyhttpd:v0.03 /bin/httpd -f -h /data/html/
# docker port b1
80/tcp -> 0.0.0.0:32768
EXPOSE的作用是:默认想暴露的端口,在启动的时候,可以使用-p
去覆盖EXPOSE指定的端口。
ENV:在容器的系统了定义环境变量,ENV,ADD,COPY等指令可以使用。
语法:
例子:${DOC_ROOT:-/data/html/}的用法是,if(DOC_ROOT 没有值) {DOC_ROOT=/data/html/}
FROM busybox:latest
MAINTAINER "magedu <mage@magedu.com>"
LABEL maintainer="magedu <mage@magedu.com>"
ENV DOC_ROOT=/data/html/ WEB_SERVER_PACKAGE="/nginx-1.2.9"
COPY index.html ${DOC_ROOT:-/data/html/}
COPY yum.repos.d /etc/yum.repos.d/
#ADD http://nginx.org/download/nginx-1.2.9.tar.gz /usr/local/src/
WORKDIR /usr/local/
ADD ${WEB_SERVER_PACKAGE}.tar.gz ./src/
VOLUME /usr/local/src
EXPOSE 80
延申,在docker run的时候也可以使用-e
选项设置环境变量。
在run的时候,通过-e,可以改变dockerfile里指定环境变量的值。
dockerfile里定义的是nginx-1.2.9,但是-e指定的nginx-1.2.3,所以WEB_SERVER_PACKAGE=/nginx-1.2.3。
# docker run --name b1 --rm -e WEB_SERVER_PACKAGE=/nginx-1.2.3 tinyhttpd:v0.03 printenv
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
HOSTNAME=7a242517b02e
WEB_SERVER_PACKAGE=/nginx-1.2.3
但是,/usr/local/src里的目录还是nginx-1.2.9。因为在build的时点,image里放的就已经是nginx-1.2.9了,所以你在-e里,改变的只是环境变量的值而已。
# docker run --name b1 --rm -e WEB_SERVER_PACKAGE=/nginx-1.2.3 tinyhttpd:v0.03 ls /usr/local/src
nginx-1.2.9
RUN:在build执行过程中,执行基础镜像里可以执行的任何shell命令。如果是多个命令是有关联的话,最好写到一起。
语法:
例子:我们指定ADD里的src如果是压缩文件的话,不会自动解压缩,所以我们RUN一个tar命令去解压缩它。
FROM busybox:latest
MAINTAINER "magedu <mage@magedu.com>"
LABEL maintainer="magedu <mage@magedu.com>"
ENV DOC_ROOT=/data/html/ WEB_SERVER_PACKAGE="nginx-1.2.9"
COPY index.html ${DOC_ROOT:-/data/html/}
COPY yum.repos.d /etc/yum.repos.d/
ADD http://nginx.org/download/${WEB_SERVER_PACKAGE}.tar.gz /usr/local/src/
RUN cd /usr/local/src && tar xf ${WEB_SERVER_PACKAGE}.tar.gz
RUN用途举例:先找个基础的centos镜像,然后装一个nginx,一般都是下载源代码编译安装,不是使用yum install。理由是yum会产生多余的文件。
FROM centos
RUN yum -y install epel-release && yum makecache && yum install nginx
CMD:在docker build时不被运行,而是在docker run时运行。比如nginx镜像启动的时候,那么CMD肯定是启动nginx的命令。所以CMD即使给了多个,只有最后一个生效。
语法:
CMD <command>
command通常是shell命令,而且是以/bin/sh -c来运行此命令,因此,是通过shell启动的,所以可以使用shell的特性,而且启动结束后,shell进程会自动推出,让此进程代替shell进程。所以它pid是1。
CMD ["executable1","arg1","executable2","arg1"]
executable是目录名加上可执行程序名,比如/bin/ls。它不是通过/bin/sh -c来运行,是由内核直接启动,由于不是由shell启动,所以shell里的通配符,管道,重定向等特性,全部不能用。如果想用shell特性,可以这么使用:CMD ["/bin/bash","-c","executable","arg"].
RUN的第一种和第二种用法和CMD的第一种和第二种用法一样。
CMD ["arg1","arg2"]
配合ENTRYPOINT命令使用。
例子:
FROM busybox
LABEL maintainer="mageedu <mage@magedu.com>" app="httpd"
ENV WEB_ROOT="/data/web/html/"
RUN mkdir -p ${WEB_ROOT} && echo '<h1>Busybox httpd.</h1>' > ${WEB_ROOT}/index.html
CMD /bin/httpd -f -h ${WEB_ROOT}
确认结果:用inspect确认,确实是用/bin/sh -c来启动的。
"Cmd": [
"/bin/sh",
"-c",
"/bin/httpd -f -h ${WEB_ROOT}"
],
pid也是1
docker exec -it b1 /bin/sh
/ # ps
PID USER TIME COMMAND
1 root 0:00 /bin/httpd -f -h /data/web/html/
6 root 0:00 /bin/sh
11 root 0:00 ps
# printenv
HOSTNAME=e877c51f7dab
WEB_ROOT=/data/web/html/
ENTRYPOINT:
类似CMD指令,用于为容器指定默认运行程序。
与CMD不同的是,不会被docker run指定的参数覆盖(也有覆盖的办法),而且docker run指定的参数,会自动加到ENTRYPOINT命令的后面,相当于ENTRYPOINT命令的参数了。
run时使用--entrypoint string选项,可以强制替换ENTRYPOINT命令。
如果docker run时没有指定参数,则使用上面CMD的第三种格式定义的参数,作为ENTRYPOINT的参数。
如果docker run时指定了参数,CMD的第三种格式也指定了参数,ENTRYPOINT使用的是docker run时指定的参数,忽略CMD的第三种格式指定的参数。
dockerfile文件种也可以出现多个ENTRYPOINT,但只有最后一个生效。
语法:
例子:在build时创建nginx的配置文件,而且在run的时候,还可以通过-e参数传递环境变量,修改监听的端口号等信息。
FROM nginx:alpine
LABEL maintainer="MageEdu <mage@magedu.com>"
ENV NGX_DOC_ROOT="/data/web/html/"
ADD entrypoint.sh /bin/
ADD index.html ${NGX_DOC_ROOT}
CMD ["/usr/sbin/nginx", "-g", "daemon off;"]
ENTRYPOINT ["/bin/entrypoint.sh"]
ENTRYPOINT命令执行的是一个自己定义的shell命令文件,内容如下。
首先用cat命令创建了一个nginx的配置文件,还使用了环境变量。
然后,调用exec系统函数,参数是CMD定义的命令:["/usr/sbin/nginx", "-g", "daemon off;"]。exec函数的作用是:启动ngxin进程,并终止当前进程(/bin/sh进程),让nginx进程取代当前的shell进程,所以nginx进程的pid是1。
"$@":shell的全部参数,也就是/usr/sbin/nginx", "-g", "daemon off;
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 "$@"
当run的时候,执行ENTRYPOINT命令,参数是CMD里定义的。
确认结果:通过-e把监听端口设置成了8080;nginx的pid是1;www.conf也被创建了。在宿主机器上执行【curl -H "Host: a6b94dae9be4" 192.0.0.2:8080】,也输出了index.html的结果。
# docker run --name b1 --rm -d -e "PORT=8080" mynignx:002
# docker exec -it b1 /bin/sh
/ # netstat -tnl
Active Internet connections (only servers)
Proto Recv-Q Send-Q Local Address Foreign Address State
tcp 0 0 0.0.0.0:8080 0.0.0.0:* LISTEN
tcp 0 0 0.0.0.0:80 0.0.0.0:* LISTEN
# cat /etc/nginx/conf.d/www.conf
server {
server_name a6b94dae9be4;
listen 0.0.0.0:8080;
root /data/web/html/;
}
/ # ps
PID USER TIME COMMAND
1 root 0:00 nginx: master process /usr/sbin/nginx -g daemon off;
8 nginx 0:00 nginx: worker process
# cat /data/web/html/index.html
<h1>nginx hello</h1>
$ curl -H "Host: a6b94dae9be4" 192.0.0.2:8080
<h1>nginx hello</h1>
试验一下,在run时,指定参数:/usr/sbin/nginx daemon off(故意不加-g),去覆盖CMD。因为缺少了-g,所以容器启动失败,说明了,确实覆盖CMD里定义的命令。
# docker run --name b1 --rm -d -e "PORT=8080" mynignx:002 /usr/sbin/nginx daemon off
4c88e021408c143ec45e70611c42bd715831cb9c75d6f4a00d307a7a6b53af5c
[root@localhost ~]# docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
试验一下,使用--entrypoint "/bin/sh",覆盖ENTRYPOINT。
覆盖成功了,1号进程是/bin/sh进程;www.conf文件没有被创建;nginx进程没有被启动。
# docker run --name b1 --rm -it -e "PORT=8080" --entrypoint "/bin/sh" mynignx:002
/ # ls
bin dev home media opt root sbin sys usr
data etc lib mnt proc run srv tmp var
/ # ps
PID USER TIME COMMAND
1 root 0:00 /bin/sh
7 root 0:00 ps
/ # ls /etc/nginx/conf.d/
default.conf
ENTRYPOINT用法的最佳实践:build之前事先创建好配置文件,build时,注入到image了。就能达到动态创建各种服务的配置文件,从而解决了只是因为配置文件的不同,而不得不创建多个image的问题。
USER
使用USER的背景,不指定USER的时候,进程的所有者都是root,比如下面的nginx。当不希望是root的时候,使用此命令。
/ # ps
PID USER TIME COMMAND
1 root 0:00 nginx: master process nginx -g daemon off;
docker run,CMD,ENTRYPOINT执行的时候,所使用的用户名或者UID
默认情况下是root
语法:USER <UID> | <UserName>
UID或者UserName必须是在image里存在的,必须存在于/etc/passwd中。
HEALTHCHECK:
定期查看容器里运行的进程是否还在工作状态。docker自己会自动检查容器里的进程是否还活着,如果死了或者不在前台运行的时候,docker会自动杀死这个容器。但这是不够的,有的容器即使活着,但不能提供服务了,那也相当于死了,所以要自己定义一个命令去检查容器里运行的进程,是否还在工作。
语法:
例子:健康检查结果是正常的。
FROM nginx:alpine
LABEL maintainer="MageEdu <mage@magedu.com>"
ENV NGX_DOC_ROOT="/data/web/html/"
ADD entrypoint.sh /bin/
ADD index.html ${NGX_DOC_ROOT}
HEALTHCHECK --interval=3s --timeout=3s CMD wget -O - -q http://${IP:-0.0.0.0}:${PORT:-80}/
CMD ["/usr/sbin/nginx", "-g", "daemon off;"]
ENTRYPOINT ["/bin/entrypoint.sh"]
结果确认:
# docker run --name b1 --rm mynginx:v001
127.0.0.1 - - [08/Dec/2019:13:54:18 +0000] "GET / HTTP/1.1" 200 612 "-" "Wget" "-"
127.0.0.1 - - [08/Dec/2019:13:54:21 +0000] "GET / HTTP/1.1" 200 612 "-" "Wget" "-"
127.0.0.1 - - [08/Dec/2019:13:54:25 +0000] "GET / HTTP/1.1" 200 612 "-" "Wget" "-"
例子:健康检查结果是不正常的。发现不正常后,直接【kill 1】。容器启动后,马上就被杀死了。
FROM nginx:alpine
LABEL maintainer="MageEdu <mage@magedu.com>"
ENV NGX_DOC_ROOT="/data/web/html/"
ADD entrypoint.sh /bin/
ADD index.html ${NGX_DOC_ROOT}
HEALTHCHECK --interval=1s --timeout=1s --retries=1 CMD wget -O - -q http://${IP:-0.0.0.0}:10080/ || kill 1
CMD ["/usr/sbin/nginx", "-g", "daemon off;"]
ENTRYPOINT ["/bin/entrypoint.sh"]
SHELL:指定用哪个shell去运行RUN,CMD,ENTRYPOINT的命令,默认是/bin/sh -c。
STOPSIGNAL:【docker stop 容器名】默认是个PID为1的进程发送15号信号。STOPSIGNAL可以指定别的信号。
ARG:
在build时,通过【--build-arg】传入到dockerfile里面的变量
dockerfile里可以有多个ARG
语法: ARG <name>[=<default value>]
可以在dockerfile里定有ARG的默认值
ARG version=1.14
例子:
FROM nginx:alpine
ARG author="MageEdu <mage@magedu.com>"
LABEL maintainer=${author}
确认结果:build时,没有使用--build-arg
# docker build -t mynginx:v002 ./
# docker image inspect mynginx:v002
"Labels": {
"maintainer": "MageEdu <mage@magedu.com>"
},
确认结果:build时,使用--build-arg
# docker build --build-arg author="abc <asd@sd.com>" -t mynginx:v002 ./
# docker image inspect mynginx:v002
"Labels": {
"maintainer": "abc <asd@sd.com>"
},
ONBUILD
标签:quota mapping echo entry 配置文件 cgroup des 也有 exec
原文地址:https://www.cnblogs.com/xiaoshiwang/p/12008545.html