1. 程式人生 > >dockerfile詳解

dockerfile詳解

rsh add exec 鏡像 一個 pac git 類型 -type

  • 基本示例
  • FROM
  • MAINTAINER
  • LABEL
  • RUN
  • ADD
  • COPY
  • CMD
  • ENTRYPOINT
  • ENV
  • EXPOSE
  • VOLUME
  • WORKDIR
  • USER
  • ARG

基本示例

# This is a commit
FROM alpine:3.2
MAINTAINER Jasper Xu <sorex@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]
MAINTAINER Jasper Xu <[email protected]>

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 123USER 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

dockerfile詳解