Dockfile是一種被Docker程序解釋的腳本,Dockerfile由一條一條的指令組成,每條指令對應Linux下面的一條命令。Docker程序將這些Dockerfile指令翻譯真正的Linux命令。Dockerfile有本身書寫格式和支持的命令,Docker程序解決這些命令間的依賴關係,相似於Makefile。Docker程序將讀取Dockerfile,根據指令生成定製的p_w_picpath。相比p_w_picpath這種黑盒子,Dockerfile這種顯而易見的腳本更容易被使用者接受,它明確的代表p_w_picpath是怎麼產生的。有了Dockerfile,當咱們須要定製本身額外的需求時,只需在Dockerfile上添加或者修改指令,從新生成p_w_picpath便可,省去了敲命令的麻煩。java
Dockerfile的指令是忽略大小寫的,建議使用大寫,使用 # 做爲註釋,每一行只支持一條指令,每條指令能夠攜帶多個參數。
Dockerfile的指令根據做用能夠分爲兩種,構建指令和設置指令。構建指令用於構建p_w_picpath,其指定的操做不會在運行p_w_picpath的容器上執行;設置指令用於設置p_w_picpath的屬性,其指定的操做將在運行p_w_picpath的容器中執行
linux
構建指令,必須指定且須要在Dockerfile其餘指令的前面。後續的指令都依賴於該指令指定的p_w_picpath。FROM指令指定的基礎p_w_picpath能夠是官方遠程倉庫中的,也能夠位於本地倉庫。
該指令有兩種格式:
web
[plain] view plaincopydocker
FROM <p_w_picpath> shell
指定基礎p_w_picpath爲該p_w_picpath的最後修改的版本。或者:
apache
[plain] view plaincopyubuntu
FROM <p_w_picpath>:<tag> vim
指定基礎p_w_picpath爲該p_w_picpath的一個tag版本centos
(2)MAINTAINER(用來指定鏡像建立者信息)瀏覽器
構建指令,用於將p_w_picpath的製做者相關的信息寫入到p_w_picpath中。當咱們對該p_w_picpath執行docker inspect命令時,輸出中有相應的字段記錄該信息。
格式:
[plain] view plaincopy
MAINTAINER <name>
構建指令,RUN能夠運行任何被基礎p_w_picpath支持的命令。如基礎p_w_picpath選擇了ubuntu,那麼軟件管理部分只能使用ubuntu的命令。
該指令有兩種格式:
[plain] view plaincopy
RUN <command> (the command is run in a shell - `/bin/sh -c`)
RUN ["executable", "param1", "param2" ... ] (exec form)
設置指令,用於container啓動時指定的操做。該操做能夠是執行自定義腳本,也能夠是執行系統命令。該指令只能在文件中存在一次,若是有多個,則只執行最後一條。
該指令有三種格式:
[plain] view plaincopy
CMD ["executable","param1","param2"] (like an exec, this is the preferred form)
CMD command param1 param2 (as a shell)
當Dockerfile指定了ENTRYPOINT,那麼使用下面的格式:
[plain] view plaincopy
CMD ["param1","param2"] (as default parameters to ENTRYPOINT)
ENTRYPOINT指定的是一個可執行的腳本或者程序的路徑,該指定的腳本或者程序將會以param1和param2做爲參數執行。因此若是CMD指令使用上面的形式,那麼Dockerfile中必需要有配套的ENTRYPOINT。
設置指令,指定容器啓動時執行的命令,能夠屢次設置,可是隻有最後一個有效。
兩種格式:
[plain] view plaincopy
ENTRYPOINT ["executable", "param1", "param2"] (like an exec, the preferred form)
ENTRYPOINT command param1 param2 (as a shell)
該指令的使用分爲兩種狀況,一種是獨自使用,另外一種和CMD指令配合使用。
當獨自使用時,若是你還使用了CMD命令且CMD是一個完整的可執行的命令,那麼CMD指令和ENTRYPOINT會互相覆蓋只有最後一個CMD或者ENTRYPOINT有效。
[plain] view plaincopy
# CMD指令將不會被執行,只有ENTRYPOINT指令被執行
CMD echo 「Hello, World!」
ENTRYPOINT ls -l
另外一種用法和CMD指令配合使用來指定ENTRYPOINT的默認參數,這時CMD指令不是一個完整的可執行命令,僅僅是參數部分;ENTRYPOINT指令只能使用JSON方式指定執行命令,而不能指定參數。
[plain] view plaincopy
FROM ubuntu
CMD ["-l"]
ENTRYPOINT ["/usr/bin/ls"]
設置指令,設置啓動容器的用戶,默認是root用戶。
[plain] view plaincopy
# 指定memcached的運行用戶
ENTRYPOINT ["memcached"]
USER daemon
或
ENTRYPOINT ["memcached", "-u", "daemon"]
設置指令,該指令會將容器中的端口映射成宿主機器中的某個端口。當你須要訪問容器的時候,能夠不是用容器的IP地址而是使用宿主機器的IP地址和映射後的端口。要完成整個操做須要兩個步驟,首先在Dockerfile使用EXPOSE設置須要映射的容器端口,而後在運行容器的時候指定-p選項加上EXPOSE設置的端口,這樣EXPOSE設置的端口號會被隨機映射成宿主機器中的一個端口號。也能夠指定須要映射到宿主機器的那個端口,這時要確保宿主機器上的端口號沒有被使用。EXPOSE指令能夠一次設置多個端口號,相應的運行容器的時候,能夠配套的屢次使用-p選項。
格式:
[plain] view plaincopy
EXPOSE <port> [<port>...]
[plain] view plaincopy
# 映射一個端口
EXPOSE port1
# 相應的運行容器使用的命令
docker run -p port1 p_w_picpath
# 映射多個端口
EXPOSE port1 port2 port3
# 相應的運行容器使用的命令
docker run -p port1 -p port2 -p port3 p_w_picpath
# 還能夠指定須要映射到宿主機器上的某個端口號
docker run -p host_port1:port1 -p host_port2:port2 -p host_port3:port3 p_w_picpath
端口映射是docker比較重要的一個功能,緣由在於咱們每次運行容器的時候容器的IP地址不能指定而是在橋接網卡的地址範圍內隨機生成的。宿主機器的IP地址是固定的,咱們能夠將容器的端口的映射到宿主機器上的一個端口,免去每次訪問容器中的某個服務時都要查看容器的IP的地址。對於一個運行的容器,可使用docker port加上容器中須要映射的端口和容器的ID來查看該端口號在宿主機器上的映射端口。
構建指令,在p_w_picpath中設置一個環境變量。
格式:
[plain] view plaincopy
ENV <key> <value>
設置了後,後續的RUN命令均可以使用,container啓動後,能夠經過docker inspect查看這個環境變量,也能夠經過在docker run --env key=value時設置或修改環境變量。
假如你安裝了JAVA程序,須要設置JAVA_HOME,那麼能夠在Dockerfile中這樣寫:
ENV JAVA_HOME /path/to/java/dirent
構建指令,全部拷貝到container中的文件和文件夾權限爲0755,uid和gid爲0;若是是一個目錄,那麼會將該目錄下的全部文件添加到container中,不包括目錄;若是文件是可識別的壓縮格式,則docker會幫忙解壓縮(注意壓縮格式);若是<src>是文件且<dest>中不使用斜槓結束,則會將<dest>視爲文件,<src>的內容會寫入<dest>;若是<src>是文件且<dest>中使用斜槓結束,則會<src>文件拷貝到<dest>目錄下。
格式:
[plain] view plaincopy
ADD <src> <dest>
<src> 是相對被構建的源目錄的相對路徑,能夠是文件或目錄的路徑,也能夠是一個遠程的文件url;
<dest> 是container中的絕對路徑
設置指令,使容器中的一個目錄具備持久化存儲數據的功能,該目錄能夠被容器自己使用,也能夠共享給其餘容器使用。咱們知道容器使用的是AUFS,這種文件系統不能持久化數據,當容器關閉後,全部的更改都會丟失。當容器中的應用有持久化數據的需求時能夠在Dockerfile中使用該指令。
格式:
[plain] view plaincopy
VOLUME ["<mountpoint>"]
[plain] view plaincopy
FROM base
VOLUME ["/tmp/data"]
運行經過該Dockerfile生成p_w_picpath的容器,/tmp/data目錄中的數據在容器關閉後,裏面的數據還存在。例如另外一個容器也有持久化數據的需求,且想使用上面容器共享的/tmp/data目錄,那麼能夠運行下面的命令啓動一個容器:
[plain] view plaincopy
docker run -t -i -rm -volumes-from container1 p_w_picpath2 bash
container1爲第一個容器的ID,p_w_picpath2爲第二個容器運行p_w_picpath的名字。
設置指令,能夠屢次切換(至關於cd命令),對RUN,CMD,ENTRYPOINT生效。
格式:
[plain] view plaincopy
WORKDIR /path/to/workdir
[plain] view plaincopy
# 在 /p1/p2 下執行 vim a.txt
WORKDIR /p1 WORKDIR p2 RUN vim a.txt
[plain] view plaincopy
ONBUILD <Dockerfile關鍵字>
ONBUILD 指定的命令在構建鏡像時並不執行,而是在它的子鏡像中執行。
詳細資料可參考https://www.dockboard.org/docker-quicktip-3-onbuild
Dockerfile文件
# cd /app/zpy/docker/
# vim Dockerfile
# VERSION 0.0.1
FROM registry.cn-hangzhou.aliyuncs.com/acs-sample/centos
# 簽名
MAINTAINER Jo
# 更新源,安裝ssh server
RUN yum -y update
RUN yum clean all
RUN yum list
RUN yum install -y openssh-server
RUN mkdir -p /var/run/sshd
# 設置root ssh遠程登陸密碼爲123456
RUN echo "1qaz@WSX?" | passwd --stdin root
# 安裝vim,wget,curl,java,tomcat等必備軟件
RUN yum -y update
RUN yum install -y vim wget curl
RUN mkdir -p /app/zpy
RUN mkdir -p /app/zpy/3rd
RUN cd /tmp
RUN wget http://10.0.70.243/jdk-8u51-linux-x64.tar.gz
RUN wget http://10.0.70.243/apache-tomcat-6.0.41.tar.gz
RUN tar zxvf jdk-8u51-linux-x64.tar.gz -C /app/zpy/
RUN tar zxvf apache-tomcat-6.0.41.tar.gz -C /app/zpy/
RUN mv /app/zpy/apache-tomcat-6.0.41 /app/zpy/tomcat_its
RUN echo "JAVA_HOME=/app/zpy/jdk1.8.0_51" >> /etc/profile
RUN echo "JAVA_BIN=/app/zpy/jdk1.8.0_51/bin" >> /etc/profile
RUN echo "PATH=$PATH:$JAVA_BIN" >> /etc/profile
RUN echo "CLASSPATH=$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar" >> /etc/profile
RUN echo "export MAVEN_HOME JENKINS_HOME JAVA_HOME JAVA_BIN PATH CLASSPATH" >> /etc/profile
RUN source /etc/profile
ENV JAVA_HOME /app/zpy/jdk1.8.0_51
ENV JAVA_BIN /app/zpy/jdk1.8.0_51/bin
# 容器須要開放SSH 22端口
EXPOSE 22
# 容器須要開放Tomcat 8080端口
EXPOSE 8080
# 設置Tomcat初始化運行,SSH終端服務器做爲後臺運行
ENTRYPOINT sh /app/zpy/tomcat_its/bin/startup.sh && tail -f /app/zpy/tomcat_its/logs/catalina.out
+++++++++++++++++++++++++++++++++++++++++++++
須要注意:
ENTRYPOINT,表示鏡像在初始化時須要執行的命令,不可被重寫覆蓋,需謹記
CMD,表示鏡像運行默認參數,可被重寫覆蓋
ENTRYPOINT/CMD都只能在文件中存在一次,而且最後一個生效 多個存在,只有最後一個生效,其它無效!
須要初始化運行多個命令,彼此之間可使用 && 隔開,但最後一個需要爲無限運行的命令,需切記!
ENTRYPOINT/CMD,通常二者能夠配合使用,好比:
ENTRYPOINT ["/usr/sbin/sshd"] CMD ["-D"]
在Docker daemon模式下,不管你是使用ENTRYPOINT,仍是CMD,最後的命令,必定要是當前進程須要一直運行的,纔可以防容器退出。
如下無效方式:
ENTRYPOINT service tomcat7 start #運行幾秒鐘以後,容器就會退出 CMD service tomcat7 start #運行幾秒鐘以後,容器就會退出
這樣有效:
ENTRYPOINT service tomcat7 start && tail -f /var/lib/tomcat7/logs/catalina.out # 或者 CMD service tomcat7 start && tail -f /var/lib/tomcat7/logs/catalina.out
這樣也有效:
ENTRYPOINT ["/usr/sbin/sshd"] CMD ["-D"]
腳本寫好了,須要轉換成鏡像:
# docker build -t centos/javaweb .
-t: 爲構建的鏡像制定一個標籤,便於記憶/索引等
. : 指定Dockerfile文件在當前目錄下
# docker p_w_picpaths
REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE
centos/javaweb latest f1ee20338304 About an hour ago 1.246 GB
啓動鏡像
# docker run -d -p 58081:8080 f1ee20338304
# docker ps
可查看到進程
經過瀏覽器登陸驗證 http://10.0.70.243:58081