Dockerfile的指令

指令的一般格式為

INSTRUCTION arguments

，指令包括

FROM

、

MAINTAINER

RUN

等。

FROM

格式為

FROM <image>

或

FROM <image>:<tag>

。

第一條指令必須為

FROM

指令。并且，如果在同一個Dockerfile中建立多個鏡像時，可以使用多個

FROM

指令（每個鏡像一次）。

MAINTAINER

MAINTAINER <name>

，指定維護者資訊。

RUN

RUN <command>

RUN ["executable", "param1", "param2"]

前者将在 shell 終端中運作指令，即

/bin/sh -c

；後者則使用

exec

執行。指定使用其它終端可以通過第二種方式實作，例如

RUN ["/bin/bash", "-c", "echo hello"]

每條

RUN

指令将在目前鏡像基礎上執行指定指令，并送出為新的鏡像。當指令較長時可以使用

\

來換行。

CMD

支援三種格式

• CMD ["executable","param1","param2"]

  使用

  exec

  執行，推薦方式；

• CMD command param1 param2

  在

  /bin/sh

  中執行，提供給需要互動的應用；

• CMD ["param1","param2"]

  提供給

  ENTRYPOINT

  的預設參數；

指定啟動容器時執行的指令，每個 Dockerfile 隻能有一條

CMD

指令。如果指定了多條指令，隻有最後一條會被執行。

如果使用者啟動容器時候指定了運作的指令，則會覆寫掉

CMD

指定的指令。

EXPOSE

EXPOSE <port> [<port>...]

告訴 Docker 服務端容器暴露的端口号，供互聯系統使用。在啟動容器時需要通過 -P，Docker 主機會自動配置設定一個端口轉發到指定的端口。

ENV

ENV <key> <value>

。 指定一個環境變量，會被後續

RUN

指令使用，并在容器運作時保持。

例如

ENV PG_MAJOR 9.3
ENV PG_VERSION 9.3.4
RUN curl -SL http://example.com/postgres-$PG_VERSION.tar.xz | tar -xJC /usr/src/postgress && …
ENV PATH /usr/local/postgres-$PG_MAJOR/bin:$PATH           

ADD

ADD <src> <dest>

該指令将複制指定的

<src>

到容器中的

<dest>

。 其中

<src>

可以是Dockerfile所在目錄的一個相對路徑；也可以是一個 URL；還可以是一個 tar 檔案（自動解壓為目錄）。

COPY

COPY <src> <dest>

複制本地主機的

<src>

（為 Dockerfile 所在目錄的相對路徑）到容器中的

<dest>

當使用本地目錄為源目錄時，推薦使用

COPY

ENTRYPOINT

兩種格式：

• ENTRYPOINT ["executable", "param1", "param2"]

• ENTRYPOINT command param1 param2

  （shell中執行）。

配置容器啟動後執行的指令，并且不可被

docker run

提供的參數覆寫。

每個 Dockerfile 中隻能有一個

ENTRYPOINT

，當指定多個時，隻有最後一個起效。

VOLUME

VOLUME ["/data"]

建立一個可以從本地主機或其他容器挂載的挂載點，一般用來存放資料庫和需要保持的資料等。

USER

USER daemon

指定運作容器時的使用者名或 UID，後續的

RUN

也會使用指定使用者。

當服務不需要管理者權限時，可以通過該指令指定運作使用者。并且可以在之前建立所需要的使用者，例如：

RUN groupadd -r postgres && useradd -r -g postgres postgres

。要臨時擷取管理者權限可以使用

gosu

，而不推薦

sudo

WORKDIR

WORKDIR /path/to/workdir

為後續的

RUN

CMD

ENTRYPOINT

指令配置工作目錄。

可以使用多個

WORKDIR

指令，後續指令如果參數是相對路徑，則會基于之前指令指定的路徑。例如

WORKDIR /a
WORKDIR b
WORKDIR c
RUN pwd           

則最終路徑為

/a/b/c

ONBUILD

ONBUILD [INSTRUCTION]

配置當所建立的鏡像作為其它新建立鏡像的基礎鏡像時，所執行的操作指令。

[...]
ONBUILD ADD . /app/src
ONBUILD RUN /usr/local/bin/python-build --dir /app/src
[...]           

FROM image-A

#Automatically run the following
ADD . /app/src
RUN /usr/local/bin/python-build --dir /app/src