DockerFile 指令命令介紹

2021-09-05 12:52:52 字數 4594 閱讀 6081

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構建的方式 把操作的步驟通...