Dockerfile是由一系列命令和參數(shù)構(gòu)成的腳本,這些命令應(yīng)用于基礎(chǔ)鏡像并最終創(chuàng)建一個(gè)新的鏡像。它們簡(jiǎn)化了從頭到尾的流程并極大的簡(jiǎn)化了部署工作。Dockerfile從FROM命令開始,緊接著跟隨者各種方法,命令和參數(shù)。其產(chǎn)出為一個(gè)新的可以用于創(chuàng)建容器的鏡像。
Dockerfile 語法
在我們深入討論Dockerfile之前,讓我們快速過一下Dockerfile的語法和它們的意義。
什么是語法?
非常簡(jiǎn)單,在編程中,語法意味著一個(gè)調(diào)用命令,輸入?yún)?shù)去讓應(yīng)用執(zhí)行程序的文法結(jié)構(gòu)。這些語法被規(guī)則或明或暗的約束。程序員遵循語法規(guī)范以和計(jì)算機(jī) 交互。如果一段程序語法不正確,計(jì)算機(jī)將無法識(shí)別。Dockerfile使用簡(jiǎn)單的,清楚的和干凈的語法結(jié)構(gòu),極為易于使用。這些語法可以自我釋義,支持注釋。
Dockerfile 語法示例
Dockerfile語法由兩部分構(gòu)成,注釋和命令+參數(shù)
一個(gè)簡(jiǎn)單的例子:
# Print "Hello docker!"
RUN echo "Hello docker!"
Dockerfile 命令
Dockerfile有十幾條命令可用于構(gòu)建鏡像,下文將簡(jiǎn)略介紹這些命令。
FROM 命令
FROM image>
或
FROM image>:tag>
這個(gè)設(shè)置基本的鏡像,為后續(xù)的命令使用,所以應(yīng)該作為Dockerfile的第一條指令。
比如:
FROM ubuntu
如果沒有指定 tag ,則默認(rèn)tag是latest,如果都沒有則會(huì)報(bào)錯(cuò)。
RUN 命令
RUN命令會(huì)在上面FROM指定的鏡像里執(zhí)行任何命令,然后提交(commit)結(jié)果,提交的鏡像會(huì)在后面繼續(xù)用到。
兩種格式:
RUN command> (the command is run in a shell - `/bin/sh -c`)
或:
RUN ["executable", "param1", "param2" ... ] (exec form)
RUN命令等價(jià)于:
docker run image command
docker commit container_id
注釋
使用 # 作為注釋
如:
# Memcached
#
# VERSION 1.0/p>
p># use the ubuntu base image provided by dotCloud
FROM ubuntu/p>
p># make sure the package repository is up to date
RUN echo "deb http://archive.ubuntu.com/ubuntu precise main universe" > /etc/apt/sources.list
RUN apt-get update/p>
p># install memcached
RUN apt-get install -y memcached
MAINTAINER 命令
MAINTAINER name>
MAINTAINER命令用來指定維護(hù)者的姓名和聯(lián)系方式
如:
MAINTAINER Guillaume J. Charmes, guillaume@dotcloud.com
ENTRYPOINT 命令
有兩種語法格式,一種就是上面的(shell方式):
ENTRYPOINT cmd param1 param2 ...
第二種是 exec 格式:
ENTRYPOINT ["cmd", "param1", "param2"...]
如:
ENTRYPOINT ["echo", "Whale you be my container"]
ENTRYPOINT 命令設(shè)置在容器啟動(dòng)時(shí)執(zhí)行命令
root@tankywoo-docker:~# cat Dockerfile
FROM ubuntu
ENTRYPOINT echo "Welcome!"/p>
p>root@tankywoo-docker:~# docker run 62fda5e450d5
Welcome!
USER 命令
比如指定 memcached 的運(yùn)行用戶,可以使用上面的 ENTRYPOINT 來實(shí)現(xiàn):
ENTRYPOINT ["memcached", "-u", "daemon"]
更好的方式是:
ENTRYPOINT ["memcached"]
USER daemon
EXPOSE 命令
EXPOSE 命令可以設(shè)置一個(gè)端口在運(yùn)行的鏡像中暴露在外
EXPOSE port> [port>...]
比如memcached使用端口 11211,可以把這個(gè)端口暴露在外,這樣容器外可以看到這個(gè)端口并與其通信。
EXPOSE 11211
一個(gè)完整的例子:
# Memcached
#
# VERSION 2.2/p>
p># use the ubuntu base image provided by dotCloud
FROM ubuntu/p>
p>MAINTAINER Victor Coisne victor.coisne@dotcloud.com/p>
p># make sure the package repository is up to date
RUN echo "deb http://archive.ubuntu.com/ubuntu precise main universe" > /etc/apt/sources.list
RUN apt-get update/p>
p># install memcached
RUN apt-get install -y memcached/p>
p># Launch memcached when launching the container
ENTRYPOINT ["memcached"]/p>
p># run memcached as the daemon user
USER daemon/p>
p># expose memcached port
EXPOSE 11211
上面是官方例子,國(guó)內(nèi)建議換成163或sohu的源,不然太慢了。
root@tankywoo-docker:~# docker build -t tankywoo - dck [38/480]
Uploading context 2.56 kB
Uploading context
Step 0 : FROM ubuntu
---> 99ec81b80c55
Step 1 : MAINTAINER Victor Coisne victor.coisne@dotcloud.com
---> Using cache
---> 2b58110877f6
Step 2 : RUN echo "deb http://mirrors.163.com/ubuntu/ precise main restricted universe multiverse" > /etc/apt/sources.list
---> Running in f55a4a8bb069
---> d48c6a965398
Step 3 : RUN apt-get update
---> Running in da091a1dd6e7
Ign http://mirrors.163.com precise InRelease
Get:1 http://mirrors.163.com precise Release.gpg [198 B]/p>
p>..../p>
p>Processing triggers for libc-bin (2.19-0ubuntu6) ...
Processing triggers for ureadahead (0.100.0-16) ...
---> 2886671b5b86
Step 5 : ENTRYPOINT ["memcached"]
---> Running in e8aeeab92cb6
---> 7148293a4053
Step 6 : USER daemon
---> Running in 288766b19606
---> 235e7f630ffa
Step 7 : EXPOSE 11211
---> Running in c6f881b9d51f
---> 666c5d65f396
Successfully built 666c5d65f396
Removing intermediate container f55a4a8bb069
Removing intermediate container da091a1dd6e7
Removing intermediate container f23631d3d45a
Removing intermediate container e8aeeab92cb6
Removing intermediate container 288766b19606
Removing intermediate container c6f881b9d51f
ENV 命令
用于設(shè)置環(huán)境變量
ENV key> value>
設(shè)置了后,后續(xù)的RUN命令都可以使用。
使用此dockerfile生成的image新建container,可以通過 docker inspect 看到這個(gè)環(huán)境變量:
root@tankywoo-docker:~# docker inspect 49bfc7a9817f
...
"Env": [
"name=tanky",
"HOME=/",
"PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"
],
...
里面的name=tanky就是設(shè)置的。
也可以通過在docker run時(shí)設(shè)置或修改環(huán)境變量:
docker run -i -t --env name="tanky" ubuntu:newtest /bin/bash
ADD 命令
從src復(fù)制文件到container的dest路徑:
ADD src> dest>
src> 是相對(duì)被構(gòu)建的源目錄的相對(duì)路徑,可以是文件或目錄的路徑,也可以是一個(gè)遠(yuǎn)程的文件url
dest> 是container中的絕對(duì)路徑
VOLUME 命令
VOLUME ["mountpoint>"]
如:
VOLUME ["/data"]
創(chuàng)建一個(gè)掛載點(diǎn)用于共享目錄
WORKDIR 命令
WORKDIR /path/to/workdir
配置RUN, CMD, ENTRYPOINT 命令設(shè)置當(dāng)前工作路徑
可以設(shè)置多次,如果是相對(duì)路徑,則相對(duì)前一個(gè) WORKDIR 命令
比如:
WORKDIR /a WORKDIR b WORKDIR c RUN pwd
其實(shí)是在 /a/b/c 下執(zhí)行 pwd
CMD 命令
有三種格式:
CMD ["executable","param1","param2"] (like an exec, preferred form)
CMD ["param1","param2"] (as default parameters to ENTRYPOINT)
CMD command param1 param2 (as a shell)
一個(gè)Dockerfile里只能有一個(gè)CMD,如果有多個(gè),只有最后一個(gè)生效。