【Docker】Dockerfile用法詳解

製作Docker image 有兩種方式:一是使用 Docker container,直接構建容器,再導出成 image 使用;二是使用 Dockerfile,將所有動作寫在文件中,再 build 成 image。Dockerfile 的方式非常靈活,推薦使用。

一.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 /aWORKDIR bWORKDIR cRUN 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 #啓動容器

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章