第四篇 : Docker 構建映象
構建Docker映象有以下兩種方法:
- 使用docker commit命令,從容器建立一個新的映象。
- 使用docker build命令和 Dockerfile 檔案。
一、通過commit命令建立映象
語法
docker commit 容器ID:tag
OPTIONS說明:
-
-a :提交的映象作者;
-
-c :使用Dockerfile指令來建立映象;
-
-m :提交時的說明文字;
-
-p :在commit時,將容器暫停。
例項
我們獲取一nginx的映象,修改nginx的歡迎頁面,之後重新構建成新映象。
#下載映象
docker pull nginx
#執行映象
docker run -it -d -p 81:80 --name mynginx nginx
我們訪問127.0.0.1:81 如下:
下載我們來修改nginx的歡迎頁
#進入容器
docker exec -it mynginx /bin/bash
#更新源
apt-get update
#安裝vim
apt-get install -y vim
#修改歡迎頁的title為 "Welcome to nginx , ha ha ha!"
我們重新整理訪問127.0.0.1:81如下:
那麼現在修改把修改過的容器,重新構件成新的映象。
docker commit -a "程式設計師果果" -m "my nginx" mynginx:v1
之後,我們檢視下本地映象列表,可以發現已經存在我們構件的新映象。
二、通過 Dockerfile 建立映象
我們先看個Dockerfile檔案例項:
# Version: 0.0.1
FROM ubuntu:latest
MAINTAINER gf "[email protected]"
RUN apt-get update
RUN apt-get install -y nginx
RUN echo 'Hi, I am in your container' > /usr/share/nginx/html/index.html
EXPOSE 80
構建
docker build -f /path/Dockerfile
Dockerfile由一系列指令和引數組成。每條指令都必須為大寫字母,切後面要跟隨一個引數。Dockerfile中的指令會按照順序從上到下執行,所以應該根據需要合理安排指令的順序。每條指令都會建立一個新的映象層並對映象進行提交。Docker大體上按照如下流程執行Dockerfile中的指令。
Dockerfile構建構過程:
- 從基礎映象執行一個容器
- 執行一條指令,對容器做出修改
- 執行類似docker commit 的操作,提交一個新的映象層
- 再基於剛提交的映象執行一個新容器
- 執行Dockerfile中的下一條指令,直至所有指令執行完畢
從上面可以看出,如果你的Dockerfile由於某些原因(如某條指令失敗了)沒有正常結束,那你也可以得到一個可以使用的映象。這對除錯非常有幫助:可以基於該映象執行一個具備互動功能的容器,使用最後建立的映象對為什麼你的指令會失敗進行除錯。
Dockerfile也支援註釋。以#開頭的行都會被認為是註釋,# Version: 0.0.1這就是個註釋。
Dockerfile指令
1. FROM
指定基礎映象,必須為第一個命令。
格式:
FROM <image>
FROM <image>:<tag>
FROM <image>@<digest>
示例:
FROM mysql:5.6
注:
tag或digest是可選的,如果不使用這兩個值時,會使用latest版本的基礎映象
2. MAINTAINER
維護者資訊
格式:
MAINTAINER <name>
示例:
MAINTAINER san zhang
MAINTAINER [email protected]
MAINTAINER zs<[email protected]>
3. RUN
構建映象時執行的命令。
RUN用於在映象容器中執行命令,其有以下兩種命令執行方式:
格式:
用法1(shell模式) RUN <command>
用法1(exec模式) RUN ["executable", "param1", "param2"]
示例:
RUN ["executable", "param1", "param2"]
RUN apk update
RUN ["/etc/execfile", "arg1", "arg1"]
注:
RUN指令建立的中間映象會被快取,並會在下次構建中使用。如果不想使用這些快取映象,可以在構建時指定--no-cache引數,如:docker build --no-cache
4. ADD
將本地檔案新增到容器中,tar型別檔案會自動解壓,可以訪問網路資源,類似wget。
格式:
ADD <src>... <dest>
ADD ["<src>",... "<dest>"] 用於支援包含空格的路徑
示例:
ADD hom* /mydir/ # 新增所有以"hom"開頭的檔案
ADD hom?.txt /mydir/ # ? 替代一個單字元,例如:"home.txt"
ADD test relativeDir/ # 新增 "test" 到 `WORKDIR`/relativeDir/
ADD test /absoluteDir/ # 新增 "test" 到 /absoluteDir/
5. COPY
功能類似ADD,但是不會自動解壓檔案,也不能訪問網路資源。
格式:
COPY <src>... <dest>
COPY ["<src>",... "<dest>"] 用於支援包含空格的路徑
示例:
COPY hom* /mydir/ # 新增所有以"hom"開頭的檔案
COPY hom?.txt /mydir/ # ? 替代一個單字元,例如:"home.txt"
COPY test relativeDir/ # 新增 "test" 到 `WORKDIR`/relativeDir/
COPY test /absoluteDir/ # 新增 "test" 到 /absoluteDir/
注:
如果單純複製檔案,Docker 推薦適用COPY
6. ENTRYPOINT
配置容器,使其可執行化。配合CMD可省去"application",只使用引數。
格式:
用法1(exec模式) ENTRYPOINT ["executable", "param1", "param2"]
用法2(shell模式) ENTRYPOINT command param1 param2
示例:
FROM ubuntu
ENTRYPOINT ["top", "-b"]
CMD ["-c"]
注:
ENTRYPOINT與CMD非常類似,不同的是通過docker run執行的命令不會覆蓋ENTRYPOINT,而docker run命令中指定的任何引數,都會被當做引數再次傳遞給ENTRYPOINT。Dockerfile中只允許有一個ENTRYPOINT命令,多指定時會覆蓋前面的設定,而只執行最後的ENTRYPOINT指令。
所以可以指定ENTERYPOINT和CMD組合使用 通過ENTERYPOINT指定命令,CMD指定命令的引數
7. CMD
指定容器執行時的命令。
格式:
用法1(exec模式) ENTERYPOINT ["executable" , "param1" , "param2"]
用法2(shell模式) ENTERYPOINT command param1 param2
示例:
CMD [ "sh", "-c", "echo $HOME" ]
8. EXPOSE
指定執行改映象的容器使用的埠。
格式:
EXPOSE <port> [<port>...]
示例:
EXPOSE 80 443
EXPOSE 8080
注:
但是docker 容器處於安全的考慮並不會開啟指定埠,而是需要在使用的時候 ,通過 -p 開啟
例如 $docker run -p 80 -d huanchupk/df_test1 nginx -g "daemon off"
9. ENV
設定環境變數。
格式:
ENV <key> <value>
ENV <key>=<value> ...
示例:
ENV myName gf
ENV myAddress shanghai
10. VOLUME
向容器中添加捲(指定持久化目錄)。
格式:
VOLUME ["/path/to/dir"]
示例:
VOLUME ["/data"]
VOLUME ["/var/www", "/var/log/apache2", "/etc/apache2"
注:
一個卷可以存在於一個或多個容器的指定目錄,該目錄可以繞過聯合檔案系統,並具有以下功能:
1. 卷可以容器間共享和重用
2. 容器並不一定要和其它容器共享卷
3. 修改卷後會立即生效
4. 對卷的修改不會對映象產生影響
5. 卷會一直存在,直到沒有任何容器在使用它
11. WORKDIR
從映象建立一個新容器時,在容器中設定工作目錄(類似於cd命令)。
格式:
WORKDIR /path/to/workdir
示例:
WORKDIR /a (這時工作目錄為/a)
WORKDIR b (這時工作目錄為/a/b)
WORKDIR c (這時工作目錄為/a/b/c)
注:
通過WORKDIR設定工作目錄後,Dockerfile中其後的命令RUN、CMD、ENTRYPOINT、ADD、COPY等命令都會在該目錄下執行。在使用docker run執行容器時,可以通過-w引數覆蓋構建時所設定的工作目錄。
12. USER
映象由什麼使用者執行,如果不指定預設以root使用者執行。
格式:
USER user
USER user:group
USER uid
USER uid:gid
USER user:gid
USER uid:group
示例:
USER www
注:
使用USER指定使用者後,Dockerfile中其後的命令RUN、CMD、ENTRYPOINT都將使用該使用者。映象構建完成後,通過docker run執行容器時,可以通過-u引數來覆蓋所指定的使用者。
13. ARG
用於指定傳遞給構建執行時的變數。
格式:
ARG <name>[=<default value>]
示例:
ARG site
ARG build_user=www
14. ONBUILD
用於設定映象觸發器。
格式:
ONBUILD [INSTRUCTION]
示例:
ONBUILD ADD . /app/src
ONBUILD RUN /usr/local/bin/python-build --dir /app/src
注:
當所構建的映象被用做其它映象的基礎映象,該映象中的觸發器將會被觸發
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"]
最後用一張圖解釋常用指令的意義:
參考資料: Dockerfile檔案詳解