dockerfile使用详解

唐僧骑白马

已于 2023-02-02 23:52:30 修改

阅读量3.8k

点赞数 1

分类专栏： docker 文章标签： docker 运维 linux

于 2023-02-02 16:15:55 首次发布

本文链接：https://blog.csdn.net/weixin_43883625/article/details/128845219

版权

docker 专栏收录该内容

5 篇文章 0 订阅

订阅专栏

1、dockerfile语法详解

Dockerfile 是一个用来构建镜像的文本文件，文本内容包含了一条条构建镜像所需的指令和说明。

基于Dockerfile构建镜像可以使用docker build命令。docker build命令中使用-f可以指定具体的dockerfile文件
示例：

FROM centos
MAINTAINER xianchao
RUN rm -rf /etc/yum.repos.d/*
COPY Centos-vault-8.5.2111.repo /etc/yum.repos.d/
RUN yum install wget -y
RUN yum install nginx -y
COPY index.html /usr/share/nginx/html/
EXPOSE 80
ENTRYPOINT ["/usr/sbin/nginx","-g","daemon off;"]

#创建index.html
vim index.html
<html>
<head>
        <title>page added to dockerfile</title>
</head>
<body>
        <h1>dockerfile test </h1>
</body>
</html>

dockerfile构建过程：
从基础镜像运行一个容器
执行一条指令，对容器做出修改
执行类似docker commit 的操作，提交一个新的镜像层
再基于刚提交的镜像运行一个新的容器
执行dockerfile中的下一条指令，直至所有指令执行完毕

1.FROM

基础镜像，必须是可以下载下来的，定制的镜像都是基于 FROM 的镜像，这里的 centos就是定制需要的基础镜像。后续的操作都是基于centos镜像。

2.MAINTAINER

指定镜像的作者信息

3.RUN：指定在当前镜像构建过程中要运行的命令

包含两种模式
（1）Shell

RUN (shell模式，这个是最常用的，需要记住)
RUN echo hello

（2）exec模式

RUN “executable”，“param1”，“param2”
RUN [“/bin/bash”,”-c”,”echo hello”]
等价于/bin/bash -c echo hello

4.EXPOSE指令

仅仅只是声明端口。
作用：
1、帮助镜像使用者理解这个镜像服务的守护端口，以方便配置映射。
2、在运行时使用随机端口映射时，也就是 docker run -P 时，会自动随机映射 EXPOSE 的端口。

3、可以是一个或者多个端口，也可以指定多个EXPOSE

格式：EXPOSE <端口1> [<端口2>…]

5.CMD
类似于 RUN 指令，用于运行程序，但二者运行的时间点不同:
1、CMD 在docker run 时运行。
2、RUN 是在 docker build构建镜像时运行的

作用：为启动的容器指定默认要运行的程序，程序运行结束，容器也就结束。CMD 指令指定的程序可被 docker run 命令行参数中指定要运行的程序所覆盖。

CMD[“executable”，“param1”，“param2”]（exec模式）
CMD command （shell模式）
CMD [“param1”,”param2”](作为ENTRYPOINT指令的默认参数)

例：

[root@node1 dockerfile]# cd /root/dockerfile/
[root@node1 dockerfile]# cat Dockerfile
FROM centos:8
MAINTAINER test
RUN cd /etc/yum.repos.d/ && sed -i 's/mirrorlist/#mirrorlist/g' /etc/yum.repos.d/CentOS-* && sed -i 's|#baseurl=http://mirror.centos.org|baseurl=http://vault.centos.org|g' /etc/yum.repos.d/CentOS-*
RUN yum makecache
RUN yum clean all
RUN yum install nginx -y
EXPOSE 80
CMD ["/ust/sbin/nginx","-g","daemon off;"]
 # 构建镜像
 [root@node1 dockerfile]# docker build -t test-cmd:v1 .
 
基于上面构建的镜像运行一个容器
docker run -p 80 --name cmd_test2 -d test-cmd
（不需要跟nginx  -g “daemon off；”了）

# docker ps可以看到下面信息
[root@node1 dockerfile]# docker ps
CONTAINER ID        IMAGE                                               COMMAND                  CREATED             STATUS              PORTS                   NAMES
3f0cb9b2068d        test-cmd:v1                                         "/usr/sbin/nginx -g …"   2 seconds ago       Up 2 seconds        0.0.0.0:32769->80/tcp   test-cmd1

6.ENTERYPOINT

类似于 CMD 指令，但其不会被 docker run 的命令行参数指定的指令所覆盖，而且这些命令行参数会被当作参数送给 ENTRYPOINT 指令指定的程序。

但是, 如果运行 docker run 时使用了 --entrypoint 选项，将覆盖 entrypoint指令指定的程序。
优点：在执行 docker run 的时候可以指定 ENTRYPOINT 运行所需的参数。
注意：如果 Dockerfile 中如果存在多个 ENTRYPOINT 指令，仅最后一个生效。
格式：

ENTERYPOINT [“executable”,“param1”,“param2”](exec模式)
ENTERYPOINT command （shell模式）

可以搭配 CMD 命令使用：一般是变参才会使用 CMD ，这里的 CMD 等于是在给 ENTRYPOINT 传参，以下示例会提到。
示例：
假设已通过 Dockerfile 构建了 nginx:test 镜像：

FROM nginx
ENTRYPOINT ["nginx", "-c"] # 定参
CMD ["/etc/nginx/nginx.conf"] # 变参

1、不传参运行
docker run  nginx:test
容器内会默认运行以下命令，启动主进程。
nginx -c /etc/nginx/nginx.conf

2、传参运行
docker run  nginx:test -c /etc/nginx/new.conf
容器内会默认运行以下命令，启动主进程(/etc/nginx/new.conf:假设容器内已有此文件)
nginx -c /etc/nginx/new.conf

7.COPY

COPY<src>..<dest>
COPY[“<src>”...“<dest>”]

复制指令，从上下文目录中复制文件或者目录到容器里指定路径。

格式：
COPY [--chown=<user>:<group>] <源路径1>...  <目标路径>
COPY [--chown=<user>:<group>] ["<源路径1>",...  "<目标路径>"]

[--chown=<user>:<group>]：可选参数，用户改变复制到容器内文件的拥有者和属组。

<源路径>：源文件或者源目录，这里可以是通配符表达式，其通配符规则要满足 Go 的 filepath.Match 规则。例如：

例如：

COPY hom* /mydir/
COPY hom?.txt /mydir/

<目标路径>：容器内的指定路径，该路径不用事先建好，路径不存在的话，会自动创建。

8.ADD

ADD <src>...<dest>
ADD [“<src>”...“<dest>”]

ADD 指令和 COPY 的使用格式一致（同样需求下，官方推荐使用 COPY）。功能也类似，不同之处如下：

ADD 的优点：在执行 <源文件> 为 tar 压缩文件的话，压缩格式为 gzip, bzip2 以及 xz 的情况下，会自动复制并解压到 <目标路径>。
ADD 的缺点：在不解压的前提下，无法复制 tar 压缩文件。会令镜像构建缓存失效，从而可能会令镜像构建变得比较缓慢。具体是否使用，可以根据是否需要自动解压来决定。

ADD vs COPY
ADD包含类似tar的解压功能
如果单纯复制文件，dockerfile推荐使用COPY

例;替换/usr/share/nginx下的index.html

[root@node1 dockerfile]# cat Dockerfile1
FROM centos
MAINTAINER test
RUN cd /etc/yum.repos.d/ && sed -i 's/mirrorlist/#mirrorlist/g' /etc/yum.repos.d/CentOS-* && sed -i 's|#baseurl=http://mirror.centos.org|baseurl=http://vault.centos.org|g' /etc/yum.repos.d/CentOS-*
RUN yum install wget -y
RUN yum install nginx -y
COPY index.html /usr/share/nginx/html/
EXPOSE 80
ENTRYPOINT ["/usr/sbin/nginx","-g","daemon off;"]

vim index.html
<html>
<head>
        <title>page added to dockerfile</title>
</head>
<body>
        <h1>i am in df_test </h1>
</body>
</html>

[root@node1 dockerfile]# docker build -f Dockerfile1 -t="test/copy:v1" .
[root@node1 dockerfile]# docker run -d -p 80 --name test-copy test/copy:v1

[root@node1 dockerfile]# curl 192.168.75.141:32770
# 显示的就是替换后的页面
<html>
<head>
        <title>page added to dockerfile</title>
</head>
<body>
        <h1>i am in df_test </h1>
</body>
</html>

9.VOLUME
定义匿名数据卷。在启动容器时忘记挂载数据卷，会自动挂载到匿名卷。
作用：
1、避免重要的数据，因容器重启而丢失，这是非常致命的。
2、避免容器不断变大。
格式：
VOLUME [“<路径1>”, “<路径2>”…]
VOLUME <路径>
在启动容器 docker run 的时候，我们可以通过 -v 参数修改挂载点。

VOLUME [“/data”]

10.WORKDIR
指定工作目录。用 WORKDIR 指定的工作目录，会在构建镜像的每一层中都存在。（WORKDIR 指定的工作目录，必须是提前创建好的）。
docker build 构建镜像过程中的，每一个 RUN 命令都是新建的一层。只有通过 WORKDIR 创建的目录才会一直存在。
格式：
WORKDIR <工作目录路径>

WORKDIR /path/to/workdir
（填写绝对路径）

11. ENV
设置环境变量
ENV
ENV =…

以下示例设置 NODE_VERSION =6.6.6，在后续的指令中可以通过 $NODE_VERSION 引用：
ENV NODE_VERSION 6.6.6

RUN curl -SLO “https://nodejs.org/dist/v $NODE_VERSION/node-v$ NODE_VERSION-linux-x64.tar.xz”
&& curl -SLO “https://nodejs.org/dist/v$NODE_VERSION/SHASUMS256.txt.asc”

12.USER
用于指定执行后续命令的用户和用户组，这边只是切换后续命令执行的用户（用户和用户组必须提前已经存在）。
格式：

USER <用户名>[:<用户组>]
USER daemon
USER nginx
USER user       
USER uid
USER user:group 
USER uid:gid
USER user:gid    
USER uid:group

13.ONBUILD
用于延迟构建命令的执行。简单的说，就是 Dockerfile 里用 ONBUILD 指定的命令，在本次构建镜像的过程中不会执行（假设镜像为 test-build）。当有新的 Dockerfile 使用了之前构建的镜像 FROM test-build ，这时执行新镜像的 Dockerfile 构建时候，会执行 test-build 的 Dockerfile 里的 ONBUILD 指定的命令。
格式：
ONBUILD <其它指令>

为镜像添加触发器
当一个镜像被其他镜像作为基础镜像时需要写上OBNBUILD
会在构建时插入触发器指令
例：演示ONBUILD指令

cat index.html
<html>
<head>
        <title>page added to dockerfile</title>
</head>
<body>
        <h1>i am in df_test </h1>
</body>
</html>

FROM centos
MAINTAINER test
RUN cd /etc/yum.repos.d/ && sed -i 's/mirrorlist/#mirrorlist/g' /etc/yum.repos.d/CentOS-* && sed -i 's|#baseurl=http://mirror.centos.org|baseurl=http://vault.centos.org|g' /etc/yum.repos.d/CentOS-*
RUN yum install wget -y
RUN yum install nginx -y
ONBUILD COPY index.html /usr/share/nginx/html/
EXPOSE 80
ENTRYPOINT ["/usr/sbin/nginx","-g","daemon off;"]

[root@node1 dockerfile]# docker build -f Dockerfile2 -t="onbuild/test:v1" .
[root@node1 dockerfile]# docker run -p 80 -d --name onbuild-test onbuild/test:v1

[root@node1 dockerfile]# docker ps | grep onbuild
3e4c756cc606        onbuild/test:v1                                     "/usr/sbin/nginx -g …"   About a minute ago   Up About a minute   0.0.0.0:32771->80/tcp   onbuild-test

显示还是以前nginx默认的内容，没有被替换，表示ONBUILD这个指令后面的COPY没有生效
[root@node1 dockerfile]# curl 192.168.75.141:32771

还是在刚在路径下构建新的镜像
FROM onbuild/test:v1
MAINTAINER test
ENTRYPOINT ["/usr/sbin/nginx","-g","daemon off;"]
EXPOSE 80

[root@node1 dockerfile]# docker build -f Dockerfile3 -t="obuild-nginx" .
[root@node1 dockerfile]# docker run -p 80 -d --name onbuild-nginx1 obuild-nginx

curl显示的就是已经重新构建的镜像，页面就是替换之后的了，说明我们基于ONBUILD指令的镜像作为基础镜像，在构建镜像，会触发ONBUILD后面的COPY命令运行

14.LABEL
LABEL 指令用来给镜像添加一些元数据（metadata），以键值对的形式，语法格式如下：
LABEL = = = …
比如我们可以添加镜像的作者：
LABEL org.opencontainers.image.authors=“admin”

15.HEALTHCHECK
用于指定某个程序或者指令来监控 docker 容器服务的运行状态。
格式：
HEALTHCHECK [选项] CMD <命令>：设置检查容器健康状况的命令
HEALTHCHECK NONE：如果基础镜像有健康检查指令，使用这行可以屏蔽掉其健康检查指令

HEALTHCHECK [选项] CMD <命令> : 这边 CMD 后面跟随的命令使用，可以参考 CMD 的用法。

16.ARG
构建参数，与 ENV 作用一至。不过作用域不一样。ARG 设置的环境变量仅对 Dockerfile 内有效，也就是说只有 docker build 的过程中有效，构建好的镜像内不存在此环境变量。

构建命令 docker build 中可以用 --build-arg <参数名>=<值> 来覆盖。
格式：

ARG <参数名>[=<默认值>]

2、dockerfile构建nginx镜像

mkdir /root/dockerfile/test
cd /root/dockerfile/test
把Centos-vault-8.5.2111.repo传到这个目录下
vim dockerfile

[root@node1 test]# cat Dockerfile
FROM centos
MAINTAINER test
RUN rm -rf /etc/yum.repos.d/*
COPY Centos-vault-8.5.2111.repo /etc/yum.repos.d/
RUN yum -y install wget
RUN yum -y install nginx
COPY index.html /usr/share/nginx/html
EXPOSE 80
ENTRYPOINT ["/usr/sbin/nginx","-g","daemon off;"]

vim index.html
<html>
<head>
        <title>page added to dockerfile</title>
</head>
<body>
        <h1>Hello ,dockerfile </h1>
</body>
</html>

[root@node1 test]# docker build -t="test/nginx:v1" .
[root@node1 test]# docker run -p 80 -d --name html1 test/nginx:v1

[root@node1 test]# docker ps | grep html
a0d9b598e773        test/nginx:v1                                       "/usr/sbin/nginx -g …"   About a minute ago   Up About a minute   0.0.0.0:32775->80/tcp   html1

查看容器里部署的nginx网站的内容:

[root@node1 test]# curl localhost:32775
<html>
<head>
        <title>page added to dockerfile</title>
</head>
<body>
        <h1>Hello ,dockerfile </h1>
</body>
</html>

3、dockerfile构建tomcat镜像

用到的文件
在这里插入图片描述

[root@node1 tomcat]# cat Dockerfile
FROM centos
MAINTAINER test
RUN rm -rf /etc/yum.repos.d/*
COPY Centos-vault-8.5.2111.repo /etc/yum.repos.d/
RUN yum -y install wget
ADD jdk-8u45-linux-x64.rpm /usr/local/
ADD apache-tomcat-8.0.26.tar.gz /usr/local/
RUN cd /usr/local && rpm -ivh jdk-8u45-linux-x64.rpm
RUN mv /usr/local/apache-tomcat-8.0.26 /usr/local/tomcat8
EXPOSE 8080

开始构建镜像
docker build -t="tomcat8:v1" .

运行一个容器
docker run --name tomcat8  -itd -p 8080 tomcat8:v1 

进入到容器
docker exec -it tomcat8  /bin/bash

启动tomcat
/usr/local/tomcat8/bin/startup.sh

查看进程，看看是否启动成功
ps -ef | grep tomcat

打开新的终端窗口，查看刚才创建的tomcat8这个容器的详细信息：
docker ps | grep tomcat

显示如下信息
4d4c91cff4b5        tomcat8:v1                                          "/bin/bash"              About a minute ago   Up About a minute   0.0.0.0:32776->8080/tcp   tomcat8

通过上面可以看到，tomcat在宿主机上映射的端口是32776
这样我们请求docker节点的ip:32776，就可以访问到tomcat的内容了
通过这些步骤可以实现通过dockerfile构建tomcat镜像了

刚才我们在构建tomcat镜像时候，基于镜像运行容器，但是需要进入到容器，手动启动tomcat服务，那如果想要启动容器，tomcat也自动起来，需要按照如下方法构建镜像：

[root@node1 tomcat]# cat Dockerfile
FROM centos
MAINTAINER test
RUN rm -rf /etc/yum.repos.d/*
COPY Centos-vault-8.5.2111.repo /etc/yum.repos.d/
RUN yum install wget -y
ADD jdk-8u45-linux-x64.rpm /usr/local/
ADD apache-tomcat-8.0.26.tar.gz /usr/local/
RUN cd /usr/local && rpm -ivh jdk-8u45-linux-x64.rpm
RUN mv /usr/local/apache-tomcat-8.0.26 /usr/local/tomcat8
ENTRYPOINT /usr/local/tomcat8/bin/startup.sh && tail -F /usr/local/tomcat8/logs/catalina.out
EXPOSE 8080

docker build -t="tomcat8:v3" .
docker run -itd -p 8080 --name tomcat-v3 tomcat8:v3
[root@node1 tomcat]# docker ps|grep tomcat
e1ae004aa5cb        tomcat8:v3                                          "/bin/sh -c '/usr/lo…"   About a minute ago   Up About a minute   0.0.0.0:32778->8080/tcp   tomcat-v3

备注：tomcat 的自动启动命令可以用 ENTRYPOINT [“/usr/local/tomcat8/bin/catalina.sh”, “run”]

4、把Go代码基于dockerfile做成镜像

1、linux机器安装go

yum install go -y

2、创建源码文件

mkdir /root/go-test
[root@node1 go-test]# cat main.go
package main

import (
        "net/http"

        "github.com/gin-gonic/gin"
)

func statusOKHandler(c *gin.Context) {
        c.JSON(http.StatusOK, gin.H{"status": "success~welcome to study"})
}

func versionHandler(c *gin.Context) {
        c.JSON(http.StatusOK, gin.H{"version": "v1.1版本"})
}

func main() {
        router := gin.New()
        router.Use(gin.Recovery())
        router.GET("/", statusOKHandler)
        router.GET("/version", versionHandler)
        router.Run(":8080")
}

3、Go mod初始化项目

[root@node1 go-test]# go mod init go-test

#设置代理
[root@node1 go-test]# go env -w GOPROXY=https://goproxy.cn,direct
[root@node1 go-test]# go mod tidy
#构建源码
[root@node1 go-test]# CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o k8s-demo main.go

4、编写dockerfile文件

[root@node1 go-test]# cat Dockerfile
FROM alpine
WORKDIR /data/app
ADD k8s-demo /data/app
CMD ["/bin/sh","-c","./k8s-demo"]

5、构建镜像

[root@node1 go-test]# docker build -t="go/k8sdemo:v1" .

6、运行镜像

[root@node1 go-test]# docker run -d --name go-test -p 30180:8080 go/k8sdemo:v1

7、访问go容器
可以在根物理机同网段的其他机器或者浏览器访问机器的ip:30180，就可以把请求代理到go容器了

5、把python代码基于dockerfile做成镜像

1、获取应用程序代码

把hello-python.tar.gz压缩包上传到k8s控制节点xianchaomaster1的root下，手动解压
[root@node1 go-test]# tar zxvf hello-python.tar.gz
[root@node1 go-test]# cd /root/hello-python/app
备注：requirements.txt文件包含main.py所需的包列表，pip将使用它来安装Flask库

2、创建dockerfile

[root@node1 app]# cat dockerfile
FROM python:3.7
RUN mkdir /app
WORKDIR /app
ADD . /app/
RUN /usr/local/bin/python -m pip install --upgrade pip
RUN pip install -r requirements.txt
EXPOSE 5000
CMD ["python","/app/main.py"]

备注：这个文件是Docker用来构建镜像的一组指令。对于这个简单的应用程序，Docker将：
（1）从Docker Hub获取3.7版本的官方Python基本镜像。
（2）在镜像中，创建一个名为app的目录。
（3）将工作目录设置为新的app目录。
（4）将本地目录的内容复制到该新文件夹，并将其复制到镜像中。
（5）运行pip安装程序（就像我们前面做的那样），将需求拉入镜像中。
（6）通知Docker容器监听端口5000。
（7）配置启动命令，使其在容器启动时使用。

3、构建镜像

[root@node1 app]# docker build -t hello-python:v1 .

4、基于镜像运行python代码

docker run -d --name python -p 30050:5000  hello-python:v1

5、访问python容器
可以在根物理机同网段的其他机器或者浏览器访问机器的ip:30050，就可以把请求代理到python容器了

唐僧骑白马

关注

1
点赞
踩
13

收藏

觉得还不错? 一键收藏
3
评论
dockerfile使用详解

用于延迟构建命令的执行。简单的说，就是 Dockerfile 里用 ONBUILD 指定的命令，在本次构建镜像的过程中不会执行（假设镜像为 test-build）。当有新的 Dockerfile 使用了之前构建的镜像 FROM test-build ，这时执行新镜像的 Dockerfile 构建时候，会执行 test-build 的 Dockerfile 里的 ONBUILD 指定的命令。基础镜像，必须是可以下载下来的，定制的镜像都是基于 FROM 的镜像，这里的 centos就是定制需要的基础镜像。
复制链接

扫一扫