Dockerfile指令彙總及解析

原文地址:http://www.maoyupeng.com/dockerfile-command-introduction.html

什麼是Dockerfile

Dockerfile是由一系列命令和參數構成的腳本，這些命令應用於基礎鏡像並最終建立一個新的鏡像。它們簡化了從頭至尾的流程並極大的簡化了部署工做。Dockerfile從FROM命令開始，緊接着跟隨者各類方法，命令和參數。其產出爲一個新的能夠用於建立容器的鏡像。

當你在使用 Docker構建鏡像的時候，每個命令都會在前一個命令的基礎上造成一個新層。這些基礎鏡像能夠用於建立新的容器。本篇文章將手把手教您如何從基礎鏡像，一步一步，一層一層的從Dockerfile構建容器的過程。

Dockerfile示例

# Version 1.0
FORM ubuntu:14.04
MAINTAINER Mao "hongtu1993@sina.cn"
RUN apt-get update && apt-get install -y nginx
RUN echo 'Hello,I am work' > /usr/share/nginx/html/index.html
EXPOSE 80 80

Docker執行步驟分析

以上Dockerfile示例中,每條指令都會建立一個新的鏡像層並對鏡像進行提交.Docker執行Dockerfile大體流程:

1. Docker從基礎鏡像運行一個容器;

2. 執行一條指令,對容器作出修改;

3. 執行相似docker commit的操做,提交一個新的鏡像層;

4. Docker再基於剛提交的鏡像運行一個新容器;

5. 執行Dockerfile中的下一條指令,直到全部指令都執行完畢;

示例解析

1. FROM:每一個dockerfile的第一條命令是FROM.FROM指令指定一個已經存在的鏡像,則表明FROM後續的指令都是基於該鏡像(ubuntu14.04)進行的.

2. MAINTAINER:該指令告訴Docker,做者和郵箱地址

3. RUN:通俗地說,RUN指令會在shell裏使用命令包裝器 /bin/sh -c 來執行.若是在不支持shell的平臺上運行,則可以使用exec格式的RUN指令RUN ["apt-get","install","-y","nginx"]

4. EXPOSE: 向外公開端口

Dockerfile指令彙總及解析

MAINTAINER

我建議這個命令放在Dockerfile的起始部分，雖然理論上它能夠放置於Dockerfile的任意位置。這個命令用於聲明做者，並應該放在FROM的後面。

# MAINTAINER [name] [email]
MAINTAINER authors_name "hongtu1993@sina.cn"

FROM

FROM命令多是最重要的Dockerfile命令。改命令定義了使用哪一個基礎鏡像啓動構建流程。基礎鏡像能夠爲任意鏡 像。若是基礎鏡像沒有被發現，Docker將試圖從Docker image index來查找該鏡像。FROM命令必須是Dockerfile的首個命令。

# FROM [image name]

FROM ubuntu

ADD

ADD命令有兩個參數，源和目標。它的基本做用是從源系統的文件系統上覆制文件到目標容器的文件系統。若是源是一個URL，那該URL的內容將被下載並複製到容器中。

# ADD [source directory or URL] [destination directory]

ADD /my_app_folder /my_app_folder

RUN

RUN命令是Dockerfile執行命令的核心部分。它接受命令做爲參數並用於建立鏡像。不像CMD命令，RUN命令用於建立鏡像（在以前commit的層之上造成新的層）。

# RUN [command]

RUN apt-get update

CMD

和RUN命令類似，CMD能夠用於執行特定的命令。和RUN不一樣的是，這些命令不是在鏡像構建的過程當中執行的，而是在用鏡像構建容器後被調用。

# CMD application "argument", "argument", ..

CMD "echo" "Hello Mao!"

ENTRYPOINT

ENTRYPOINT幫助你配置一個容器使之可執行化，若是你結合CMD命令和ENTRYPOINT命令，你能夠從CMD命令中移除「application」而僅僅保留參數，參數將傳遞給ENTRYPOINT命令。

# Usage: ENTRYPOINT application "argument", "argument", ..
# Remember: arguments are optional. They can be provided by CMD
# or during the creation of a container.
ENTRYPOINT echo

# Usage example with CMD:
# Arguments set with CMD can be overridden during *run*
CMD "Hello docker!"
ENTRYPOINT echo

ENV

ENV命令用於設置環境變量。這些變量以」key=value」的形式存在，並能夠在容器內被腳本或者程序調用。這個機制給在容器中運行應用帶來了極大的便利。

# ENV key value

ENV SERVER_WORKS 4

USER

USER命令用於設置運行容器的UID。

# USER [UID]

USER 751

VOLUME

VOLUME命令用於讓你的容器訪問宿主機上的目錄。

# VOLUME ["/dir_1", "/dir_2" ..]

VOLUME ["/my_files"]

WORKDIR

WORKDIR命令用於設置CMD指明的命令的運行目錄。

# WORKDIR /path

WORKDIR ~/

EXPOSE

EXPOSE指令用來告訴Docker這個容器在運行時會監聽哪些端口，Docker在鏈接不一樣的容器(使用–link參數)時使用這些信息;
兩個Docker的核心概念是可重複和可移植。鏡像應該能夠運行在任何主機上而且運行儘量多的次數。在 Dockerfile中你有能力映射私有和公有端口，可是你永遠不要經過Dockerfile映射公有端口。經過映射公有端口到主機上，你將只能運行一個容器化應用程序實例。（譯者注：運行多個端口不就衝突啦）

# EXPOSE [port]

# private and public mapping
EXPOSE 80:8080

# private only
EXPOSE 80