Dockerfile 簡單使用

先來編寫一個最簡單的 Dockerfile。

  1. 例如：
FROM nginx
RUN echo '<h1>使用Dockerfile構建鏡像</h1>' > /usr/share/nginx/html/index.html

該 Dockerfile 非常簡單，其中的 FORM 、 RUN 都是 Dockerfile 的指令。
FROM 指令用于指定基礎鏡像 RUN 指令用于執行命令
2. 在 Dockerfile 所在路徑執行一下命令構建鏡像：

docker build -t nginx:my .

其中，命令最后的點(.)用于路徑參數傳遞，表示當前路徑。

  1. 執行以下命令,即可使用該鏡像啟動一個 Docker容器。
docker run -d -p 92:80 nginx:my
  1. 訪問查看到效果(頁面是因為編碼問題)。

    從本例不難看出 Dockerfile的強大。僅僅編寫了兩行代碼,就修改了原始鏡像的行為。不僅如此,通過 Dockerfile,還可直觀地看到修改鏡像的具體過程。

除了使用Dockerfile構建鏡像,也可手工制作 Docker鏡像,但這種方式煩瑣效率低,一般不適合生產。

Dockerfile 常用指令

在前面的例子中,提到了FORM、RUN指令。事實上, Dockerfile有十多個指令,指令的一般格式為:指令名稱參數。

  1. ADD復制文件
    ADD 指令用于復制文件,格式為:
    ADD <src>... <dest>
    ADD ["<srv>"... "<dest>"]
    從src目錄復制文件到容器的dest。其中src可以是 Dockerfile所在目錄的相對路徑,也可以是一個URL,還可以是一個壓縮包。

注意:
1、src必須在構建的上下文內,不能使用例如:ADD ../somethine/something這樣的命令,因為 docker bui1d命令首先會將上下文路徑和其子目錄發送到 docker daemon。
2、如果src是一個URL,同時dest不以斜杠結尾,dest將會被視為文件,src對應內容文件將會被下載到 dest。
3、如果src是一個URL,同時dest以斜杠結尾,dest將被視為目錄,src對應內容將會被下載到dest目錄。
4、如果 src 是一個目錄，那么整個目錄下的內容將會被復制，包括文件系統元數據。
5、如果文件是可識別的壓縮包格式，則 doclcer 會自動解壓。
示例：

ADD wzq-swagger-mng.jar app.jar
  1. ARG 設置構建參數
    ARG 指令用于設置構建參數，類似于 ENV。和 ARG 不同的是， ARG 設置的是構建時的環境變量，在容器運行時是不會存在這些變量的。
    格式為： ARG <name> [<default value>]。
    示例： ARG user=Jacob
  2. CMD 容器啟動命令
    CMD 指令用于為執行容器提供默認值。每個 Dockerfile 只有一個 CMD 命令，如果指定了多個 CMD 命令，那么只有最后一條會被執行，如果啟動容器時指定了運行的命令，則會覆蓋掉 CMD 指定的命令。
    支持 3 種格式：
    CMD ["executable","paraml","param2"] (推薦使用)
    CMD ["param1","param2"](為 ENT 盯 PoINT 指令提供預設參數)
    CMD command param1 param2 (在 shell 中執行)
    示例： CMD echo " This 15 a test ." | wc -
  3. COPY 復制文件
    復制文件，格式為：
    COPY <src>... <dest>
    COPY ["<src>",... "<dest>"]
    復制本地的 src 到容器的 dest 。COPY 指令和 ADD 指塵類似， COPY 不支持 URL 和 壓縮包。
  4. ENTRYPOINT 人口點
    格式為：
    ENTRYPOINT ["executable","param1";"param2"]
    ENTRYPOINT command param1 param2
    ENTRYPOINT 和 CMD指令目的是一樣的，都是指定 Docker 容器啟動時執行的命令，可多次設置，但只有最后一個有效。
  5. ENV 設置環境變量
    ENV 指令用于設置環境變量，格式為：
    ENV <key> <value>
    ENV <key>=<value>
    示例： ENV JAVA_HOME /path/to/java
  6. EXPOSE聲明暴露的端口
    EXPOSE 指令用于聲明在運行時容器提供服務的端口，格式為： EXPOSE <port> [<port>...]。
    需要注意的是，這只是一個聲明，運行時并不會因為該聲明就打開相應端口。該指令的作用主要是幫助鏡像使用者理解該鏡像服務的守護端口；其次是當運行時使用隨機映射時，會自動映射 EXP0SE 的端口。
    示例：
  • 聲明暴露一個端口示例 EXPOSE port1
  • 相應的運行容器使用的命令 docker run -p port1 image
  • 也可使用一 P 選項啟動 docker run -P image
  • 聲明暴露多個端口示例 EXPOSE port1 port2 port3
  • 相應的運行容器使用的命令 docker run -p port1 -p port2 -p port3 image
  • 也可指定需要映射到宿主機器上的端口號 docker run -p host_port1:port1 -p host_port2:port2 -p host_port3:port3 image
  1. FROM 指定基礎鏡像
    使用 FORM 指令指定基礎鏡像，FORM 指令有點像 Java 里面的 extends 關鍵字。需要注意的是，FROM 指令必須指定且需要寫在其他指令之前。 FORM 指令后的所有指令都依賴于該指令所指定的鏡像。
    支持 3 種格式：
    FROM <image>
    FROM <image>:<tag>
    FROM <image>@<digest>
  2. LABEL 為鏡像添加元數據
    LABEL 指令用于為鏡像添加元數據。
    格式為：LABLE <key>=<volue> <key>=<volue> <key>=<volue> ...。
    使用“ " ”和“ \ ”轉換命令行。
    示例：
    LABEL "com.example.vendor"="ACME Incorporated"
    LABEL com.example.label-with-value="foo"
    LABEL version="1.0"
    LABLE description="This text illustrates that label-values can span multlple lines."
  3. MAINTAINER 指定維護者的信息
    MAINTAINER 指令用于指定維護者的信息，用于為 DOCkerfile 署名。格式為： MAINTAINR <name>。
    示例：
    MAINTAINER Jacob<596766829@qq.com>
  4. RUN 執行命令
    該指令支持兩種格式：
    RUN <Command>
    RUN ["executable","param1","param2"]
    UuN <command>在 shell 終端中運行，在 Linux 中默認是/bin/Sh -C ，在 Windows 中是 cmd /s /c，使用這種格式，就像直接在命令行中輸人命令一樣。 RUN ["executable","param1","param2"] 使用 exec 執行，這種方式類似于函數調用。指定其他終端可以通過該方式操作，例如： RUN ["/bin/bash","-c","echo hello"] ，該方式必須使用雙引號”而不能使用單引號'，因為該方式會被轉換成一個 JsON 數組。
  5. USER 設置用戶
    該指令用于設置啟動鏡像時的用戶或者 UID ，寫在該指令后的 RUN 、 CMD 以及 ENTRYPOINT 指令都將使用該用戶執行命令。
    格式為：USER 用戶名。
    示例： USER Jacob
  6. VOLUME 指定掛載點
    該指令使容器中的一個目錄具有持久化存儲的功能，該目錄可被容器本身使用，也可共享給其他容器。當容器中的應用有持久化數據的需求時可以在 Dockerfile 中使用該指令。格式為：VOLUME ["data"。
    示例： VOLUME /data
  7. WORKDIR 指定工作目錄
    格式為： WORKOIR /path/to/workdir。
    切換目錄指令，類似于 cd 命令，寫在該指令后的 RUN , CMD 以及 ENTRYPOINT 指令都將該目錄作為當前目錄，并執行相應的命令。
  8. 其他
    Dockerfile 還有一些其他的指令，例如 STOPSINGAL、HEALTHcHECK、SHELL 等。有興趣的可前往 https://docs.docker.com/engine/reference/builder/進行擴展閱讀。

使用 Dockerfile 構建 Docker 鏡像

  1. 準備工作
    準備一個Jar包,本次使用的Jar包是springboot整合swagger。
  2. 使用Dockerfile 構建 Docker 鏡像
    創建 Dockerfile 文件,并添加一下內容
#指定鏡像
FROM java:8
#將本地文件夾掛載到當前容器
VOLUME /tmp
#復制文件到容器
ADD wzq-swagger-mng.jar app.jar
RUN bash -c 'touch /app.jar'
#聲明需要暴露的端口
EXPOSE 10086
#配置容器啟動后需要執行的命令
ENTRYPOINT ["java","-Djava.security.edg=file:/dev/.urandom","-jar","/app.jar"]
  1. 使用 docker build 命令構建鏡像
docker build -t itouch/wzq-swagger-mng .


4. 啟動鏡像 
docker run -d -p 10086:10086 itouch/wzq-swagger-mng
  1. 測試

學習于：《Spring Cloud與Docker 微服務架構實戰》 — 周立