23.Dockerfile 定制鏡像 —— 鏡像構(gòu)建上下文(Context)

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/
image.png

有了.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

參考文檔:

https://www.qikqiak.com/k8s-book/docs/4.Dockerfile%20%E5%AE%9A%E5%88%B6%E9%95%9C%E5%83%8F.html#%E9%95%9C%E5%83%8F%E6%9E%84%E5%BB%BA%E4%B8%8A%E4%B8%8B%E6%96%87%EF%BC%88context%EF%BC%89

http://www.reibang.com/p/e64d0d087559

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末披蕉,一起剝皮案震驚了整個濱河市,隨后出現(xiàn)的幾起案子乌奇,更是在濱河造成了極大的恐慌嚣艇,老刑警劉巖,帶你破解...
    沈念sama閱讀 218,858評論 6 508
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件华弓,死亡現(xiàn)場離奇詭異食零,居然都是意外死亡,警方通過查閱死者的電腦和手機寂屏,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 93,372評論 3 395
  • 文/潘曉璐 我一進店門贰谣,熙熙樓的掌柜王于貴愁眉苦臉地迎上來娜搂,“玉大人,你說我怎么就攤上這事吱抚“儆睿” “怎么了?”我有些...
    開封第一講書人閱讀 165,282評論 0 356
  • 文/不壞的土叔 我叫張陵秘豹,是天一觀的道長携御。 經(jīng)常有香客問我,道長既绕,這世上最難降的妖魔是什么啄刹? 我笑而不...
    開封第一講書人閱讀 58,842評論 1 295
  • 正文 為了忘掉前任,我火速辦了婚禮凄贩,結(jié)果婚禮上誓军,老公的妹妹穿的比我還像新娘。我一直安慰自己疲扎,他們只是感情好昵时,可當(dāng)我...
    茶點故事閱讀 67,857評論 6 392
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著椒丧,像睡著了一般壹甥。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上壶熏,一...
    開封第一講書人閱讀 51,679評論 1 305
  • 那天句柠,我揣著相機與錄音,去河邊找鬼久橙。 笑死俄占,一個胖子當(dāng)著我的面吹牛管怠,可吹牛的內(nèi)容都是我干的淆衷。 我是一名探鬼主播,決...
    沈念sama閱讀 40,406評論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼渤弛,長吁一口氣:“原來是場噩夢啊……” “哼祝拯!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起她肯,我...
    開封第一講書人閱讀 39,311評論 0 276
  • 序言:老撾萬榮一對情侶失蹤佳头,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后晴氨,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體康嘉,經(jīng)...
    沈念sama閱讀 45,767評論 1 315
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 37,945評論 3 336
  • 正文 我和宋清朗相戀三年籽前,在試婚紗的時候發(fā)現(xiàn)自己被綠了亭珍。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片敷钾。...
    茶點故事閱讀 40,090評論 1 350
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖肄梨,靈堂內(nèi)的尸體忽然破棺而出阻荒,到底是詐尸還是另有隱情,我是刑警寧澤众羡,帶...
    沈念sama閱讀 35,785評論 5 346
  • 正文 年R本政府宣布侨赡,位于F島的核電站,受9級特大地震影響粱侣,放射性物質(zhì)發(fā)生泄漏羊壹。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點故事閱讀 41,420評論 3 331
  • 文/蒙蒙 一甜害、第九天 我趴在偏房一處隱蔽的房頂上張望舶掖。 院中可真熱鬧,春花似錦尔店、人聲如沸眨攘。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,988評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽鲫售。三九已至,卻和暖如春该肴,著一層夾襖步出監(jiān)牢的瞬間情竹,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 33,101評論 1 271
  • 我被黑心中介騙來泰國打工匀哄, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留秦效,地道東北人。 一個月前我還...
    沈念sama閱讀 48,298評論 3 372
  • 正文 我出身青樓涎嚼,卻偏偏與公主長得像阱州,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子法梯,可洞房花燭夜當(dāng)晚...
    茶點故事閱讀 45,033評論 2 355

推薦閱讀更多精彩內(nèi)容