腳本之家服務器常用軟件

快捷導航

Dockerfile文件編寫實戰(zhàn)練習及注意事項

更新時間：2025年04月26日 11:28:29 作者：瀾堇

Dockerfile?是一個用于構建?Docker?鏡像的文本文件,通過一系列指令來定義鏡像的構建過程,這篇文章主要介紹了Dockerfile文件編寫實戰(zhàn)練習及注意事項的相關資料,文中通過代碼介紹的非常詳細,需要的朋友可以參考下

1.什么是Dockerfile

Dockerfile 是一個文本文件，其內包含了一條條的指令(Instruction)，用于構建鏡像。每一條指令構建一層鏡像，因此每一條指令的內容，就是描述該層鏡像應當如何構建。dockerfile的原理就是鏡像分層。

Dockerfile 用于指示 docker image build 命令自動構建Image的源代碼是純文本文件。

2. Dockerfile作用

標準化構建流程：它確保每次構建鏡像的過程都是相同的，這有助于復現(xiàn)性和可維護性。
自動化構建：自動化處理從基礎鏡像到最終鏡像的整個構建過程。
可重復性：可以多次使用同一個 Dockerfile 構建鏡像，每次都得到相同的結果。
環(huán)境配置：可以在 Dockerfile 中配置運行應用所需的所有依賴項和環(huán)境變量。

3.dockerfile 的基本結構：

基礎映像（Base Image）：使用 FROM 指令指定基礎映像，作為構建鏡像的起點?；A映像通常包含了操作系統(tǒng)和一些預裝的軟件和工具。
構建過程指令：使用一系列指令來描述構建過程，例如 RUN 用于執(zhí)行命令和安裝軟件包，COPY 用于拷貝文件和目錄，ADD 用于拷貝和提取文件，WORKDIR 用于設置工作目錄，等等。
容器啟動指令：使用 CMD 或 ENTRYPOINT 指令來定義容器啟動時要執(zhí)行的命令，也就是默認的容器執(zhí)行命令。

4.dockerfile指令：

FROM 指定基礎鏡像，dockerfile構建鏡像的第一個指令

Eg:FROM centos:centos7.9.2009

LABEL 指定鏡像維護人信息

Eg:LABEL ZhangSan zs@163.com

ADD/COPY 復制本地文件/目錄到鏡像中

COPY 指令用于將本地文件復制到容器中。可以復制單個文件，也可以復制整個目錄。

語法格式：

COPY src dest

COPY ["src", "dest"]

解析：

<src源路徑>：源文件或者源目錄
<dest目標路徑>：容器內的指定路徑，該路徑不用事先建好，路徑不存在的話，會自動創(chuàng)建。

Eg：COPY test.txt /absoluteDir/

ADD 將宿主機目錄下（或遠程文件）的文件拷貝進鏡像，且會自動處理URL和解壓tar壓縮包。

語法格式：

ADD URL /dest #將文件下載到容器內部并以dest命名
ADD URL /dest/ #將文件下載到容器內的/dest目錄
ADD src /dest/ #將本地文件傳到容器/dest目錄下，壓縮文件會自動解壓

解析：

src 路徑必須在構建的上下文中；不能使用 ../something /something 這種方式，因為docker 構建的第一步是將上下文目錄（和子目錄）發(fā)送到docker守護程序。
如果 src 是URL，并且 dest 不以斜杠結尾，則從URL下載文件并將其復制到 dest 。
如果 dest 以斜杠結尾，將自動推斷出url的名字（保留最后一部分），保存到 dest
如果 src 是目錄，則將復制目錄的整個內容，包括文件系統(tǒng)元數(shù)據(jù)。

Eg：ADD alertmanager-0.19.0.linux-amd64.tar.gz /usr/local/bin

RUN 指定Linux命令，建議多個命令用 && 或 ; 串起來使用

語法格式：

RUN <命令行命令> ( shell 形式, /bin/sh -c 的方式運行，避免破壞shell字符串)

Eg: RUN /bin/bash -c 'source $HOME/.bashrc; \

echo $HOME'

ENV 設置鏡像環(huán)境變量

這個環(huán)境變量可以在后續(xù)的任何RUN指令中使用，這就如同在命令前面指定了環(huán)境變量前綴一樣；也可以在其它指令中直接使用這些環(huán)境變量；相當于定義（賦值）。

Eg：ENV CATALINA_HOME /usr/local/tomcat

WORKDIR $CATALINA_HOME

EXPOSE 暴露容器端口

EXPOSE指令實際上不會發(fā)布端口。它充當構建映像的人員和運行容器的人員之間的一種文檔，即有關打算發(fā)布哪些端口的信息。

Eg:EXPOSE 80/tcp

VOLUME 指定容器的匿名數(shù)據(jù)卷

Eg: VOLUME /var/log

作用：把容器的某些文件夾映射到主機外部

解析：

VOLUME 掛載點
無法指定宿主機的目錄，會掛載到宿主機/var/lib/docker/volumes下隨機生成的目錄下
掛載點可以是一個路徑，也可以是數(shù)組（數(shù)組中的每一項必須用雙引號）

USER 指定容器運行用戶

指定該鏡像以及構建鏡像時的命令以什么樣的用戶去執(zhí)行，如果不指定，默認是root。（一般不修改該配置），可搭配COPY使用。

語法格式：

USER <user>[:<group>]

Eg：USER patrick

USER 1000:1000

WORKDIR 指定鏡像的工作目錄

WORKDIR指令為Dockerfile中跟隨它的所有 RUN，CMD，ENTRYPOINT，COPY，ADD 指令設置工作目錄。如果WORKDIR不存在，即使以后的Dockerfile指令中未使用它也將被創(chuàng)建。

WORKDIR指令可在Dockerfile中多次使用。如果提供了相對路徑，則它將相對于上一個WORKDIR指令的路徑。

Eg：WORKDIR /a

WORKDIR b

WORKDIR c

RUN pwd

#結果 /a/b/c

ARG 指定構建鏡像時傳入的參數(shù)

構建時--build-arg 指定參數(shù)會覆蓋Dockerfile 中指定的同名參數(shù) docker build --build-arg 變量=值

ARG只在構建期有效，運行期無效，且一次只能指定一個參數(shù)

Eg：ARG version=3.13.4

FROM alpine:$version

CMD/ENTRYPOINT 指定容器啟動時執(zhí)行的命令

語法格式：

CMD command param1 param2

CMD ["param1","param2"]

ENTRYPOINT ["executable", "param1", "param2"]

       Eg：CMD ["1111"]

               CMD ["2222"]

               ENTRYPOINT ["echo"]

#構建出如上鏡像后測試

docker run xxxx：效果 echo 2222

指令之間的區(qū)別：

ADD 和 COPY 的區(qū)別

COPY只能復制本地文件/目錄到鏡像中

ADD不光可以復制本地文件/目錄到鏡像中，還可以通過URL下載文件復制到鏡像中，還能將本地tar壓縮包解壓后復制到鏡像中。（URL下載和tar包解壓特性不能一起使用）

ENTRYPOINT 和 CMD 的區(qū)別

CMD 提供容器默認的執(zhí)行命令，可以被運行容器時傳入的命令覆蓋。

ENTRYPOINT 配置容器啟動時執(zhí)行的默認可執(zhí)行文件，可以被運行容器時傳入的命令追加到其參數(shù)之后。

ENTRYPOINT 指定的容器啟動時運行命令優(yōu)先級更高，如果 ENTRYPOINT 和 CMD 同時存在，CMD 指定內容將作為 ENTRYPOINT 指定的命令的選項或參數(shù)去使用

5.Dockerfile構建過程：

基礎知識：

每條保留字指令都必須為大寫字母且后面要跟隨至少一個參數(shù)
指令按照從上到下，順序執(zhí)行
# 表示注釋
每條指令都會創(chuàng)建一個新的鏡像層，并對鏡像進行提交

構建鏡像和運行容器：

保存好 Dockerfile 后，可以使用以下命令構建鏡像。在Docker中，docker build -t my-node-app . 中的小數(shù)點代表當前上下文的路徑。這個路徑是構建過程中 Docker 引擎查找 Dockerfile 和其他構建上下文的文件的位置。

docker build 命令會將指定的路徑（這里是小數(shù)點 .）作為構建上下文。構建上下文是構建過程中用來查找 Dockerfile 和其他構建文件的目錄。在這個例子中，. 表示當前目錄，即你運行 docker build 命令的目錄。

Eg：docker build -f Dockerfile -t entrytest .

思路：

基于一個空的鏡像
下載需要的環(huán)境 ADD
執(zhí)行環(huán)境變量的配置 ENV
執(zhí)行一些Linux命令 RUN
日志 CMD
端口暴露 EXPOSE
掛載數(shù)據(jù)卷 VOLUMES

6.實戰(zhàn)練習

編寫Dockerfile文件，構建entrytest鏡像，

要求：

基于centos鏡像，輸出hello world

#編寫Dockerfile文件

[root@master Monitor]# vi Dockerfile

FROM centos:centos7.9.2009

ENTRYPOINT ["echo","hello"]

CMD ["world"]

#運行容器，傳遞參數(shù)

[root@master Monitor]# docker build -f Dockerfile -t entrytest .

Sending build context to Docker daemon  360.5MB

Step 1/3 : FROM centos:centos7.9.2009

 ---> eeb6ee3f44bd

Step 2/3 : ENTRYPOINT ["echo","hello"]

 ---> Running in 92f02cf3ef33

Removing intermediate container 92f02cf3ef33

 ---> dd20bc124389

Step 3/3 : CMD ["world"]

 ---> Running in 3826cda9251a

Removing intermediate container 3826cda9251a

 ---> 5acc8a29cae8

Successfully built 5acc8a29cae8

Successfully tagged entrytest:latest

[root@master Monitor]# docker run entrytest

hello world

[root@master Monitor]# docker run entrytest yun

hello yun