2 示例
arg version=latest
from busybox:$version
arg version
run echo $version > image_version
from ,或from :,或from @。
注意:任何dockerfile中的第一條指令必須為from指令,並且,如果在同乙個dockerfile中建立多個映象,可以使用多個from指令(每個映象一次)。
指定維護者資訊,格式為maintainer
eg:
maintainer [email protected]
該資訊會寫入生成映象的author屬性域中
功能為執行指定的命令
run命令有兩種格式
1. run
2. run ["executable", "param1", "param2"]
第一種後邊直接跟shell命令
第二種是類似於函式呼叫。
可將executable理解成為可執行檔案,後面就是兩個引數。
兩種寫法比對:
注意:多行命令不要寫多個run,原因是dockerfile中每乙個指令都會建立一層.
多少個run就構建了多少層映象,會造成映象的臃腫、多層,不僅僅增加了構件部署的時間,還容易出錯。
run書寫時的換行符是\
功能為容器啟動時要執行的命令
語法有三種寫法
1. cmd ["executable","param1","param2"]
2. cmd ["param1","param2"]
3. cmd command param1 param2
第三種比較好理解了,就時shell這種執行方式和寫法
第一種和第二種其實都是可執行檔案加上引數的形式
舉例說明兩種寫法:
補充細節:這裡邊包括引數的一定要用雙引號,就是",不能是單引號。千萬不能寫成單引號。
原因是引數傳遞後,docker解析的是乙個json array
run & cmd
不要把run和cmd搞混了。
run是構件容器時就執行的命令以及提交執行結果
cmd是容器啟動時執行的命令,在構件時並不執行,構件時緊緊指定了這個命令到底是個什麼樣子
注意:每個dodckerfile 只能有一條cmd命令,如果指定了多條命令,只有最後一條會被執行。
label 指令用來指定生成映象的元資料標籤資訊。
格式為label =.....
eg:
label version = "1.0"
label description = "this text illustrates ...."
宣告映象內服務所監聽的埠。
格式為expose [... ]
eg:
expose 22 80 8443
注意:該指令只能宣告作用,並不會自動完成埠對映。
指定環境變數,在映象生成過程中會被後續run指令使用,在映象啟動的容器中也存在。
格式為:env或env= ...
兩者的區別就是第一種是一次設定乙個,第二種是一次設定多個
eg:env name1 ping
env name2 on_ip
或者env name1=ping name2=on_ip
如果把虛擬機器與容器想象成兩台linux伺服器的話,那麼這個命令就類似於scp,只是scp需要加使用者名稱和密碼的許可權驗證,而add不用.
該命令將複製指定的路徑下的內容到容器中的路徑下。
如以下寫法都是可以的:
注意:其中dockerfile所在目錄的乙個相對路徑(檔案或目錄),也可以是乙個url,還可以是tar檔案。支援正規表示式
看這個名字就知道,又是乙個複製命令
語法如下:
1. copy ... 2. copy ["",... ""]
與add的區別
copy的只能是本地檔案,其他用法一致
功能是啟動時的預設命令
語法如下:
1. entrypoint ["executable", "param1", "param2"]
2. entrypoint command param1 param2
如果從上到下看到這裡的話,那麼你應該對這兩種語法很熟悉啦。
第二種就是寫shell
第一種就是可執行檔案加引數
與cmd比較說明(這倆命令太像了,而且還可以配合使用):
1. 相同點:
2. 不同點:
如下:
from ubuntu
entrypoint ["top", "-b"]
cmd ["-c"]
如下:
from ubuntu
entrypoint ["top", "-b"]
cmd ls -al
那麼將執行ls -al ,top -b不會執行。
可實現掛載功能,可以將內地資料夾或者其他容器種得資料夾掛在到這個容器種
語法為:
volume ["/data"]
說明:
["/data"]可以是乙個jsonarray ,也可以是多個值。所以如下幾種寫法都是正確的
volume ["/var/log/"]
volume /var/log
volume /var/log /var/db
一般的使用場景為需要持久化儲存資料時
容器使用的是aufs,這種檔案系統不能持久化資料,當容器關閉後,所有的更改都會丟失。
所以當資料需要持久化時用這個命令。
設定啟動容器的使用者,可以是使用者名稱或uid,所以,只有下面的兩種寫法是正確的
注意:如果設定了容器以daemon使用者去執行,那麼run, cmd 和 entrypoint 都會以這個使用者去執行
語法:
workdir /path/to/workdir
設定工作目錄,對run,cmd,entrypoint,copy,add生效。如果不存在則會建立,也可以設定多次。
如:
workdir /a
workdir b
workdir c
run pwd
pwd執行的結果是/a/b/c
workdir也可以解析環境變數
如:
env dirpath /path
workdir $dirpath/$dirname
run pwd
pwd的執行結果是/path/$dirname
onbuild
語法:
onbuild [instruction]
這個命令只對當前映象的子映象生效。
比如當前映象為a,在dockerfile種新增:
onbuild run ls -al
這個 ls -al 命令不會在a映象構建或啟動的時候執行
此時有乙個映象b是基於a映象構建的,那麼這個ls -al 命令會在b映象構建的時候被執行。
語法:
stopsignal signal
stopsignal命令是的作用是當容器推出時給系統傳送什麼樣的指令
容器健康狀況檢查命令
語法有兩種:
1. healthcheck [options] cmd command
2. healthcheck none
第乙個的功能是在容器內部執行乙個命令來檢查容器的健康狀況
第二個的功能是在基礎映象中取消健康檢查命令
[options]的選項支援以下三中選項:
--interval=duration 兩次檢查預設的時間間隔為30秒
--timeout=duration 健康檢查命令執行超時時長,預設30秒
--retries=n 當連續失敗指定次數後,則容器被認為是不健康的,狀態為unhealthy,預設次數是3
注意:healthcheck命令只能出現一次,如果出現了多次,只有最後乙個生效。
cmd後邊的命令的返回值決定了本次健康檢查是否成功,具體的返回值如下:
0: success - 表示容器是健康的
1: unhealthy - 表示容器已經不能工作了
2: reserved - 保留值
例子:
healthcheck --interval=5m --timeout=3s \
cmd curl -f http://localhost/ || exit 1
健康檢查命令是:curl -f http://localhost/ || exit 1
兩次檢查的間隔時間是5秒
命令超時時間為3秒
docker(8)Dockerfile指令介紹
dockerfile 是乙個用來構建映象的文字檔案,文字內容包含了一條條構建映象所需的指令和說明。dockerfile是用來構建docker映象的構建檔案,是由一系列命令和引數構成的指令碼。簡單來說,dockerfile就是把我們安裝環境的每個步驟和指令,放到乙個檔案,最後一鍵執行,最後做成乙個你想...
Dockerfile指令總結
指令的一般格式為instruction arguments,指令包括from maintainer run等。格式為from或from 第一條指令必須為from指令。並且,如果在同乙個dockerfile中建立多個映象時,可以使用多個from指令 每個映象一次 格式為maintainer,指定維護者...
Dockerfile 指令詳解
一種通過commit的方式 把做了一系列操作的容器關閉,然後利用docker的commit指令 dockercommit 容器id 映象名 tag。然後dockerpush到映象倉庫。別人pull下來的再次啟動的時候,就是你當前的操作的形態。另一種是通過dockerfile構建的方式 把操作的步驟通...