docker build 的命令格式:
docker build [選項] <上下文路徑/URL/->
選項說明:
--tag, -t: 鏡像的名字及tag赶掖,通常name:tag或者name格式
-f : 指定要使用的Dockerfile路徑
如果注意若专,會看到 docker build 命令最后有一個.
从藤。.
表示當(dāng)前目錄比规,而 Dockerfile 就在當(dāng)前目錄吱窝,因此不少初學(xué)者以為這個路徑是在指定 Dockerfile 所在路徑讥邻,這么理解其實是不準(zhǔn)確的。如果對應(yīng)上面的命令格式院峡,你可能會發(fā)現(xiàn)计维,這是在指定上下文路徑。那么什么是上下文呢撕予?
01.Docker build 的工作原理
Docker 在運行時分為 Docker 引擎(也就是服務(wù)端守護進程)和客戶端工具鲫惶。
Docker 的引擎提供了一組 REST API,被稱為 Docker Remote API实抡,而如 docker 命令這樣的客戶端工具欠母,則是通過這組 API 與 Docker 引擎交互,從而完成各種功能吆寨。因此赏淌,雖然表面上我們好像是在本機執(zhí)行各種 docker 功能,但實際上啄清,一切都是使用的遠程調(diào)用形式在服務(wù)端(Docker 引擎)完成六水。也因為這種 C/S 設(shè)計,讓我們操作遠程服務(wù)器的 Docker 引擎變得輕而易舉。
當(dāng)我們進行鏡像構(gòu)建的時候掷贾,并非所有定制都會通過 RUN 指令完成睛榄,經(jīng)常會需要將一些本地文件復(fù)制進鏡像,比如通過 COPY 指令想帅、ADD 指令等场靴。而 docker build 命令構(gòu)建鏡像,其實并非在本地構(gòu)建港准,而是在服務(wù)端旨剥,也就是 Docker 引擎中構(gòu)建的。那么在這種客戶端/服務(wù)端的架構(gòu)中浅缸,如何才能讓服務(wù)端獲得本地文件呢轨帜?
這就引入了上下文的概念。
02.什么是上下文(context)
當(dāng)構(gòu)建的時候衩椒,用戶會指定構(gòu)建鏡像上下文的路徑蚌父,docker build 命令得知這個路徑后,會將路徑下的所有內(nèi)容打包烟具,然后上傳給 Docker 引擎。這樣 Docker 引擎收到這個上下文包后奠蹬,展開就會獲得構(gòu)建鏡像所需的一切文件朝聋。如果在 Dockerfile 中這么寫:
COPY ./config.yml /usr/src/start/
這并不是要復(fù)制執(zhí)行 docker build 命令所在的目錄下的 config.yml,也不是復(fù)制 Dockerfile 所在目錄下的 config.yml囤躁,而是復(fù)制 上下文(context) 目錄下的 config.yml冀痕。
因此,COPY
這類指令中的源文件的路徑都是相對路徑狸演。這也是初學(xué)者經(jīng)常會問的為什么 COPY ../config.yml /usr/src/start/ 或者 COPY /opt/xxxx /usr/src/start/ 無法工作的原因言蛇,因為這些路徑已經(jīng)超出了上下文的范圍,Docker 引擎無法獲得這些位置的文件宵距。如果真的需要那些文件腊尚,應(yīng)該將它們復(fù)制到上下文目錄中去。
現(xiàn)在就可以理解剛才的命令docker build -t nginx:v3 .
中的這個.
满哪,實際上是在指定上下文的目錄婿斥,docker build 命令會將該目錄下的內(nèi)容打包交給 Docker 引擎以幫助構(gòu)建鏡像。
如果觀察 docker build 輸出哨鸭,我們其實已經(jīng)看到了這個發(fā)送上下文的過程:
$ docker build -t nginx:canary .
Sending build context to Docker daemon 2.048 kB
...
理解構(gòu)建上下文對于鏡像構(gòu)建是很重要的民宿,可以避免犯一些不應(yīng)該的錯誤。比如有些初學(xué)者在發(fā)現(xiàn) COPY /opt/xxxx /usr/src/start/ 不工作后像鸡,于是干脆將 Dockerfile 放到了硬盤根目錄去構(gòu)建活鹰,結(jié)果發(fā)現(xiàn) docker build 執(zhí)行后,在發(fā)送一個幾十 GB 的東西,極為緩慢而且很容易構(gòu)建失敗志群。那是因為這種做法是在讓 docker build 打包整個硬盤着绷,這顯然是使用錯誤。
一般來說赖舟,應(yīng)該會將 Dockerfile 置于一個空目錄下蓬戚,或者項目根目錄下。如果該目錄下沒有所需文件宾抓,那么應(yīng)該把所需文件復(fù)制一份過來子漩。如果目錄下有些東西確實不希望構(gòu)建時傳給 Docker 引擎,那么可以用 .gitignore 一樣的語法寫一個.dockerignore
石洗,該文件是用于剔除不需要作為上下文傳遞給 Docker 引擎的幢泼。
那么為什么會有人誤以為 . 是指定 Dockerfile 所在目錄呢?這是因為在默認情況下讲衫,如果不額外指定 Dockerfile 的話缕棵,會將上下文目錄下的名為 Dockerfile 的文件作為 Dockerfile。
這只是默認行為涉兽,實際上 Dockerfile 的文件名并不要求必須為 Dockerfile招驴,而且并不要求必須位于上下文目錄中,比如可以用-f ../Dockerfile.php
參數(shù)指定某個文件作為 Dockerfile枷畏。
當(dāng)然别厘,一般大家習(xí)慣性的會使用默認的文件名 Dockerfile,以及會將其置于鏡像構(gòu)建上下文目錄中拥诡。
03.使用.dockerignore 文件
此文件與Dockerfile在同一目錄下触趴,內(nèi)容寫上要忽略的文件夾,如下面的.vscode/
和env/
渴肉,重新構(gòu)建時就會忽略這兩個文件夾
- 作用:一是提高構(gòu)建鏡像的速度冗懦;二是保護敏感文件等
.vscode/
env/
有了.dockerignore
文件后,我們再build, build context就小了很多仇祭,2.048 kB
$ docker image build -t nginx:canary .
Sending build context to Docker daemon 2.048 kB
Step 1/7 : FROM nginx
---> 6a4de079b93a
...
Step 7/7 : CMD ["test", "api", "--config", "config.yml"]
---> Running in 7ea669f59d5e
Removing intermediate container 7ea669f59d5e
---> f7bbad588a27
Successfully built f7bbad588a27
Successfully tagged nginx:canary
參考文檔: