Docker 使用指南 (五)—— Dockerfile 詳解

版權聲明：本文由田飛雨原創文章，轉載請註明出處: 
文章原文連接：https://www.qcloud.com/community/article/97

來源：騰雲閣 https://www.qcloud.com/community

 

製做Docker image 有兩種方式：一是使用 Docker container，直接構建容器，再導出成 image 使用；二是使用 Dockerfile，將全部動做卸載文件中，再 build 成 image。Dockerfile 的方式很是靈活，推薦使用。

本次實驗環境：騰訊雲服務器 CentOS 6.7 x86_64

一.Dockerfile 基本結構

通常的，Dockerfile 分爲四部分：基礎鏡像信息、維護者信息、鏡像操做指令和容器啓動時執行指令。’#’ 爲 Dockerfile 中的註釋。先看下面一個小例子：

# This my first nginx Dockerfile
# Version 1.0

# Base images 基礎鏡像
FROM centos

#MAINTAINER 維護者信息
MAINTAINER tianfeiyu 

#ENV 設置環境變量
ENV PATH /usr/local/nginx/sbin:$PATH

#ADD  文件放在當前目錄下，拷過去會自動解壓
ADD nginx-1.8.0.tar.gz /usr/local/  
ADD epel-release-latest-7.noarch.rpm /usr/local/  

#RUN 執行如下命令 
RUN rpm -ivh /usr/local/epel-release-latest-7.noarch.rpm
RUN yum install -y wget lftp gcc gcc-c++ make openssl-devel pcre-devel pcre && yum clean all
RUN useradd -s /sbin/nologin -M www

#WORKDIR 至關於cd
WORKDIR /usr/local/nginx-1.8.0 

RUN ./configure --prefix=/usr/local/nginx --user=www --group=www --with-http_ssl_module --with-pcre && make && make install

RUN echo "daemon off;" >> /etc/nginx.conf

#EXPOSE 映射端口
EXPOSE 80

#CMD 運行如下命令
CMD ["nginx"]

FROM : 指定基礎鏡像，要在哪一個鏡像創建

格式爲 FROM <image> 或FROM <image>:<tag> 。

第一條指令必須爲 FROM 指令。

MAINTAINER：指定維護者信息

格式爲 MAINTAINER <name>

RUN：在鏡像中要執行的命令

格式爲 RUN <command> 或 RUN ["executable", "param1", "param2"]

前者將在 shell 終端中運行命令，即 /bin/bash -c ；後者則使用 exec 執行。指定使用其它終端能夠經過第二種方式實現，例如 RUN [「/bin/bash」, 「-c」,」echo hello」] 。

WORKDIR：指定當前工做目錄，至關於 cd

格式爲 WORKDIR /path/to/workdir

爲後續的 RUN 、 CMD 、 ENTRYPOINT 指令配置工做目錄。
可使用多個 WORKDIR 指令，後續命令若是參數是相對路徑，則會基於以前命令指定的路徑。例如

WORKDIR /a
WORKDIR b
WORKDIR c
RUN pwd

則最終路徑爲 /a/b/c 。

EXPOSE：指定容器要打開的端口

格式爲 EXPOSE <port> [<port>...]

告訴 Docker 服務端容器暴露的端口號，供互聯繫統使用。在啓動容器時須要經過 -P，Docker 主機會自動分配一個端口轉發到指定的端口。

ENV：定義環境變量

格式爲 ENV <key> <value> 。 指定一個環境變量，會被後續 RUN 指令使用，並在容器運行時保持。
例如

ENV PATH /usr/local/nginx/sbin:$PATH

COPY ：複製本地主機的 （爲 Dockerfile 所在目錄的相對路徑）到容器中的

格式爲 COPY 。

ADD：至關於 COPY，可是比 COPY 功能更強大

格式爲 ADD <src> <dest>

該命令將複製指定的 到容器中的 。 其中 能夠是Dockerfile所在目錄的一個相對路徑；也能夠是一個 URL；還能夠是一個 tar 文件，複製進容器會自動解壓。

VOLUME：掛載目錄

格式爲VOLUME ["/data"]

建立一個能夠從本地主機或其餘容器掛載的掛載點，通常用來存放數據庫和須要保持的數據等。

USER

格式爲 USER daemon

指定運行容器時的用戶名或 UID，後續的 RUN 也會使用指定用戶。當服務不須要管理員權限時，能夠經過該命令指定運行用戶。而且能夠在以前建立所須要的用戶，例如： RUN useradd -s /sbin/nologin -M www。

ENTRYPOINT

兩種格式：

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

ENTRYPOINT command param1 param2 （shell中執行）

配置容器啓動後執行的命令，而且不可被 docker run 提供的參數覆蓋。每一個 Dockerfile 中只能有一個 ENTRYPOINT ，當指定多個時，只有最後一個起效。

CMD

支持三種格式

CMD ["executable","param1","param2"] 使用 exec 執行，推薦方式；
CMD command param1 param2 在 /bin/bash 中執行，提供給須要交互的應用；
CMD ["param1","param2"] 提供給 ENTRYPOINT 的默認參數；

指定啓動容器時執行的命令，每一個 Dockerfile 只能有一條 CMD 命令。若是指定了多條命令，只有最後一條會被執行。若是用戶啓動容器時候指定了運行的命令，則會覆蓋掉 CMD 指定的命令。

ONBUILD：在構建本鏡像時不生效，在基於此鏡像構建鏡像時生效

格式爲 ONBUILD [INSTRUCTION]

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

ENTRYPOINT 和 CMD 的區別：ENTRYPOINT 指定了該鏡像啓動時的入口，CMD 則指定了容器啓動時的命令，當二者共用時，完整的啓動命令像是 ENTRYPOINT + CMD 這樣。使用 ENTRYPOINT 的好處是在咱們啓動鏡像就像是啓動了一個可執行程序，在 CMD 上僅須要指定參數；另外在咱們須要自定義 CMD 時不容易出錯。

使用 CMD 的 Dockerfile：

[root@sta2 test]# cat Dockerfile 
FROM mysql

CMD ["echo","test"]

使用 ENTRYPOINT 的 Dockerfile：

[root@sta2 entrypoint]#  cat  Dockerfile 
FROM mysql

ENTRYPOINT ["echo","test"]

結論：ENTRYPOINT 不能覆蓋掉執行時的參數，CMD 能夠掉覆蓋默認的參數。

可使用如下命令覆蓋默認的參數，方便調試 Dockerfile 中的 bug：
[root@sta2 entrypoint]# docker run -it --entrypoint=/bin/bash feiyu/entrypoint:1

二.建立鏡像

構建鏡像時，須要將要使用的包及 Dockerfile 文件放在一個目錄中，像下面這樣：

使用如下命令來構建一個鏡像：
# docker build -t feiyu/nginx:1.8 .
Docker 鏡像採用分層的技術，因此建立過程當中每個命令都至關於一層：

# docker run -d -p 8080:80 --name mynginx feiyu/nginx:1.8 #啓動容器