docker——Dockerfile(一)
Dockerfile是一個文字格式的配置檔案,使用者可以使用Dockerfile來快速建立自定義的映象。
Dockerfile由一行行命令語句組成,並支援以#開頭的註釋行。
一般而言,Dockerfile分為四部分:基礎映象資訊、維護者資訊、映象操作指令和容器啟動時執行的命令。
一、Dockerfile指令說明:
下面是指令詳情:
1.FROM
說明:指定所建立映象的基礎映象,如果本地不存在,則預設會去Docker Hub下載指定映象。
格式:
FROM <image>
FROM <image>:<tag>
FROM <image>@<digest>
任何Dockerfile中的第一條指令必須為FROM指令
2.MAINTAINER
說明:指定維護者資訊
格式:
MAINTAINER <name>
該資訊會寫入生成映象的Author屬性域中。
3.RUN
說明:執行指定命令
格式:
RUN <command>
RUN ["executable","param1","param2"] (RUN ["可執行文字","引數1","引數2"]) 指令會被解析為Json陣列,因此必須用雙引號。
例項:
RUN echo hello
RUN ["/bin/bash","-c","echo hello"]
RUN <command> 預設會在shell終端中執行命令,即/bin/sh -c
RUN ["","",""] 使用exec執行,不會啟動shell環境
每條RUN指令將在當前映象的基礎上執行指定命令,並提交為新的映象。
當命令較長時,可以使用\來換行。
4.CMD
說明:指定啟動容器時預設執行的命令。
格式:
CMD ["executable","param1","param2"] 使用exec執行,推薦使用的方式
CMD command param1 param2 在/bin/sh中執行,提供給需要互動的應用
CMD ["param1","param2"] 提供給ENTRYPOINT的預設引數
每個Dockerfile只能有一條CMD命令,如果指定了多條命令,只有最後一條會被執行。
如果使用者啟動容器時,手動指定了執行的命令(作為run的引數),則會覆蓋掉CMD指定的命令。
5.LABEL
說明:用來指定生成映象的元資料標籤資訊
格式:
LABEL <key>=<value> <key>=<value> <key>=<value>...
例項:
LABEL version="1.0"
LABEL description="This is test_label"
6.EXPOSE
說明:宣告映象內服務所監聽的埠
格式:
EXPOSE <port> [<port> <port> ...]
例項:
EXPORT 22 80 443
注意,該指令只是起到宣告作用,並不會自動完成埠對映。
如果你要完成對映還是要在建立的時候使用-p/-P引數。
7.ENV
說明:指定環境變數,在映象的生成過程中會被後續RUN指令呼叫,在啟動的容器中也會存在。
格式:
ENV <key> <value>
ENV <key>=<value>
例項:
ENV PG_MAJOR 9.8.3
指令指定的環境變數在執行時可以被覆蓋。
8.ADD
說明:複製指定的<src>路徑下的內容到容器中的<dest>路徑下。
格式:
ADD <src> <dest>
例項:
ADD *.c /code/
其中<src>可以是Dockerfile所在目錄的一個相對路徑(檔案或目錄),也可以是一個URL,
還可以是一個tar檔案(如果是tar檔案會自動解壓到<dest>路徑下)。
<dest>可以是映象內的絕對路徑,或者相對於工作目錄(WORKDIR)的相對路徑。
9.COPY
說明:複製本地主機的<src>(Dockerfile所在目錄的相對路徑、檔案或目錄)下的內容到映象中的<dest>下,目標路徑不存在時,會自動建立。
格式:
COPY <src> <dest>
當使用本地目錄為源目錄時,推薦使用COPY
10.ENTRYPOINT
說明:指定映象的預設入口命令,該入口命令會在啟動容器時作為根命令執行,所以傳入值作為該命令的引數。
格式:
ENTRYPOINT ["executable","param1","param2"] exec呼叫執行
ENTRYPOINT command param1 param2 shell中執行
此時,CMD指令指定值將作為根命令的引數。
每個Dockerfile中只能有一個ENTRYPOINT,當指定多個時,只有最後一個有效。
在執行時,可以被 --entrypoint引數覆蓋掉。
11.VOLUME
說明:建立一個數據卷掛載點。
格式:
VOLUME ["/data"]
可以從本地主機或其他容器掛載資料卷,一般用來存放資料庫和需要儲存的資料等
12.USER
說明:指定執行容器時的使用者名稱或UID,後續的RUN等指令也會使用指定的使用者身份。
格式:
USER daemon
當服務不需要管理員許可權時,可以通過該命令指定執行使用者,並且可以在之前建立所需要的使用者。
RUN groupadd -r postgres && useradd -r -g postgress postgress
要零時獲取管理員許可權可以使用gosu或sudo
13.WORKDIR
說明:為後續的RUN、CMD和ENTRYPOINT指定配置的工作目錄。
格式:
WORKDIR /path/to/workdir
可以使用多個WORKDIR指令,後續命令如果引數是相對路徑,則會基於之前命令指定的路徑。
WORKDIR /a
WORKDIR b
WORKDIR c
則最終路徑為/a/b/c
14.ARG
說明:指定一些映象內使用的引數(例如版本號資訊),這些引數在執行docker build命令時才以--build-arg<varname>=<value>格式傳入。
格式:
ARG <name> [=<default value>]
15.ONBUILD
說明:配置當前所建立的映象作為其它映象的基礎映象時,所執行的建立操作指令。
格式:
ONBUILD [INSTRUCTION]
例如,Dockerfile使用如下類容建立的映象image-A
[...] ONBUILD ADD . /app/src [...]
如果基於映象image-A建立新的映象,那麼新的映象就會自動執行上面的ONBUILD指定的內容,類似於繼承的關係。
16.STOPSIGNAL
說明:指定所建立映象啟動的容器接收退出的訊號值。
例項:
STOPSIGNAL signal
17.HEALTHCHECK
說明:配置所啟動容器如何進行健康檢查(如何判斷健康與否)
格式:
HEALTHCHECK [OPTIONS] CMD command 根據所執行命令返回值是否為0來判斷
OPTION支援的選項:
--interval=DURATION(預設為:30s) 過多久檢查一次
--timeout=DURAION(預設為:30s) 每次檢查等待結果的超時
--retries=N(預設為:3) 如果失敗了,重試幾次才最終確定失敗
HEALTHCHECK NONE 禁止基礎映象中的健康檢查
18.SHELL
說明:指定其它命令使用shell時的預設shell型別。
例項:
SHELL ["executable","parameters"]
預設值為 ["/bin/sh","-c"]
二、建立映象
編寫完Dockerfile之後,可以通過docker build來建立映象。下面兩種寫法都是可行的
docker build -t centos_nginx:v1 /docker_demo
docker build -t centos_nginx:v1
如果沒有指定Dockerfile的路徑,那麼就會預設讀取當前目錄下(包括子目錄)的Dockerfile。
並將該路徑下的所有內容傳送給Docker服務端,由服務端來建立映象。
如果使用非內容路徑下的Dockerfile,可以使用-f選項來指定其路徑。
要指定生成映象的標籤資訊,可以使用-t選項。
建議放置Dockerfile的目錄為空目錄。
三、簡單應用
centos映象+nginx.tar
切換目錄:
cd /
建立工作路徑:
mkdir docker_demo
建立Dockerfile檔案:
touch Dockerfile
編輯檔案:
# base image FROM docker.io/centos # MAINTAINER MAINTAINER 467661568@qq.com # put nginx-1.9.0.tar.gz into /usr/local/src and unpack nginx #將當前目錄下的包複製到/usr/local/src目錄下 ADD nginx-1.9.0.tar.gz /usr/local/src # running required command #執行命令,安裝依賴包 RUN yum install -y gcc gcc-c++ glibc make autoconf openssl openssl-devel RUN yum install -y libxslt-devel -y gd gd-devel GeoIP GeoIP-devel pcre pcre-devel RUN useradd -M -s /sbin/nologin nginx # change dir to /usr/local/src/nginx-1.9.0 #指定工作路徑 WORKDIR /usr/local/src/nginx-1.9.0 # execute command to compile nginx #安裝軟體包 RUN ./configure --user=nginx --group=nginx --prefix=/usr/local/nginx --with-file-aio --with-http_ssl_module --with-http_realip_module --with-http_addition_module --with-http_xslt_module --with-http_image_filter_module --with-http_geoip_module --with-http_sub_module --with-http_dav_module --with-http_flv_module --with-http_mp4_module --with-http_gunzip_module --with-http_gzip_static_module --with-http_auth_request_module --with-http_random_index_module --with-http_secure_link_module --with-http_degradation_module --with-http_stub_status_module && make && make install #宣告被監控的埠 EXPOSE 80
建立映象:
docker run -d -P centos_nginx:v1 /usr/local/nginx/sbin/nginx -g "daemon off;"
/usr/local/nginx/sbin/nginx:nginx的啟動命令
訪問32774埠:
注意:
daemon on | off 預設on
是否以守護程序的方式執行nginx。守護程序是指脫離終端在後面執行的程序。
變化一:
新增一個環境變數
ENV PATH /usr/local/nginx/sbin:$PATH
這樣在建立容器的時候,就可以省去前面的路徑
docker run -d -P centos_nginx:v1 nginx -g "daemon off;"
變化二:
新增一個CMD(啟動容器時預設執行的命令)
CMD /bin/sh -c 'nginx -g "daemon off;"'
這樣在建立容器的時候就不需要那麼麻煩。
docker run -d -P centos_nginx:v1
變化三:
新增一個ENTRYPOINT指令,預設的入口命令,CMD命令將作為其引數
ENTRYPOINT ["nginx"] CMD ["-g","daemon off;"]