dockerfile基礎命令

一直想寫一個, 但發現網上有很多了, 直接copy把

如何使用

Dockerfile用來創建一個自定義的image,包含了用戶指定的軟件依賴等。當前目錄下包含Dockerfile,使用命令build來創建新的image,並命名為edwardsbean/centos6-jdk1.7:

docker build -t edwardsbean/centos6-jdk1.7 .

Dockerfile關鍵字

如何編寫一個Dockerfile,格式如下：

# CommentINSTRUCTION arguments

FROM

基於哪個鏡像

RUN

安裝軟件用

MAINTAINER

鏡像創建者

 

COPY

 

 

格式為 COPY <src> <dest> 。

復制本地主機的 <src> （為Dockerfile所在目錄的相對路徑）到容器中的 <dest>

從上面的定義中可獲知，src可以是Dockerfile所在目錄的一個相對路徑，但在實際操作中，只有與Dockerfile文件在同一目錄的文件或目錄可以成功的使用ADD <src> <dest>，如：（ADD ./test /data/code/nginx）

如果文件或目錄不與Dockerfile在同一目錄會提示 no such file or directory，如：（ADD ../test2 /data/code/nginx），從Dockerfile所在目錄通過 cd ../test2可以到達test2

 

CMD

Container啟動時執行的命令，但是一個Dockerfile中只能有一條CMD命令，多條則只執行最后一條CMD.

CMD主要用於container時啟動指定的服務，當Docker run command的命令匹配到CMD command時，會替換CMD執行的命令。如:
Dockerfile:

CMD echo hello world

運行一下試試:

edwardsbean@ed-pc:~/software/docker-image/centos-add-test$ docker run centos-cmd
hello world

一旦命令匹配：

edwardsbean@ed-pc:~/software/docker-image/centos-add-test$ docker run centos-cmd echo hello edwardsbean
hello edwardsbean

ENTRYPOINT

container啟動時執行的命令，但是一個Dockerfile中只能有一條ENTRYPOINT命令，如果多條，則只執行最后一條

ENTRYPOINT沒有CMD的可替換特性

USER

使用哪個用戶跑container
如：

ENTRYPOINT ["memcached"]
USER daemon

EXPOSE

container內部服務開啟的端口。主機上要用還得在啟動container時，做host-container的端口映射：

docker run -d -p 127.0.0.1:33301:22 centos6-ssh

container ssh服務的22端口被映射到主機的33301端口

ENV

用來設置環境變量，比如：

ENV LANG en_US.UTF-8 ENV LC_ALL en_US.UTF-8

ADD

 

格式為 ADD <src> <dest> 。

該命令將復制指定的 <src> 到容器中的 <dest> 。 其中 <src> 可以是Dockerfile所在目錄的一個相對路徑；也可以是一個URL；還可以是一個tar文件（自動解壓為目錄）。

所有拷貝到container中的文件和文件夾權限為0755,uid和gid為0
如果文件是可識別的壓縮格式，則docker會幫忙解壓縮

• 如果要ADD本地文件，則本地文件必須在 docker build <PATH>，指定的<PATH>目錄下

• 如果要ADD遠程文件，則遠程文件必須在 docker build <PATH>，指定的<PATH>目錄下。比如:

  docker build github.com/creack/docker-firefox

  docker-firefox目錄下必須有Dockerfile和要ADD的文件

注意:使用docker build - < somefile方式進行build，是不能直接將本地文件ADD到container中。只能ADD url file.

ADD只有在build鏡像的時候運行一次，后面運行container的時候不會再重新加載了。

VOLUME

可以將本地文件夾或者其他container的文件夾掛載到container中。

WORKDIR

切換目錄用，可以多次切換(相當於cd命令)，對RUN,CMD,ENTRYPOINT生效

ONBUILD

ONBUILD 指定的命令在構建鏡像時並不執行，而是在它的子鏡像中執行

 

轉載自: http://blog.csdn.net/huangjin0507/article/details/51162460

 

Dockfile是一種被Docker程序解釋的腳本，Dockerfile由一條一條的指令組成，每條指令對應Linux下面的一條命令。Docker程序將這些Dockerfile指令翻譯真正的Linux命令。Dockerfile有自己書寫格式和支持的命令，Docker程序解決這些命令間的依賴關系，類似於Makefile。Docker程序將讀取Dockerfile，根據指令生成定制的image。相比image這種黑盒子，Dockerfile這種顯而易見的腳本更容易被使用者接受，它明確的表明image是怎么產生的。有了Dockerfile，當我們需要定制自己額外的需求時，只需在Dockerfile上添加或者修改指令，重新生成image即可，省去了敲命令的麻煩。

 

1. Dockerfile的書寫規則及指令使用方法

 

Dockerfile的指令是忽略大小寫的，建議使用大寫，使用 # 作為注釋，每一行只支持一條指令，每條指令可以攜帶多個參數。
Dockerfile的指令根據作用可以分為兩種，構建指令和設置指令。構建指令用於構建image，其指定的操作不會在運行image的容器上執行；設置指令用於設置image的屬性，其指定的操作將在運行image的容器中執行。

（1）FROM（指定基礎image）

構建指令，必須指定且需要在Dockerfile其他指令的前面。后續的指令都依賴於該指令指定的image。FROM指令指定的基礎image可以是官方遠程倉庫中的，也可以位於本地倉庫。
該指令有兩種格式：

FROM <image>

指定基礎image為該image的最后修改的版本。或者：

FROM <image>:<tag>

指定基礎image為該image的一個tag版本。

（2）MAINTAINER（用來指定鏡像創建者信息）

構建指令，用於將image的制作者相關的信息寫入到image中。當我們對該image執行docker inspect命令時，輸出中有相應的字段記錄該信息。
格式：

MAINTAINER <name>

（3）RUN（安裝軟件用）

構建指令，RUN可以運行任何被基礎image支持的命令。如基礎image選擇了ubuntu，那么軟件管理部分只能使用ubuntu的命令。
該指令有兩種格式：

RUN <command> (the command is run in a shell - `/bin/sh -c`)
RUN ["executable", "param1", "param2" ... ]  (exec form)

（4）CMD（設置container啟動時執行的操作）

設置指令，用於container啟動時指定的操作。該操作可以是執行自定義腳本，也可以是執行系統命令。該指令只能在文件中存在一次，如果有多個，則只執行最后一條。
該指令有三種格式：

CMD ["executable","param1","param2"] (like an exec, this is the preferred form)
CMD command param1 param2 (as a shell)

當Dockerfile指定了ENTRYPOINT，那么使用下面的格式：

CMD ["param1","param2"] (as default parameters to ENTRYPOINT)

ENTRYPOINT指定的是一個可執行的腳本或者程序的路徑，該指定的腳本或者程序將會以param1和param2作為參數執行。所以如果CMD指令使用上面的形式，那么Dockerfile中必須要有配套的ENTRYPOINT。

（5）ENTRYPOINT（設置container啟動時執行的操作）

設置指令，指定容器啟動時執行的命令，可以多次設置，但是只有最后一個有效。
兩種格式:

ENTRYPOINT ["executable", "param1", "param2"] (like an exec, the preferred form)
ENTRYPOINT command param1 param2 (as a shell)

該指令的使用分為兩種情況，一種是獨自使用，另一種和CMD指令配合使用。
當獨自使用時，如果你還使用了CMD命令且CMD是一個完整的可執行的命令，那么CMD指令和ENTRYPOINT會互相覆蓋只有最后一個CMD或者ENTRYPOINT有效。

# CMD指令將不會被執行，只有ENTRYPOINT指令被執行
CMD echo “Hello, World!”
ENTRYPOINT ls -l

另一種用法和CMD指令配合使用來指定ENTRYPOINT的默認參數，這時CMD指令不是一個完整的可執行命令，僅僅是參數部分；ENTRYPOINT指令只能使用JSON方式指定執行命令，而不能指定參數。

FROM ubuntu
CMD ["-l"]
ENTRYPOINT ["/usr/bin/ls"]

（6）USER（設置container容器的用戶）

設置指令，設置啟動容器的用戶，默認是root用戶。

# 指定memcached的運行用戶
ENTRYPOINT ["memcached"]
USER daemon
或
ENTRYPOINT ["memcached", "-u", "daemon"]

（7）EXPOSE（指定容器需要映射到宿主機器的端口）

設置指令，該指令會將容器中的端口映射成宿主機器中的某個端口。當你需要訪問容器的時候，可以不是用容器的IP地址而是使用宿主機器的IP地址和映射后的端口。要完成整個操作需要兩個步驟，首先在Dockerfile使用EXPOSE設置需要映射的容器端口，然后在運行容器的時候指定-p選項加上EXPOSE設置的端口，這樣EXPOSE設置的端口號會被隨機映射成宿主機器中的一個端口號。也可以指定需要映射到宿主機器的那個端口，這時要確保宿主機器上的端口號沒有被使用。EXPOSE指令可以一次設置多個端口號，相應的運行容器的時候，可以配套的多次使用-p選項。
格式:

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

 

# 映射一個端口
EXPOSE port1
# 相應的運行容器使用的命令
docker run -p port1 image

# 映射多個端口
EXPOSE port1 port2 port3
# 相應的運行容器使用的命令
docker run -p port1 -p port2 -p port3 image
# 還可以指定需要映射到宿主機器上的某個端口號
docker run -p host_port1:port1 -p host_port2:port2 -p host_port3:port3 image

端口映射是docker比較重要的一個功能，原因在於我們每次運行容器的時候容器的IP地址不能指定而是在橋接網卡的地址范圍內隨機生成的。宿主機器的IP地址是固定的，我們可以將容器的端口的映射到宿主機器上的一個端口，免去每次訪問容器中的某個服務時都要查看容器的IP的地址。對於一個運行的容器，可以使用docker port加上容器中需要映射的端口和容器的ID來查看該端口號在宿主機器上的映射端口。

（8）ENV（用於設置環境變量）

構建指令，在image中設置一個環境變量。
格式:

ENV <key> <value>

設置了后，后續的RUN命令都可以使用，container啟動后，可以通過docker inspect查看這個環境變量，也可以通過在docker run --env key=value時設置或修改環境變量。
假如你安裝了JAVA程序，需要設置JAVA_HOME，那么可以在Dockerfile中這樣寫：
ENV JAVA_HOME /path/to/java/dirent

（9）ADD（從src復制文件到container的dest路徑）

構建指令，所有拷貝到container中的文件和文件夾權限為0755，uid和gid為0；如果是一個目錄，那么會將該目錄下的所有文件添加到container中，不包括目錄；如果文件是可識別的壓縮格式，則docker會幫忙解壓縮（注意壓縮格式）；如果<src>是文件且<dest>中不使用斜杠結束，則會將<dest>視為文件，<src>的內容會寫入<dest>；如果<src>是文件且<dest>中使用斜杠結束，則會<src>文件拷貝到<dest>目錄下。
格式:

ADD <src> <dest>

<src> 是相對被構建的源目錄的相對路徑，可以是文件或目錄的路徑，也可以是一個遠程的文件url;
<dest> 是container中的絕對路徑

（10）VOLUME（指定掛載點)）

設置指令，使容器中的一個目錄具有持久化存儲數據的功能，該目錄可以被容器本身使用，也可以共享給其他容器使用。我們知道容器使用的是AUFS，這種文件系統不能持久化數據，當容器關閉后，所有的更改都會丟失。當容器中的應用有持久化數據的需求時可以在Dockerfile中使用該指令。
格式:

VOLUME ["<mountpoint>"]

 

FROM base
VOLUME ["/tmp/data"]

運行通過該Dockerfile生成image的容器，/tmp/data目錄中的數據在容器關閉后，里面的數據還存在。例如另一個容器也有持久化數據的需求，且想使用上面容器共享的/tmp/data目錄，那么可以運行下面的命令啟動一個容器：

docker run -t -i -rm -volumes-from container1 image2 bash

container1為第一個容器的ID，image2為第二個容器運行image的名字。

（11）WORKDIR（切換目錄）

設置指令，可以多次切換(相當於cd命令)，對RUN,CMD,ENTRYPOINT生效。
格式:

WORKDIR /path/to/workdir

 

# 在 /p1/p2 下執行 vim a.txt
WORKDIR /p1 WORKDIR p2 RUN vim a.txt

（12）ONBUILD（在子鏡像中執行）

ONBUILD <Dockerfile關鍵字>

ONBUILD 指定的命令在構建鏡像時並不執行，而是在它的子鏡像中執行。
詳細資料可參考https://www.dockboard.org/docker-quicktip-3-onbuild

 

2. 創建Dockerfile，構建jdk+tomcat環境

 

Dockerfile文件

 

# Pull base image
FROM ubuntu:13.10

MAINTAINER zing wang "[e-mail]"

# update source
RUN echo "deb http://archive.ubuntu.com/ubuntu precise main universe"> /etc/apt/sources.list
RUN apt-get update

# Install curl
RUN apt-get -y install curl

# Install JDK 7
RUN cd /tmp &&  curl -L 'http://download.oracle.com/otn-pub/java/jdk/7u65-b17/jdk-7u65-linux-x64.tar.gz' -H 'Cookie: oraclelicense=accept-securebackup-cookie; gpw_e24=Dockerfile' | tar -xz
RUN mkdir -p /usr/lib/jvm
RUN mv /tmp/jdk1.7.0_65/ /usr/lib/jvm/java-7-oracle/

# Set Oracle JDK 7 as default Java
RUN update-alternatives --install /usr/bin/java java /usr/lib/jvm/java-7-oracle/bin/java 300
RUN update-alternatives --install /usr/bin/javac javac /usr/lib/jvm/java-7-oracle/bin/javac 300

ENV JAVA_HOME /usr/lib/jvm/java-7-oracle/

# Install tomcat7
RUN cd /tmp && curl -L 'http://archive.apache.org/dist/tomcat/tomcat-7/v7.0.8/bin/apache-tomcat-7.0.8.tar.gz' | tar -xz
RUN mv /tmp/apache-tomcat-7.0.8/ /opt/tomcat7/

ENV CATALINA_HOME /opt/tomcat7
ENV PATH $PATH:$CATALINA_HOME/bin

ADD tomcat7.sh /etc/init.d/tomcat7
RUN chmod 755 /etc/init.d/tomcat7

# Expose ports.
EXPOSE 8080

# Define default command.
ENTRYPOINT service tomcat7 start && tail -f /opt/tomcat7/logs/catalina.out

 

tomcat7.sh

 

export JAVA_HOME=/usr/lib/jvm/java-7-oracle/
export TOMCAT_HOME=/opt/tomcat7

case $1 in
start)
  sh $TOMCAT_HOME/bin/startup.sh
;;
stop)
  sh $TOMCAT_HOME/bin/shutdown.sh
;;
restart)
  sh $TOMCAT_HOME/bin/shutdown.sh
  sh $TOMCAT_HOME/bin/startup.sh
;;
esac
exit 0

 

我已經把這些文件上傳到了Github https://github.com/agileshell/dockerfile-jdk-tomcat.git

 

3. 構建鏡像

腳本寫好了，需要轉換成鏡像：

 

 

docker build -t zingdocker/jdk-tomcat .
docker run -d -p 8090:8080 zingdocker/jdk-tomcat

 

默認情況下，tomcat會占用8080端口，剛才在啟動container的時候，指定了 -p 8090:8080，映射到宿主機端口就是8090。

http://<host>:8090 host為主機IP

 

參考
Docker - Reference - Dockerfile http://docs.docker.com/reference/builder/
http://www.blogjava.net/yongboy/archive/2013/12/16/407643.html
一些例子
http://dockerfile.github.io/
https://github.com/Toub/toub-docker-tomcat8-java8-auto-deploy
https://github.com/eugeneware/docker-wordpress-nginx
https://github.com/gemnasium/rails-meets-docker

 

轉載自: http://blog.csdn.NET/we_shell/article/details/38445979