本文原創,原文地址為:http://www.cnblogs.com/fengzheng/p/5181222.html 創建鏡像的目的 首先說DockerHub或其它一些鏡像倉庫已經提供了夠多的鏡像,有最小版本,也有一些安裝了mysql、nginx、apache等等第三方軟體的版本可以直接拿來使用。雖
本文原創,原文地址為:http://www.cnblogs.com/fengzheng/p/5181222.html
創建鏡像的目的
首先說DockerHub或其它一些鏡像倉庫已經提供了夠多的鏡像,有最小版本,也有一些安裝了mysql、nginx、apache等等第三方軟體的版本可以直接拿來使用。雖然已經足夠多了,但是有些情況下並不能滿足我們的需求,例如需要安裝一些比較少用到的第三方軟體,這個時候只能先用公共倉庫中的鏡像,啟動容器,然後在容器中按照我們的需求安裝軟體,修改配置等等操作,之後提交鏡像。這些操作在之前的文章中介紹了。這樣操作完成之後,可以用如下兩種方式實現定製鏡像的目的:
1.用save和export的方式將鏡像保存為tar包,然後在需要的時候導入tar鏡像包
2.將已經配置好的鏡像push到我們的私有倉庫(docker創建私有倉庫)或者已註冊過的共有倉庫中,需要的時候直接pull下來使用
這兩種方式都可以,但是自動化程度低、自由度不夠、定製起來比較麻煩。既然如此,那就來說一下更加自動化的創建方式。
Dockerfile結構
dockerfile由4部分信息組成:基礎鏡像信息、維護者信息、鏡像操作指令和容器啟動時執行指令。
# This dockerfile uses the ubuntu image # VERSION 2 - EDITION 1 # Author: docker_user # Command format: Instruction [arguments / command] .. # Base image to use, this must be set as the first line FROM ubuntu # Maintainer: docker_user <docker_user at email.com> (@docker_user) MAINTAINER docker_user [email protected] # Commands to update the image RUN echo "deb http://archive.ubuntu.com/ubuntu/ raring main universe" >> /etc/apt/sources.list RUN apt-get update && apt-get install -y nginx RUN echo "\ndaemon off;" >> /etc/nginx/nginx.conf # Commands when creating a new container CMD /usr/sbin/nginx
其中#表註釋,可以標註一些說明性的文字。
FROM關鍵字指定鏡像的來源,預設為DockerHub,也可以寫私有倉庫的鏡像,例如:localhost:5000/centos:6.7,如果本地已經存在指定的鏡像名稱,則會從本地緩存直接獲取。MAINTAINER 指定鏡像的作者,之後為鏡像操作執行RUN、ADD等,最後是容器啟動時發起的指令。
Dockerfile中的指令
FROM: 指定鏡像名稱,格式為FROM <image> 或FROM <image>:<tag>,例如FROM ubuntu 或 FROM ubuntu:12.04
MAINTAINER: 鏡像作者 ,格式為 MAINTAINER <name>
RUN:格式為 RUN <command>
或 RUN ["executable", "param1", "param2"]
。
前者將在 shell 終端中運行命令,即 /bin/sh -c
;後者則使用 exec
執行。指定使用其它終端可以通過第二種方式實現,例如 RUN ["/bin/bash", "-c", "echo hello"]
。
每條 RUN
指令將在當前鏡像基礎上執行指定命令,並提交為新的鏡像。當命令較長時可以使用 \
來換行。
CMD:支持三種格式
1.CMD ["executable","param1","param2"] 使用 exec 執行,推薦方式;
2.CMD command param1 param2 在 /bin/sh 中執行,提供給需要交互的應用;
3.CMD ["param1","param2"] 提供給 ENTRYPOINT 的預設參數;
指定啟動容器時執行的命令,每個 Dockerfile 只能有一條 CMD 命令。如果指定了多條命令,只有最後一條會被執行。如果用戶啟動容器時候指定了運行的命令,則會覆蓋掉 CMD 指定的命令。
EXPOSE:格式為 EXPOSE <port> [<port>...]
。
告訴 Docker 服務端容器暴露的埠號,供互聯繫統使用。在啟動容器時需要通過 -P,Docker 主機會自動分配一個埠轉發到指定的埠。
ENV:格式為 ENV <key> <value>
。 指定一個環境變數,會被後續 RUN
指令使用,併在容器運行時保持。這就對應程式語言中的變數定義,可在需要的時候引用。例如:
ENV PG_MAJOR 9.3 ENV PG_VERSION 9.3.4 RUN curl -SL http://example.com/postgres-$PG_VERSION.tar.xz | tar -xJC /usr/src/postgress && … ENV PATH /usr/local/postgres-$PG_MAJOR/bin:$PATH
ADD:格式為 ADD <src> <dest>
。
該命令將複製指定的 <src>
到容器中的 <dest>
。 其中 <src>
可以是Dockerfile所在目錄的一個相對路徑;也可以是一個 URL;還可以是一個 tar 文件(自動解壓為目錄)。
COPY:格式為 COPY <src> <dest>
。
複製本地主機的 <src>
(為 Dockerfile 所在目錄的相對路徑)到容器中的 <dest>
。當使用本地目錄為源目錄時,推薦使用 COPY
。
COPY和ADD的不同就是:ADD多了自動解壓和支持URL路徑的功能。
ENTRYPOINT:
兩種格式:
ENTRYPOINT ["executable", "param1", "param2"]
ENTRYPOINT command param1 param2
(shell中執行)。
配置容器啟動後執行的命令,並且不可被 docker run
提供的參數覆蓋。
每個 Dockerfile 中只能有一個 ENTRYPOINT
,當指定多個時,只有最後一個起效。
CMD和ENTRYPOINT比較:兩個命令都是只能使用一次,並且都是在執行docker run指令時運行,如果有多個,只執行最後一條。
兩者的不同在於參數的傳遞方式,如果在Dockerfile中定義如下指令
CMD echo hello
或
ENTRYPOINT ["echo","hello"]
那麼在運行命令docker run containerId echo hello時,指定了CMD的輸入結果為world,可以看出Dockerfile中指定的命令被覆蓋了,而指定了ENTRYPOINT時,輸出結果為hello echo world,可以看出指定的命令被作為ENTRYPOINT指定指令的參數了。
VOLUME:格式為 VOLUME ["/data"]
。創建一個可以從本地主機或其他容器掛載的掛載點,一般用來存放資料庫和需要保持的數據等。不過此屬性在Dockerfile中指定並沒有什麼意義,因為沒有辦法指定本地主機的目錄。如果需要指定掛載點可以在執行docker run命令時指定:
docker run -it -v /home/fengzheng/ftp/:/data 859666d51c6d /bin/bash
USER:格式為 USER daemon
。指定運行容器時的用戶名或 UID,後續的 RUN
也會使用指定用戶。
當服務不需要管理員許可權時,可以通過該命令指定運行用戶。並且可以在之前創建所需要的用戶,例如:RUN groupadd -r postgres && useradd -r -g postgres postgres
。要臨時獲取管理員許可權可以使用 gosu
,而不推薦 sudo
。
WORKDIR:格式為 WORKDIR /path/to/workdir
。為後續的 RUN
、CMD
、ENTRYPOINT
指令配置工作目錄。可以使用多個 WORKDIR
指令,後續命令如果參數是相對路徑,則會基於之前命令指定的路徑。例如
WORKDIR /a WORKDIR b WORKDIR c RUN pwd
則最終路徑為 /a/b/c
。
ONBUILD:格式為 ONBUILD [INSTRUCTION]
。
配置當所創建的鏡像作為其它新創建鏡像的基礎鏡像時,所執行的操作指令。
例如,Dockerfile 使用如下的內容創建了鏡像 image-A
。
[...] ONBUILD ADD . /app/src ONBUILD RUN /usr/local/bin/python-build --dir /app/src [...]
如果基於 image-A 創建新的鏡像時,新的Dockerfile中使用 FROM image-A
指定基礎鏡像時,會自動執行ONBUILD
指令內容,等價於在後面添加了兩條指令。
FROM image-A #Automatically run the following ADD . /app/src RUN /usr/local/bin/python-build --dir /app/src
使用 ONBUILD
指令的鏡像,推薦在標簽中註明,例如 ruby:1.9-onbuild
。
基於CentOS6.7並源碼安裝nginx
首先準備了nginx-1.9.9.tar.gz安裝包和CentOS6-Base-163.repo(163源),將這兩個文件放到同一目錄下,併在此目錄下創建名稱為Dockerfile的文件。之後在此文件中實現源替換、nginx編譯安裝、及一些依賴包的安裝,Dockerfile內容如下:
# this is a test ubuntu 12.04 image dockerfile # Author:fengzheng # Base image,this must be set as the first line #localhost:5000/centos:6.7是我的私有倉庫的鏡像,可替換為centos:6.7(DockerHub中的鏡像) FROM localhost:5000/centos:6.7 MAINTAINER fengzheng # Commands to update the image RUN mkdir /usr/nginx1.9.9 ADD nginx-1.9.9.tar.gz /usr/nginx1.9.9/ #RUN yum -y install tar #RUN tar -zxvf /usr/nginx1.9.9/nginx-1.9.9.tar.gz RUN cd /etc/yum.repos.d/ && mv CentOS-Base.repo CentOS-Base.repo.bak ADD CentOS6-Base-163.repo /etc/yum.repos.d/ RUN cd /etc/yum.repos.d/ && mv CentOS6-Base-163.repo CentOS-Base.repo \ && yum clean all && yum makecache \ && yum -y install gcc \ && yum -y install yum install -y pcre-devel \ && yum -y install zlib zlib-devel \ && yum -y install openssl openssl--devel \ && cd /usr/nginx1.9.9/nginx-1.9.9/ && ./configure && make && make install #如果設置daemon off; nginx無法啟動 #RUN echo "\ndaemon off;" >> /etc/nginx/nginx.conf # Commands when creating a new container # 啟動nginx 需進入/usr/local/nginx/sbin 執行./configure CMD /bin/bash
最後執行命令"docker build -t nginx-centos:6.7 ."
其中.表示在當前目錄下搜索Dockerfile文件,-t參數指定鏡像名稱和tag。