From 1d0a49ca3186bd55284db579d816801cf166ee8e Mon Sep 17 00:00:00 2001 From: a504082002 Date: Wed, 19 Nov 2014 00:53:01 +0800 Subject: [PATCH] translate dockerfile into traditional chinese --- dockerfile/basic_structure.md | 2 +- dockerfile/build_image.md | 8 ++-- dockerfile/instructions.md | 82 +++++++++++++++++------------------ 3 files changed, 46 insertions(+), 46 deletions(-) diff --git a/dockerfile/basic_structure.md b/dockerfile/basic_structure.md index 78cb553..9c2aa01 100644 --- a/dockerfile/basic_structure.md +++ b/dockerfile/basic_structure.md @@ -1,5 +1,5 @@ ## 基本結構 -Dockerfile 由一行行命令語句組成，並且支援以 `#` 開頭的注釋行。 +Dockerfile 由一行行命令語句組成，並且支援以 `#` 開頭的註釋行。 一般而言，Dockerfile 分為四部分：基礎鏡像資訊、維護者資訊、鏡像操作指令和容器啟動時執行指令。 diff --git a/dockerfile/build_image.md b/dockerfile/build_image.md index 651a0bb..1faded9 100644 --- a/dockerfile/build_image.md +++ b/dockerfile/build_image.md @@ -1,9 +1,9 @@ -## 创建镜像 -编写完成 Dockerfile 之后，可以通过 `docker build` 命令来创建镜像。 +## 創建鏡像 +編寫完成 Dockerfile 之後，可以通過 `docker build` 命令來創建鏡像。 -基本的格式为 `docker build [选项] 路径`，该命令将读取指定路径下（包括子目录）的 Dockerfile，并将该路径下所有内容发送给 Docker 服务端，由服务端来创建镜像。因此一般建议放置 Dockerfile 的目录为空目录。也可以通过 `.dockerignore` 文件（每一行添加一条匹配模式）来让 Docker 忽略路径下的目录和文件。 +基本的格式為 `docker build [選項] 路徑`，該命令將讀取指定路徑下（包括子目錄）的 Dockerfile，並將該路徑下所有內容發送給 Docker 服務端，由服務端來創建鏡像。因此一般建議放置 Dockerfile 的目錄為空目錄。也可以通過 `.dockerignore` 文件（每一行添加一條匹配模式）來讓 Docker 忽略路徑下的目錄和文件。 -要指定镜像的标签信息，可以通过 `-t` 选项，例如 +要指定鏡像的標簽信息，可以通過 `-t` 選項，例如 ``` $ sudo docker build -t myrepo/myapp /tmp/test1/ ``` diff --git a/dockerfile/instructions.md b/dockerfile/instructions.md index 2595260..b3ec577 100644 --- a/dockerfile/instructions.md +++ b/dockerfile/instructions.md @@ -1,40 +1,40 @@ ## 指令 -指令的一般格式为 `INSTRUCTION arguments`，指令包括 `FROM`、`MAINTAINER`、`RUN` 等。 +指令的一般格式為 `INSTRUCTION arguments`，指令包括 `FROM`、`MAINTAINER`、`RUN` 等。 ### FROM -格式为 `FROM `或`FROM :`。 +格式為 `FROM `或`FROM :`。 -第一条指令必须为 `FROM` 指令。并且，如果在同一个Dockerfile中创建多个镜像时，可以使用多个 `FROM` 指令（每个镜像一次）。 +第一條指令必須為 `FROM` 指令。並且，如果在同一個Dockerfile中創建多個鏡像時，可以使用多個 `FROM` 指令（每個鏡像一次）。 ### MAINTAINER -格式为 `MAINTAINER `，指定维护者信息。 +格式為 `MAINTAINER `，指定維護者信息。 ### RUN -格式为 `RUN ` 或 `RUN ["executable", "param1", "param2"]`。 +格式為 `RUN ` 或 `RUN ["executable", "param1", "param2"]`。 -前者将在 shell 终端中运行命令，即 `/bin/sh -c`；后者则使用 `exec` 执行。指定使用其它终端可以通过第二种方式实现，例如 `RUN ["/bin/bash", "-c", "echo hello"]`。 +前者將在 shell 終端中運行命令，即 `/bin/sh -c`；後者則使用 `exec` 執行。指定使用其它終端可以通過第二種方式實現，例如 `RUN ["/bin/bash", "-c", "echo hello"]`。 -每条 `RUN` 指令将在当前镜像基础上执行指定命令，并提交为新的镜像。当命令较长时可以使用 `\` 来换行。 +每條 `RUN` 指令將在當前鏡像基礎上執行指定命令，並提交為新的鏡像。當命令較長時可以使用 `\` 來換行。 ### CMD -支持三种格式 -* `CMD ["executable","param1","param2"]` 使用 `exec` 执行，推荐方式； -* `CMD command param1 param2` 在 `/bin/sh` 中执行，提供给需要交互的应用； -* `CMD ["param1","param2"]` 提供给 `ENTRYPOINT` 的默认参数； +支持三種格式 +* `CMD ["executable","param1","param2"]` 使用 `exec` 執行，推薦方式； +* `CMD command param1 param2` 在 `/bin/sh` 中執行，提供給需要交互的應用； +* `CMD ["param1","param2"]` 提供給 `ENTRYPOINT` 的默認參數； -指定启动容器时执行的命令，每个 Dockerfile 只能有一条 `CMD` 命令。如果指定了多条命令，只有最后一条会被执行。 +指定啟動容器時執行的命令，每個 Dockerfile 只能有一條 `CMD` 命令。如果指定了多條命令，只有最後一條會被執行。 -如果用户启动容器时候指定了运行的命令，则会覆盖掉 `CMD` 指定的命令。 +如果用戶啟動容器時候指定了運行的命令，則會覆蓋掉 `CMD` 指定的命令。 ### EXPOSE -格式为 `EXPOSE [...]`。 +格式為 `EXPOSE [...]`。 -告诉 Docker 服务端容器暴露的端口号，供互联系统使用。在启动容器时需要通过 -P，Docker 主机会自动分配一个端口转发到指定的端口。 +告訴 Docker 服務端容器暴露的端口號，供互聯系統使用。在啟動容器時需要通過 -P，Docker 主機會自動分配一個端口轉發到指定的端口。 ### ENV -格式为 `ENV `。 -指定一个环境变量，会被后续 `RUN` 指令使用，并在容器运行时保持。 +格式為 `ENV `。 +指定一個環境變量，會被後續 `RUN` 指令使用，並在容器運行時保持。 例如 ``` @@ -45,59 +45,59 @@ ENV PATH /usr/local/postgres-$PG_MAJOR/bin:$PATH ``` ### ADD -格式为 `ADD `。 +格式為 `ADD `。 -该命令将复制指定的 `` 到容器中的 ``。 -其中 `` 可以是Dockerfile所在目录的一个相对路径；也可以是一个 URL；还可以是一个 tar 文件（自动解压为目录）。 +該命令將復制指定的 `` 到容器中的 ``。 +其中 `` 可以是Dockerfile所在目錄的一個相對路徑；也可以是一個 URL；還可以是一個 tar 文件（自動解壓為目錄）。 ### COPY -格式为 `COPY `。 +格式為 `COPY `。 -复制本地主机的 ``（为 Dockerfile 所在目录的相对路径）到容器中的 ``。 +復制本地主機的 ``（為 Dockerfile 所在目錄的相對路徑）到容器中的 ``。 -当使用本地目录为源目录时，推荐使用 `COPY`。 +當使用本地目錄為源目錄時，推薦使用 `COPY`。 ### ENTRYPOINT -两种格式： +兩種格式： * `ENTRYPOINT ["executable", "param1", "param2"]` -* `ENTRYPOINT command param1 param2`（shell中执行）。 +* `ENTRYPOINT command param1 param2`（shell中執行）。 -配置容器启动后执行的命令，并且不可被 `docker run` 提供的参数覆盖。 +配置容器啟動後執行的命令，並且不可被 `docker run` 提供的參數覆蓋。 -每个 Dockerfile 中只能有一个 `ENTRYPOINT`，当指定多个时，只有最后一个起效。 +每個 Dockerfile 中只能有一個 `ENTRYPOINT`，當指定多個時，只有最後一個起效。 ### VOLUME -格式为 `VOLUME ["/data"]`。 +格式為 `VOLUME ["/data"]`。 -创建一个可以从本地主机或其他容器挂载的挂载点，一般用来存放数据库和需要保持的数据等。 +創建一個可以從本地主機或其他容器掛載的掛載點，一般用來存放數據庫和需要保持的數據等。 ### USER -格式为 `USER daemon`。 +格式為 `USER daemon`。 -指定运行容器时的用户名或 UID，后续的 `RUN` 也会使用指定用户。 +指定運行容器時的用戶名或 UID，後續的 `RUN` 也會使用指定用戶。 -当服务不需要管理员权限时，可以通过该命令指定运行用户。并且可以在之前创建所需要的用户，例如：`RUN groupadd -r postgres && useradd -r -g postgres postgres`。要临时获取管理员权限可以使用 `gosu`，而不推荐 `sudo`。 +當服務不需要管理員權限時，可以通過該命令指定運行用戶。並且可以在之前創建所需要的用戶，例如：`RUN groupadd -r postgres && useradd -r -g postgres postgres`。要臨時獲取管理員權限可以使用 `gosu`，而不推薦 `sudo`。 ### WORKDIR -格式为 `WORKDIR /path/to/workdir`。 +格式為 `WORKDIR /path/to/workdir`。 -为后续的 `RUN`、`CMD`、`ENTRYPOINT` 指令配置工作目录。 +為後續的 `RUN`、`CMD`、`ENTRYPOINT` 指令配置工作目錄。 -可以使用多个 `WORKDIR` 指令，后续命令如果参数是相对路径，则会基于之前命令指定的路径。例如 +可以使用多個 `WORKDIR` 指令，後續命令如果參數是相對路徑，則會基於之前命令指定的路徑。例如 ``` WORKDIR /a WORKDIR b WORKDIR c RUN pwd ``` -则最终路径为 `/a/b/c`。 +則最終路徑為 `/a/b/c`。 ### ONBUILD -格式为 `ONBUILD [INSTRUCTION]`。 +格式為 `ONBUILD [INSTRUCTION]`。 -配置当所创建的镜像作为其它新创建镜像的基础镜像时，所执行的操作指令。 +配置當所創建的鏡像作為其它新創建鏡像的基礎鏡像時，所執行的操作指令。 -例如，Dockerfile 使用如下的内容创建了镜像 `image-A`。 +例如，Dockerfile 使用如下的內容創建了鏡像 `image-A`。 ``` [...] ONBUILD ADD . /app/src @@ -105,7 +105,7 @@ ONBUILD RUN /usr/local/bin/python-build --dir /app/src [...] ``` -如果基于 image-A 创建新的镜像时，新的Dockerfile中使用 `FROM image-A`指定基础镜像时，会自动执行 `ONBUILD` 指令内容，等价于在后面添加了两条指令。 +如果基於 image-A 創建新的鏡像時，新的Dockerfile中使用 `FROM image-A`指定基礎鏡像時，會自動執行 `ONBUILD` 指令內容，等價於在後面添加了兩條指令。 ``` FROM image-A @@ -114,5 +114,5 @@ ADD . /app/src RUN /usr/local/bin/python-build --dir /app/src ``` -使用 `ONBUILD` 指令的镜像，推荐在标签中注明，例如 `ruby:1.9-onbuild`。 +使用 `ONBUILD` 指令的鏡像，推薦在標簽中註明，例如 `ruby:1.9-onbuild`。