快捷導(dǎo)航

Docker利用Dockerfile與docker?build命令構(gòu)建鏡像指南

更新時(shí)間：2025年10月11日 09:50:29 作者：敲上癮

Docker鏡像能將應(yīng)用程序及其所有依賴打包成一個(gè)標(biāo)準(zhǔn)化的、可移植的文件,本文將簡(jiǎn)單介紹一下如何使用docker?commit指令和Dockerfile進(jìn)行構(gòu)建,需要的小伙伴可以了解下

一、鏡像制作簡(jiǎn)介

Docker鏡像能將應(yīng)用程序及其所有依賴（如庫(kù)、配置、運(yùn)行時(shí)環(huán)境等）打包成一個(gè)標(biāo)準(zhǔn)化的、可移植的文件，確保應(yīng)用在任何支持Docker的環(huán)境中都能以相同方式運(yùn)行，從而解決"在我這能跑，到你那卻不行"的環(huán)境一致性問(wèn)題，同時(shí)簡(jiǎn)化部署流程、提高擴(kuò)展效率，并通過(guò)容器化實(shí)現(xiàn)資源隔離與輕量化管理，讓應(yīng)用的開(kāi)發(fā)、測(cè)試和生產(chǎn)環(huán)境保持統(tǒng)一，大幅降低跨環(huán)境部署的復(fù)雜度和出錯(cuò)概率。

制作鏡像主要有兩種方式：

使用docker commit指令：基于運(yùn)行中的容器手動(dòng)創(chuàng)建鏡像，這種方式操作簡(jiǎn)單但缺乏可重復(fù)性，鏡像構(gòu)建過(guò)程難以追溯和維護(hù)，不推薦用于生產(chǎn)環(huán)境。
使用Dockerfile文件：通過(guò)編寫結(jié)構(gòu)化的文本文件定義鏡像構(gòu)建步驟，支持版本控制、自動(dòng)化構(gòu)建和精確配置，能清晰記錄鏡像制作過(guò)程，便于團(tuán)隊(duì)協(xié)作與迭代優(yōu)化，是推薦的標(biāo)準(zhǔn)做法。

相比docker commit，使用 Dockerfile 構(gòu)建鏡像是絕對(duì)的主流做法，核心優(yōu)勢(shì)如下：

1. 自動(dòng)化 & 可重復(fù)

文本文件定義流程，docker build 一鍵生成。
環(huán)境、配置、步驟完全一致，杜絕“在我這好使”的問(wèn)題。

2. 透明 & 可追溯

所有構(gòu)建步驟（裝了啥、改了啥）一目了然。
文件可存入 Git，誰(shuí)改了哪里，歷史可查。

3. 高效 & 快速

利用分層緩存：只重建變更的步驟，大幅提升構(gòu)建速度。

4. 易維護(hù) & 最佳實(shí)踐

輕松實(shí)施優(yōu)化（如用小體積基礎(chǔ)鏡像、合并指令）。
結(jié)構(gòu)清晰，易于理解和修改。

5. 天生適合 CI/CD

完美集成自動(dòng)化流程，實(shí)現(xiàn)代碼提交后自動(dòng)構(gòu)建、測(cè)試、部署。

二、Dockerfile文件配置

Dockerfile 就是鏡像的藍(lán)圖，Dockerfile與鏡像的關(guān)系如同圖紙與房子的關(guān)系

Dockerfile格式：

# Comment
INSTRUCTION arguments

2.1 常用命令清單

官方地址：https://docs.docker.com/reference/dockerfile/

FROM：構(gòu)建鏡像基于哪個(gè)鏡像，也就是基礎(chǔ)鏡像
LABEL：為鏡像添加元數(shù)據(jù)
COPY：拷貝文件或目錄到鏡像中，跟 ADD 類似，但不具備自動(dòng)下載或解壓的功能
ADD：拷貝文件或目錄到鏡像中，如果是 URL 或壓縮包便會(huì)自動(dòng)下載或自動(dòng)解壓
WORKDIR：指定工作目錄
RUN：指定 docker build 過(guò)程中運(yùn)行的程序
VOLUME：指定容器掛載點(diǎn)
EXPOSE：聲明容器的服務(wù)端口（僅僅是聲明）
ENV：設(shè)置環(huán)境變量
CMD：運(yùn)行容器時(shí)執(zhí)行的命令
ENTRYPOINT：運(yùn)行容器時(shí)程序入口
ARG：指定構(gòu)建時(shí)的參數(shù)
USER：指定當(dāng)前用戶
HEALTHCHECK：健康檢測(cè)指令

2.2 命令詳解

功能：

FROM 指令用于為鏡像文件構(gòu)建過(guò)程指定基礎(chǔ)鏡像，后續(xù)的指令運(yùn)行于此基礎(chǔ)鏡像所提供的運(yùn)行環(huán)境；

注意事項(xiàng)：

FROM 指令必須是 Dockerfile 中非注釋行或者 ARG 之后的第一個(gè)指令；
實(shí)踐中，基準(zhǔn)鏡像可以是任何可用鏡像文件，默認(rèn)情況下，docker build 會(huì)在 docker 主機(jī)上查找指定的鏡像文件，在其不存在時(shí)，則會(huì)自動(dòng)從 Docker 的公共庫(kù) pull 鏡像下來(lái)。如果找不到指定的鏡像文件，docker build 會(huì)返回一個(gè)錯(cuò)誤信息；
FROM 可以在一個(gè) Dockerfile 中出現(xiàn)多次，如果有需求在一個(gè) Dockerfile 中創(chuàng)建多個(gè)鏡像，或?qū)⒁粋€(gè)構(gòu)建階段作為另一個(gè)的依賴；
如果 FROM 語(yǔ)句沒(méi)有指定鏡像標(biāo)簽，則默認(rèn)使用 latest 標(biāo)簽。

語(yǔ)法：

FROM [--platform=<platform>] <image> [AS <name>]
FROM [--platform=<platform>] <image>[:<tag>] [AS <name>]
FROM [--platform=<platform>] <image>[@<digest>] [AS <name>]

參數(shù)：

<platform>:構(gòu)建的 cpu 架構(gòu)，如 linux/amd64, linux/arm64, windows/amd64
<image>: 指定作為 base image 的名稱；
<tag>: base image 的標(biāo)簽，省略時(shí)默認(rèn) latest；
<digest>: 是鏡像的哈希碼；
AS <name>: 指定構(gòu)建步驟的名稱，配合 COPY --from=<name> 可以完成多級(jí)構(gòu)建

示例：

注意：可在一個(gè) Dockerfile 中多次使用FROM指令，每個(gè)FROM指令開(kāi)啟一個(gè)新的構(gòu)建階段。每個(gè)階段都可以有自己的安裝、配置和構(gòu)建步驟。后面的構(gòu)建階段可以從前面的構(gòu)建階段中選擇性地復(fù)制所需的文件或目錄。即“多階段構(gòu)建”

LABEL

功能：

為鏡像添加元數(shù)據(jù)

語(yǔ)法：

LABEL <key>=<value> <key>=<value> <key>=<value> ...

示例：

FROM ubuntu:22.04 as buildstage1
LABEL version="1.0" desc="create by bit"

COPY

功能：

用于從 docker 主機(jī)復(fù)制新文件或者目錄至創(chuàng)建的新鏡像指定路徑中。

語(yǔ)法：

COPY [--chown=<user>:<group>] <src>... <dest>
COPY [--chown=<user>:<group>] ["<src>",... "<dest>"]

參數(shù)：

<src>：要復(fù)制的源文件或目錄，支持使用通配符；
<dest>：目標(biāo)路徑，即正在創(chuàng)建的 image 的文件系統(tǒng)路徑；建議<dest>使用絕對(duì)路徑，否則，COPY 指定以 WORKDIR 為當(dāng)前路徑
在路徑中有空白字符時(shí)，通常使用第 2 種格式；
--chown：修改用戶和組
--from <name>可選項(xiàng)：可以從之前構(gòu)建的步驟中拷貝內(nèi)容，結(jié)合 FROM ... AS <name>往往用作多級(jí)構(gòu)建，后續(xù)我們有實(shí)戰(zhàn)課專門完成多級(jí)構(gòu)建

注意：

<src>必須是 build 上下文中的路徑，不能是其父目錄中的文件；
如果<src>是目錄，則其內(nèi)部文件或子目錄會(huì)被遞歸復(fù)制，但<src>目錄自身不會(huì)被復(fù)制；
如果指定了多個(gè)<src>，或在<src>中使用了通配符，則<dest>必須是一個(gè)目錄，且必須以 / 結(jié)尾；
如果<dest>事先不存在，它將會(huì)被自動(dòng)創(chuàng)建，這包括父目錄路徑。

示例：

效果：

ENV

功能：

用于為鏡像定義所需的環(huán)境變量，并可被 Dockerfile 文件中位于其后的其它指令（如 ENV、ADD、COPY 等）所調(diào)用
調(diào)用格式為 $variable_name 或 ${variable_name}
語(yǔ)法：

ENV <key>=<value> ...

示例：

效果：

與ENV配合使用：

ENV MYROOTDIR=/data/web/html/
COPY ./index.html ${MYROOTDIR}

WORKDIR

功能：

為 Dockerfile 中所有的 RUN、CMD、ENTRYPOINT、COPY 和 ADD 指定設(shè)定工作目錄，相當(dāng)于cd到一個(gè)目錄然后執(zhí)行指令
語(yǔ)法：

WORKDIR /path/to/workdir

注意：

默認(rèn)的工作目錄是 /
如果提供了相對(duì)路徑，它將相對(duì)于前一條 WORKDIR 指令的路徑。
WORKDIR 指令可以解析先前使用設(shè)置的環(huán)境變量 ENV

示例：

效果：

注意：在 Dockerfile 中，如果存在多個(gè) WORKDIR 指令，在后續(xù)的 WORKDIR 指令出現(xiàn)之前，所有需要指定工作目錄的指令（如 RUN、CMD、ENTRYPOINT、COPY、ADD 等）都會(huì)以上一個(gè) WORKDIR 所設(shè)置的路徑作為工作目錄。

ADD

功能：

ADD 指令類似于 COPY 指令，ADD 支持使用 TAR 文件和 URL 路徑，會(huì)自動(dòng)完成解壓和下載，而copy不支持這個(gè)功能

語(yǔ)法：

ADD [--chown=<user>:<group>]  <src>... <dest>
ADD [--chown=<user>:<group>] ["<src>",... "<dest>"]

參數(shù)：

<src>：要復(fù)制的源文件或目錄，支持使用通配符；
<dest>：目標(biāo)路徑，即正在創(chuàng)建的 image 的文件系統(tǒng)路徑；建議<dest>使用絕對(duì)路徑，否則，ADD 指定以 WORKDIR 為起始路徑；在路徑中有空白字符時(shí)，通常使用第 2 種格式；
--chown：修改用戶和組

示例：

效果：

如果是本地下載tar，然后給容器會(huì)自動(dòng)解壓。如果是遠(yuǎn)端則不會(huì)。

RUN

功能：

用于指定 docker build 過(guò)程中運(yùn)行的程序，其可以是任何命令

語(yǔ)法：

#shell form
RUN <command>
#exec form
RUN ["executable", "param1", "param2"]

參數(shù)：

第一種格式中，<command>通常是一個(gè) shell 命令，且以/bin/sh -c來(lái)運(yùn)行它，Windows 默認(rèn)為 cmd /S /C。如果一個(gè)腳本 test.sh 不能自己執(zhí)行，必須要 /bin/sh -c test.sh 的方式來(lái)執(zhí)行，那么，如果使用 RUN 的 shell 形式，最后得到的命令相當(dāng)于：

/bin/sh -c "/bin/sh -c 'test.sh'"

第二種語(yǔ)法格式中的參數(shù)是一個(gè) JSON 格式的數(shù)組，其中<executable>為要運(yùn)行的命令，后面的 <paramN>為傳遞給命令的選項(xiàng)或參數(shù)；然而，此種格式指定的命令不會(huì)以/bin/sh -c來(lái)發(fā)起，因此常見(jiàn)的 shell 操作如變量替換以及通配符(?,*等)替換將不會(huì)進(jìn)行；不過(guò)，如果要運(yùn)行的命令依賴于此 shell 特性的話，可以將其替換為類似下面的格式。

RUN ["/bin/bash", "-c", "<executable>", "<param1>"]

示例：

注意：多使用&&把指令放在同一個(gè)RUN，減少層

CMD

功能：

類似于 RUN 指令，CMD 指令也可用于運(yùn)行任何命令或應(yīng)用程序，不過(guò)，二者的運(yùn)行時(shí)間點(diǎn)不同
RUN 指令運(yùn)行于映像文件構(gòu)建過(guò)程中，而 CMD 指令運(yùn)行于基于 Dockerfile 構(gòu)建出的新映像文件啟動(dòng)一個(gè)容器時(shí)
CMD 指令的首要目的在于為啟動(dòng)的容器指定默認(rèn)要運(yùn)行的程序，且其運(yùn)行結(jié)束后，容器也將終止；不過(guò)，CMD 指定的命令其可以被 docker run 的命令行選項(xiàng)所覆蓋
在 Dockerfile 中可以存在多個(gè) CMD 指令，但僅最后一個(gè)會(huì)生效

語(yǔ)法：

CMD ["executable","param1","param2"] (exec form, this is the preferred form)
CMD ["param1","param2"] (as default parameters to ENTRYPOINT)
CMD command param1 param2 (shell form)

注意：

第二種則用于為 ENTRYPOINT 指令提供默認(rèn)參數(shù)
json 數(shù)組中，要使用雙引號(hào)，單引號(hào)會(huì)出錯(cuò)

示例：

CMD ["/usr/local/nginx/sbin/nginx","-g","daemon off;"]

ENTRYPOINT

功能：

用于指定容器的啟動(dòng)入口

語(yǔ)法：

#exec form
ENTRYPOINT ["executable", "param1", "param2"]
# shell form
ENTRYPOINT command param1 param2

參數(shù)：

json 數(shù)組中，要使用雙引號(hào)，單引號(hào)會(huì)出錯(cuò)

注意：ENTRYPOINT與CMD功能類似，但ENTRYPOINT不會(huì)被docker run指令完全覆蓋，docker run后面的參數(shù)會(huì)作為ENTRYPOINT的參數(shù)。

示例：

test:v0.7使用CMD ["/usr/local/nginx/sbin/nginx","-g","daemon off;"]

test:v0.8使用ENTRYPOINT ["/usr/local/nginx/sbin/nginx","-g","daemon off;"]

EXPOSE

功能：

用于為容器聲明打開(kāi)指定要監(jiān)聽(tīng)的端口以實(shí)現(xiàn)與外部通信
該 EXPOSE 指令實(shí)際上并不發(fā)布端口。它充當(dāng)構(gòu)建圖像的人和運(yùn)行容器的人之間的一種文檔，關(guān)于要發(fā)布哪些端口。要在運(yùn)行容器時(shí)實(shí)際發(fā)布端口，使用 -p 參數(shù)發(fā)布和映射一個(gè)或多個(gè)端口，或者使用 -P flag 發(fā)布所有暴露的端口并將它們映射宿主機(jī)端口。

語(yǔ)法：

EXPOSE <port> [<port>/<protocol>...]

參數(shù)：

<protocol>：tcp/udp 協(xié)議
<port>：端口

示例：

EXPOSE 80/tcp

ARG

功能：

ARG 指令類似 ENV，定義了一個(gè)變量；區(qū)別于 ENV：用戶可以在構(gòu)建時(shí) docker build --build-arg <varname> = <value> 進(jìn)行對(duì)變量的修改；ENV 不可以；
如果用戶指定了未在 Dockerfile 中定義的構(gòu)建參數(shù)，那么構(gòu)建輸出警告。

語(yǔ)法：

ARG <name>[=<default value>]

注意：

Dockerfile 可以包含一個(gè)或多個(gè) ARG 指令
ARG 支持指定默認(rèn)值
使用范圍：定義之后才能使用，定義之前為空，如下面的案例，執(zhí)行命令 docker build --build-arg username=what_user . 第二行計(jì)算結(jié)果為 some_user，不是我們指定的 build-arg 中的參數(shù)值 what_user

注意：ARG和ENV同時(shí)存在時(shí)，ENV會(huì)覆蓋ARG

示例：

Dockerfile文件

ARG SYSVERSION=22.04
FROM ubuntu:${SYSVERSION}

構(gòu)建時(shí)可以更改變量從而更改Ubuntu版本：

docker build -t test:v0.9 --build-arg SYSVERSION=22.10

VOLUME

功能：

用于在 image 中創(chuàng)建一個(gè)掛載點(diǎn)目錄
通過(guò) VOLUME 指令創(chuàng)建的掛載點(diǎn)，無(wú)法指定主機(jī)上對(duì)應(yīng)的目錄，是自動(dòng)生成的。

語(yǔ)法：

VOLUME <mountpoint>
VOLUME ["<mountpoint>"]

參數(shù)：

mountpoint: 掛載點(diǎn)目錄

注意：

如果掛載點(diǎn)目錄路徑下此前有文件存在，docker run 命令會(huì)在卷掛載完成后將此前的所有文件復(fù)制到新掛載的卷中
其實(shí) VOLUME 指令只是起到了聲明容器中的目錄作為匿名卷，但是并沒(méi)有將匿名卷綁定到宿主機(jī)指定目錄的功能。
volume 只是指定了一個(gè)目錄，用以在用戶忘記啟動(dòng)時(shí)指定 -v 參數(shù)也可以保證容器的正常運(yùn)行。比如 mysql，你不能說(shuō)用戶啟動(dòng)時(shí)沒(méi)有指定 -v，然后刪了容器，就把 mysql 的數(shù)據(jù)文件都刪了，那樣生產(chǎn)上是會(huì)出大事故的，所以 mysql 的 dockerfile 里面就需要配置 volume，這樣即使用戶沒(méi)有指定 -v，容器被刪后也不會(huì)導(dǎo)致數(shù)據(jù)文件都不在了。還是可以恢復(fù)的。
volume 與 -v 指令一樣，容器被刪除以后映射在主機(jī)上的文件不會(huì)被刪除。
如果 -v 和 volume 指定了同一個(gè)位置，會(huì)以 -v 設(shè)定的目錄為準(zhǔn)，其實(shí) volume 指令的設(shè)定的目的就是為了避免用戶忘記指定 -v 的時(shí)候?qū)е碌臄?shù)據(jù)丟失，那么如果用戶指定了 -v，自然而然就不需要 volume 指定的位置了。

示例：

VOLUME ["/data1"]

USER

功能：

用于指定運(yùn)行 image 時(shí)的或運(yùn)行 Dockerfile 中任何 RUN、CMD 或 ENTRYPOINT 指令定的程序時(shí)的用戶名或 UID
默認(rèn)情況下，container 的運(yùn)行身份為 root 用戶
語(yǔ)法：

USER <user>[:<group>]
USER <UID>[:<GID>]

參數(shù)：

user: 用戶
group: 用戶組
uid: 用戶 id
gid: 組 id

注意：

<UID>可以為任意數(shù)字，但實(shí)踐中其必須為/etc/passwd中某用戶的有效UID，否則將運(yùn)行失敗

示例：

USER root:root
RUN groupadd mysql
RUN useradd mysql -g mysql
USER mysql:mysql
RUN whoami > /tmp/user.txt

HEALTHCHECK

功能：

HEALTHCHECK 指令告訴 Docker 如何測(cè)試容器以檢查它是否仍在工作。
即使服務(wù)器進(jìn)程仍在運(yùn)行，這也可以檢測(cè)出陷入無(wú)限循環(huán)且無(wú)法處理新連接的 Web 服務(wù)器等情況。

語(yǔ)法：

HEALTHCHECK [OPTIONS] CMD command (check container health by running a command inside the container)
HEALTHCHECK NONE (disable any healthcheck inherited from the base image)

OPTIONS 選項(xiàng)參數(shù)：

--interval=DURATION (default: 30s)：每隔多長(zhǎng)時(shí)間探測(cè)一次，默認(rèn) 30 秒
--timeout= DURATION (default: 30s)：服務(wù)響應(yīng)超時(shí)時(shí)長(zhǎng)，默認(rèn) 30 秒
--start-period= DURATION (default: 0s)：服務(wù)啟動(dòng)多久后開(kāi)始探測(cè)，默認(rèn) 0 秒
--retries=N (default: 3)：認(rèn)為檢測(cè)失敗幾次為宕機(jī)，默認(rèn) 3 次

返回值：

0：容器成功是健康的，隨時(shí)可以使用
1：不健康的容器無(wú)法正常工作
2：保留不使用此退出代碼

示例：

FROM nginx:1.24.0
HEALTHCHECK --interval=5s --timeout=3s \
CMD curl -fs http://localhost/ || exit 1

三、docker build 指令

功能：

docker build 命令用于使用 Dockerfile 創(chuàng)建鏡像。

語(yǔ)法：

docker build [OPTIONS] PATH | URL | -

關(guān)鍵參數(shù)：

--build-arg=[]:設(shè)置鏡像創(chuàng)建時(shí)的變量；
-f:指定要使用的 Dockerfile 路徑；
--label=[]:設(shè)置鏡像使用的元數(shù)據(jù)；
--no-cache:創(chuàng)建鏡像的過(guò)程不使用緩存；
--pull:嘗試去更新鏡像的新版本；
--quiet, -q:安靜模式，成功后只輸出鏡像 ID；
--tag, -t:鏡像的名字及標(biāo)簽，通常 name:tag 或者 name 格式；可以在一次構(gòu)建中為一個(gè)鏡像設(shè)置多個(gè)標(biāo)簽。
--network:默認(rèn) default。在構(gòu)建期間設(shè)置 RUN 指令的網(wǎng)絡(luò)模式