dockerfile Docker入門02——Dockerfile詳解
Docker入門02——Dockerfile詳解
基本示例
# This is a commit
FROM alpine:3.2
MAINTAINER Jasper Xu <[email protected]163.com> RUN apk update && apk add socat && rm -r /var/cache/ RUN chmod -R 755 /data ADD execfile /etc/execfile ADD data/* /etc/data/ COPY xxx.tgz /home/xxx.tgz RUN chmod 755 /etc/execfile RUN ["/etc/execfile", "arg1", "arg1"] ENV abc=hello VOLUME ["/data"] EXPOSE 8080 WORKDIR /data/tools CMD service nginx start CMD echo "Hello docker!"
FROM
必須為第一個命令,指定基礎映象
FROM <image>
FROM <image>:<tag> FROM <image>@<digest>
FROM mysql:5.6
MAINTAINER
維護者資訊
MAINTAINER <name>
MAINTAINER Jasper Xu
MAINTAINER [email protected]163.com
MAINTAINER Jasper Xu <[email protected]163.com>
LABEL
給映象新增資訊。使用docker inspect
可檢視映象的相關資訊
LABEL "com.example.vendor"="ACME Incorporated"
LABEL com.example.label-with-value="foo" LABEL version="1.0" LABEL description="This text illustrates \ that label-values can span multiple lines."
RUN
構建映象時執行的命令
# 由shell啟動,Linux預設為`/bin/sh -c`,Windows預設為`cmd /S /C`
RUN <command>
# 執行可執行檔案 RUN ["executable", "param1", "param2"]
RUN apk update
RUN ["/etc/execfile", "arg1", "arg1"]
ADD
將本地檔案新增到容器中,identity, gzip, bzip2,xz,tar.gz,tgz等型別的檔案將被新增tar -x命令,進行解壓
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/
COPY
同ADD,只是不會解壓檔案。
CMD
構建容器後呼叫,也就是在容器啟動時才進行呼叫。
CMD ["executable","param1","param2"] (執行可執行檔案,優先) CMD ["param1","param2"] (設定了ENTRYPOINT,則直接呼叫ENTRYPOINT新增引數) CMD command param1 param2 (執行shell內部命令)
CMD echo "This is a test." | wc -
CMD ["/usr/bin/wc","--help"]
ENTRYPOINT
配置容器,使其可執行化。配合CMD可省去"application",只使用引數。
ENTRYPOINT ["executable", "param1", "param2"] (可執行檔案, 優先) ENTRYPOINT command param1 param2 (shell內部命令)
FROM ubuntu
ENTRYPOINT ["top", "-b"] CMD ["-c"]
當啟動容器後,你將直接看到相當於運行了top -b -c
要進一步檢視,你可以直接使用命令docker exec -it test ps aux
相當於使用了docker exec top -b -it test ps aux
ENV
設定環境變數
ENV <key> <value>
ENV <key>=<value> ...
ENV myName="John Doe" myDog=Rex\ The\ Dog \
myCat=fluffy
等同於
ENV myName John Doe
ENV myDog Rex The Dog
ENV myCat fluffy
EXPOSE
指定於外界互動的埠,在容器啟動時用-p傳遞引數,例如-p 3307:3306
將容器內的3306繫結到本機的3307
EXPOSE <port> [<port>...]
EXPOSE 80 443
EXPOSE 8080
VOLUME
用於指定持久化目錄,在容器啟動時用-v傳遞引數,例如-v ~/opt/data/mysql:/var/lib/mysql
將本機的~/opt/data/mysql
和容器內的/var/lib/mysql
做持久化關聯
容器啟動時會載入,容器關閉後會回寫。
VOLUME ["/data"]
VOLUME ["/data"]
VOLUME ["/var/www", "/var/log/apache2", "/etc/apache2"]
WORKDIR
工作目錄
WORKDIR /path/to/workdir
WORKDIR /a (這時工作目錄為/a)
WORKDIR b (這時工作目錄為/a/b)
WORKDIR c (這時工作目錄為/a/b/c)
USER
用於設定容器的執行使用者名稱或UID,USER 123
或USER git
。RUN
, CMD
and ENTRYPOINT
都將用該使用者執行。
ARG
由外部啟動時必須傳入的引數,在容器啟動時用--build-arg
傳遞引數
指定於外界互動的埠,在容器啟動時用-p傳遞引數,例如--build-arg CONT_IMG_VER=v2.0.1
FROM ubuntu
2 ARG CONT_IMG_VER
3 ENV CONT_IMG_VER ${CONT_IMG_VER:-v1.0.0} 4 RUN echo $CONT_IMG_VER
有些預設引數,無需指定,也不用使用``傳遞,可直接傳參HTTP_PROXY
,http_proxy
,HTTPS_PROXY
,https_proxy
,FTP_PROXY
,ftp_proxy
,NO_PROXY
,no_proxy
基本示例
# This is a commit
FROM alpine:3.2
MAINTAINER Jasper Xu <[email protected]163.com> RUN apk update && apk add socat && rm -r /var/cache/ RUN chmod -R 755 /data ADD execfile /etc/execfile ADD data/* /etc/data/ COPY xxx.tgz /home/xxx.tgz RUN chmod 755 /etc/execfile RUN ["/etc/execfile", "arg1", "arg1"] ENV abc=hello VOLUME ["/data"] EXPOSE 8080 WORKDIR /data/tools CMD service nginx start CMD echo "Hello docker!"
FROM
必須為第一個命令,指定基礎映象
FROM <image>
FROM <image>:<tag> FROM <image>@<digest>
FROM mysql:5.6
MAINTAINER
維護者資訊
MAINTAINER <name>
MAINTAINER Jasper Xu
MAINTAINER [email protected]163.com
MAINTAINER Jasper Xu <[email protected]163.com>
LABEL
給映象新增資訊。使用docker inspect
可檢視映象的相關資訊
LABEL "com.example.vendor"="ACME Incorporated"
LABEL com.example.label-with-value="foo" LABEL version="1.0" LABEL description="This text illustrates \ that label-values can span multiple lines."
RUN
構建映象時執行的命令
# 由shell啟動,Linux預設為`/bin/sh -c`,Windows預設為`cmd /S /C`
RUN <command>
# 執行可執行檔案 RUN ["executable", "param1", "param2"]
RUN apk update
RUN ["/etc/execfile", "arg1", "arg1"]
ADD
將本地檔案新增到容器中,identity, gzip, bzip2,xz,tar.gz,tgz等型別的檔案將被新增tar -x命令,進行解壓
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/
COPY
同ADD,只是不會解壓檔案。
CMD
構建容器後呼叫,也就是在容器啟動時才進行呼叫。
CMD ["executable","param1","param2"] (執行可執行檔案,優先) CMD ["param1","param2"] (設定了ENTRYPOINT,則直接呼叫ENTRYPOINT新增引數) CMD command param1 param2 (執行shell內部命令)
CMD echo "This is a test." | wc -
CMD ["/usr/bin/wc","--help"]
ENTRYPOINT
配置容器,使其可執行化。配合CMD可省去"application",只使用引數。
ENTRYPOINT ["executable", "param1", "param2"] (可執行檔案, 優先) ENTRYPOINT command param1 param2 (shell內部命令)
FROM ubuntu
ENTRYPOINT ["top", "-b"] CMD ["-c"]
當啟動容器後,你將直接看到相當於運行了top -b -c
要進一步檢視,你可以直接使用命令docker exec -it test ps aux
相當於使用了docker exec top -b -it test ps aux
ENV
設定環境變數
ENV <key> <value>
ENV <key>=<value> ...
ENV myName="John Doe" myDog=Rex\ The\ Dog \
myCat=fluffy
等同於
ENV myName John Doe
ENV myDog Rex The Dog
ENV myCat fluffy
EXPOSE
指定於外界互動的埠,在容器啟動時用-p傳遞引數,例如-p 3307:3306
將容器內的3306繫結到本機的3307
EXPOSE <port> [<port>...]
EXPOSE 80 443
EXPOSE 8080
VOLUME
用於指定持久化目錄,在容器啟動時用-v傳遞引數,例如-v ~/opt/data/mysql:/var/lib/mysql
將本機的~/opt/data/mysql
和容器內的/var/lib/mysql
做持久化關聯
容器啟動時會載入,容器關閉後會回寫。
VOLUME ["/data"]
VOLUME ["/data"]
VOLUME ["/var/www", "/var/log/apache2", "/etc/apache2"]
WORKDIR
工作目錄
WORKDIR /path/to/workdir
WORKDIR /a (這時工作目錄為/a)
WORKDIR b (這時工作目錄為/a/b)
WORKDIR c (這時工作目錄為/a/b/c)
USER
用於設定容器的執行使用者名稱或UID,USER 123
或USER git
。RUN
, CMD
and ENTRYPOINT
都將用該使用者執行。
ARG
由外部啟動時必須傳入的引數,在容器啟動時用--build-arg
傳遞引數
指定於外界互動的埠,在容器啟動時用-p傳遞引數,例如--build-arg CONT_IMG_VER=v2.0.1
FROM ubuntu
2 ARG CONT_IMG_VER
3 ENV CONT_IMG_VER ${CONT_IMG_VER:-v1.0.0} 4 RUN echo $CONT_IMG_VER
有些預設引數,無需指定,也不用使用``傳遞,可直接傳參HTTP_PROXY
,http_proxy
,HTTPS_PROXY
,https_proxy
,FTP_PROXY
,ftp_proxy
,NO_PROXY
,no_proxy