文章目錄

Dockerfile書寫規則

Dockerfile書寫規則

官方建議指令越少越好，每一個指令都會創建一層，極佔空間。

FROM

指定目前需要構建鏡像的基礎鏡像

FROM [--platform=<platform>] <image> [AS <name>]
FROM [--platform=<platform>] <image>[:<tag>] [AS <name>]
FROM [--platform=<platform>] <image>[@<digest>] [AS <name>]

# --platform 可選 用於指定構建的平臺，默認不填爲本機平臺
# image 必填 鏡像名 所有鏡像默認繼承scratch鏡像
# tag 可選 鏡像標籤，默認爲latest
# digest 可選 摘要，默認爲latest
# AS 可選 別名，用於後續的鏡像階段構建
# FROM --platform=linux/amd64 mongo:4.3 AS db

RUN

兩種寫法，bash-like或者json-like

RUN <command> shell-like寫法，直接執行命令，在Linux中默認執行 /bin/sh -c，Windows中默認執行 cmd /S /C

# 使用反斜槓換行書寫
RUN /bin/bash -c 'source $HOME/.bashrc; \
echo $HOME'

RUN ["executable", "param1", "param2"]

# 參數是json-like書寫格式，需要使用雙引號
# json-like寫法不支持“$HELLO”的環境變量
RUN ["/bin/bash", "-c", "echo hello"]

CMD

與RUN命令區別在於，RUN命令直接執行並提交結果，CMD只是將命令存下來，等容器啓動時才執行；與ENTRYPOINGT命令配合使用效果更佳

CMD ["executable","param1","param2"] json-like
CMD ["param1","param2"] 作爲ENTERYPOINT指令的默認參數
CMD command param1 param2 shell-like

demo區分RUN和CMD

FROM alpine

RUN echo "hahaha run test"

CMD ["echo","hahahaha CMD"]

[root@seeter hu5ky]# docker build -t test:testruncommond .
Sending build context to Docker daemon   2.56kB
Step 1/3 : FROM alpine
 ---> cc0abc535e36
Step 2/3 : RUN echo "hahaha run test"
 ---> Running in b3d0cb324936
hahaha run test    ----------> RUN命令直接執行
Removing intermediate container b3d0cb324936
 ---> e920fa254b3e
Step 3/3 : CMD ["echo","hahahaha CMD"]
 ---> Running in bd23af78c1e0     -----------> 不執行
Removing intermediate container bd23af78c1e0
 ---> 1ec19a656013
Successfully built 1ec19a656013
Successfully tagged test:testruncommond

---------------------------
[root@seeter hu5ky]# docker run test:testruncommond 
hahahaha CMD ---------> docker run後纔會執行

LABEL

用來設定docker鏡像的metadata（鏡像的描述數據類似位置，大小，作者等），以鍵值對的形式存在

LABEL <key>=<value> <key>=<value> <key>=<value> ...
------------
# 多標籤寫法
LABEL "auth"="hu5ky" 
LABEL "time"="2020/04/27"

# 單標籤單行寫法
LABEL "auth"="hu5ky" "time"="2020/04/27"

# 單標籤多行寫法（個人推薦）
LABEL "auth"="hu5ky" \
      "time"="2020/04/27"

demo

[root@firevision-aibuilding-test zc]# docker image inspect --format='{{.Config.Labels}}' test:testruncommond
map[auth:hu5ky time:2020/04/27]

MAINTAINER

MAINTAINER <name> <email>

鏡像創建者官方不推薦使用，可以使用

LABEL maintainer="[email protected]" eg.

EXPOSE

用於在運行時暴露容器端口並指定協議，未指定協議則默認爲TCP

EXPOSE <port> [<port>/<protocol>...]

EXPOSE 80/tcp
EXPOSE 80/udp

EXPOSE可以配合-P/-p命令使用：

-P 當使用 -P 標記時，Docker 會隨機映射一個 49000~49900 的端口到內部容器開放的網絡端口。
-p -p（小寫）則可以指定要映射的IP和端口，但是在一個指定端口上只可以綁定一個容器。支持的格式有hostPort:containerPort ip:hostPort:containerPort ip::containerPort。-p命令會直接忽略 EXPOSE 中的端口.

ENV

k-v鍵值對，用於設定環境變量

ENV <key> <value> # 一次設置一個
ENV <key>=<value> ... # 一次設置多個

在docker run --env時可以對Fockerfile的ENV參數進行修改

ADD

將宿主機的文件或遠程文件添加到容器內部

ADD [--chown=<user>:<group>] <src>... <dest>
ADD [--chown=<user>:<group>] ["<src>",... "<dest>"] 如果文件路徑包含空格，使用這種方式。

demo

# 支持通配符寫法
ADD --chown=55:mygroup files* /somedir/
ADD --chown=bin files* /somedir/
ADD --chown=1 files* /somedir/
ADD --chown=10:11 files* /somedir/

# --chown 可選 指定用戶與組對應關係
# src 必填 宿主機文件或者url 如果爲URL需要權限驗證，嘖需要第三方工具下載，ADD命令不支持驗權
# dest 必填 docker內部路徑

ADD命令遵循以下規則

src中的路徑不可以是相對路徑，錯誤寫法：ADD ../something /something。因爲Dockerfile第一步就是將當前上下文以及子路徑發送到docker daemon中。../的寫法不被支持。
如果src是一個URL，且dest最後不以斜槓/結尾，則URL中文件被下載並拷貝到dest中。

如果src是一個URL，則docker自動將url最後的名稱作爲目標路徑的文件名。

# 正確用法
ADD http://example.com/foobar / # 最後會出現/foobar文件
# 錯誤寫法
ADD http://example.com / # 無效

如果src 是一個目錄，則整個目錄都會被拷貝，包括文件系統的metadata，但是文件夾不會被拷貝，只會拷貝其中的內容。
如果src是一個壓縮包，則會被解壓到dest中

COPY

同ADD，只是src不能爲URL

COPY [--chown=<user>:<group>] <src>... <dest>
COPY [--chown=<user>:<group>] ["<src>",... "<dest>"]

ENTRYPOINT

ENTRYPOINT ["executable", "param1", "param2"] json-like
ENTRYPOINT command param1 param2 bash-like

與CMD比較

docker run指定command時，CMD指令會被覆蓋，而ENTRYPOINT不會

demo

FROM ubuntu
CMD echo hahahahahahCMD
ENTRYPOINT ["echo", "hahahahha entrypoint"]
ENTRYPOINT echo hahahhhahahahENTRYPOINT

# ENTRYPOINT 不會被覆蓋
[root@seeter hu5ky]# docker run test:test echo hahahahecho
hahahhhahahahENTRYPOINT

FROM ubuntu
CMD echo hahahahahahCMD

# CMD被command替換
[root@seeter hu5ky]# docker run test:test echo hahahahecho
hahahahecho

CMD和ENTRYPOINT同時使用時，CMD將作爲ENTRYPOINT的參數。

demo

FROM ubuntu
CMD echo hahahahahahCMD
ENTRYPOINT ["echo", "hahahahha entrypoint"]

# CMD被視爲ENTRYPOINT參數
[root@seeter hu5ky]# docker run test:test
hahahaha entrypoint echo hahahaha CMD

多個ENTRYPOINT同時使用時，最後一個ENTRYPOINT生效。

demo

FROM ubuntu
CMD echo hahahahahahCMD
ENTRYPOINT ["echo", "hahahahha entrypoint"]
ENTRYPOINT echo hahahhhahahahENTRYPOINT

[root@seeter hu5ky]# docker run test:test
hahahhhahahahENTRYPOINT

VOLUME

VOLUME ["/data"]
VOLUME /data

作用僅僅是創建一個匿名掛載點，指定host存儲時，需使用docker run -v

USER（待補充）

USER <user>[:<group>]
USER <UID>[:<GID>]

WORKDIR

爲WORKDIR後的所有命令指定運行目錄

WORKDIR /path/to/workdir

demo

# 如果使用多次`WORKDIR`指令，且第一個是絕對路徑，後面的是相對路徑，則後續的所有路徑就將追加在前一個路徑中
FROM ubuntu
WORKDIR /app
WORKDIR hu5ky
RUN pwd
CMD echo hahahahahahCMD
VOLUME /home/hu5ky/volume/ /app/volume/

[root@seeter hu5ky]# docker build -t test:test .
Sending build context to Docker daemon  3.072kB
Step 1/6 : FROM ubuntu
 ---> 1d622ef86b13
Step 2/6 : WORKDIR /app
 ---> Running in 252cabc124c2
Removing intermediate container 252cabc124c2
 ---> 0577acce038d
Step 3/6 : WORKDIR hu5ky
 ---> Running in 83a45ee392c2
Removing intermediate container 83a45ee392c2
 ---> 8e3a8ccfd5b4
Step 4/6 : RUN pwd
 ---> Running in c66ebc01af08
/app/hu5ky ----------->完整路徑
···

demo

# 可以結合環境變量使用
FROM ubuntu
ENV DIRPATH /app
WORKDIR $DIRPATH
WORKDIR hu5ky/$PPP
RUN pwd

[root@seeter hu5ky]# docker build -t test:test .
Sending build context to Docker daemon  3.072kB
Step 1/5 : FROM ubuntu
 ---> 1d622ef86b13
Step 2/5 : ENV DIRPATH /app
 ---> Using cache
 ---> 072a81455e5d
Step 3/5 : WORKDIR $DIRPATH
 ---> Running in 1c40421a9bb3
Removing intermediate container 1c40421a9bb3
 ---> 881bb05f37ce
Step 4/5 : WORKDIR hu5ky/$PPP
 ---> Running in 055cbeedebda
Removing intermediate container 055cbeedebda
 ---> 36b3343fa7cc
Step 5/5 : RUN pwd
 ---> Running in f4ee0bbb3182
/app/hu5ky ---------> 輸出路徑
Removing intermediate container f4ee0bbb3182
 ---> 8a6c3f753250
Successfully built 8a6c3f753250
Successfully tagged test:test

ARG

ARG <name>[=<default value>] 缺省值會被--build-arg <varname>=<value>替換

用戶可以通過docker build中的--build-arg <varname>=<value>參數來指定，如果Dockerfile中沒有指定ARG參數，在build時會報出warning
demo

FROM ubuntu
ARG user
RUN echo $user

[root@firevision-kgm-test zhangc]# docker build --build-arg user=what_user .
Sending build context to Docker daemon  2.048kB
Step 1/3 : FROM ubuntu
 ---> 1d622ef86b13
Step 2/3 : ARG user
 ---> Running in 46f865af728e
Removing intermediate container 46f865af728e
 ---> 3742534d7867
Step 3/3 : RUN echo $user
 ---> Running in 5535d80b3b89
what_user. ------> 輸出
Removing intermediate container 5535d80b3b89
 ---> 856eec9724e5
Successfully built 856eec9724e5

同時使用ARG和ENV指令，以ENV的參數爲準，一般來說ENV的優先級高於ARG
demo

FROM ubuntu
ARG CONT_IMG_VER
ENV CONT_IMG_VER v1.0.0
RUN echo $CONT_IMG_VER

[root@seeter hu5ky]# docker build --build-arg CONT_IMG_VER=v2.0.1 .
Sending build context to Docker daemon  3.072kB
Step 1/4 : FROM ubuntu
 ---> 1d622ef86b13
Step 2/4 : ARG CONT_IMG_VER
 ---> Using cache
 ---> 993483f26804
Step 3/4 : ENV CONT_IMG_VER v1.0.0
 ---> Running in 2535a58ab1d4
Removing intermediate container 2535a58ab1d4
 ---> bc3012e82989
Step 4/4 : RUN echo $CONT_IMG_VER
 ---> Running in c55abb96daf7
v1.0.0. ---------> env指令的參數
Removing intermediate container c55abb96daf7
 ---> 114fc834f42d
Successfully built 114fc834f42d

結合ENV和ARG使用demo

FROM ubuntu
ARG CONT_IMG_VER
ENV CONT_IMG_VER ${CONT_IMG_VER:-v1.0.0}
RUN echo $CONT_IMG_VER

[root@seeter hu5ky]# docker build .
Sending build context to Docker daemon  3.072kB
Step 1/4 : FROM ubuntu
 ---> 1d622ef86b13
Step 2/4 : ARG CONT_IMG_VER
 ---> Running in 2ccf8e734837
Removing intermediate container 2ccf8e734837
 ---> af95bb2aeb4b
Step 3/4 : ENV CONT_IMG_VER ${CONT_IMG_VER:-v1.0.0}
 ---> Running in 3bf09240355e
Removing intermediate container 3bf09240355e
 ---> d845d51f801f
Step 4/4 : RUN echo $CONT_IMG_VER
 ---> Running in 8b34d0bd089b
v1.0.0
Removing intermediate container 8b34d0bd089b
 ---> e00f86d7c62a
Successfully built e00f86d7c62a

ARG指令有一組預定義的參數，不需要在Dockerfile中指定

HTTP_PROXY
http_proxy
HTTPS_PROXY
https_proxy
FTP_PROXY
ftp_proxy
NO_PROXY
no_proxy

直接在--build-arg <varname>=<value>中指定即可

ONBUILD（待補充）

ONBUILD <INSTRUCTION>

STOPSIGNAL（待補充）

STOPSIGNAL signal

HEALTHCHECK（待補充）

HEALTHCHECK [OPTIONS] CMD command
HEALTHCHECK NONE

SHELL（待補充）

SHELL ["executable", "parameters"] 必須爲json-like

Dockerfile書寫規則

文章目錄

Dockerfile書寫規則

FROM

RUN

CMD

LABEL

MAINTAINER

EXPOSE

ENV

ADD

COPY

ENTRYPOINT

VOLUME

USER（待補充）

WORKDIR

ARG

ONBUILD（待補充）

STOPSIGNAL（待補充）

HEALTHCHECK（待補充）

SHELL（待補充）

Leetcode 簡單三十四 746.使用最小花費爬樓梯

leetcode 中等八 338.比特位計數

Leetcode 中等一兩數相加

leetcode 中等九 877.石子游戲

docker-compose書寫規則

https://yachay.unat.edu.pe/blog/index.php?comment_area=format_blog&comment_component=blog&comment_co

linux以太網驅動總結