From ada102fc4d2a0a3522e3bf15dd6880ab9d01a1ec Mon Sep 17 00:00:00 2001 From: "Xingyu.Wang" Date: Fri, 13 Jul 2018 23:34:01 +0800 Subject: [PATCH 1/2] PRF:20180606 Getting started with Buildah.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit @pinewall 翻译很细心。 --- .../20180606 Getting started with Buildah.md | 50 ++++++++++--------- 1 file changed, 27 insertions(+), 23 deletions(-) diff --git a/translated/tech/20180606 Getting started with Buildah.md b/translated/tech/20180606 Getting started with Buildah.md index 73772cd6c9..c1ece0f54e 100644 --- a/translated/tech/20180606 Getting started with Buildah.md +++ b/translated/tech/20180606 Getting started with Buildah.md @@ -1,14 +1,18 @@ Buildah 入门 ====== + +> Buildah 提供一种灵活、可脚本编程的方式，来使用你熟悉的工具创建精简、高效的容器镜像。 + ![](https://opensource.com/sites/default/files/styles/image-full-size/public/lead-images/blocks_building.png?itok=eMOT-ire) -[Buildah][1] 是一个命令行工具，可以方便、快捷的构建与[开放容器标准Open Container Initiative, OCI][2]兼容的容器镜像，意味着构建的镜像也与 Docker 和 Kubernetes 兼容。该工具可作为 Docker 守护进程 `docker build` 命令（即使用传统的 Dockerfile 构建镜像）的一种简单drop-in替换，而且更加灵活，允许构建镜像时使用你擅长的工具。Buildah 可以轻松与脚本集成并生成流水线pipelines，最好之处在于构建镜像不再需要运行容器守护进程（LCTT 译注：这里主要是指 Docker 守护进程）。 +[Buildah][1] 是一个命令行工具，可以方便、快捷的构建与[开放容器标准][2]Open Container Initiative（OCI）兼容的容器镜像，这意味着其构建的镜像与 Docker 和 Kubernetes 兼容。该工具可作为 Docker 守护进程 `docker build` 命令（即使用传统的 Dockerfile 构建镜像）的一种简单drop-in替换，而且更加灵活，允许构建镜像时使用你擅长的工具。Buildah 可以轻松与脚本集成并生成流水线pipeline，最好之处在于构建镜像不再需要运行容器守护进程（LCTT 译注：这里主要是指 Docker 守护进程）。 ### docker build 的简单替换 -目前你可能使用 Dockerfile 和 `docker build` 命令构建镜像，那么你可以马上使用 Buildah 进行替代。Buildah 的 `build-using-dockerfile` 或 `bud` 子命令与 `docker build` 基本等价，因此可以轻松的与已有脚本结合或构建流水线。 +目前你可能使用 Dockerfile 和 `docker build` 命令构建镜像，那么你可以马上使用 Buildah 进行替代。Buildah 的 `build-using-dockerfile` （或 `bud`）子命令与 `docker build` 基本等价，因此可以轻松的与已有脚本结合或构建流水线。 + +类似我的上一篇关于 Buildah 的[文章][3]，我也将以使用源码安装 “GNU Hello” 为例进行说明，对应的 Dockerfile 文件如下： -类似我的上一篇关于 Buildah 的[文章][3]，我也将以使用源码安装 "GNU Hello" 为例进行说明，对应的 Dockerfile 文件如下： ``` FROM fedora:28 LABEL maintainer Chris Collins @@ -27,10 +31,10 @@ RUN make RUN make install RUN hello -v ENTRYPOINT "/usr/local/bin/hello" - ``` 使用 Buildah 从 Dockerfile 构建镜像也很简单，使用 `buildah bud -t hello .` 替换 `docker build -t hello .` 即可： + ``` [chris@krang] $ sudo buildah bud -t hello . STEP 1: FROM fedora:28 @@ -45,19 +49,19 @@ STEP 2: LABEL maintainer Chris Collins STEP 3: RUN dnf install -y tar gzip gcc make    && dnf clean all <考虑篇幅，略去后续输出> - ``` 镜像构建完毕后，可以使用 `buildah images` 命令查看这个新镜像： + ``` [chris@krang] $ sudo buildah images IMAGE ID        IMAGE NAME                              CREATED AT              SIZE 30190780b56e    docker.io/library/fedora:28             Mar 7, 2018 16:53       247 MB 6d54bef73e63    docker.io/library/hello:latest    May 3, 2018 15:24     391.8 MB - ``` -新镜像的标签为 `hello:latest`，我们可以将其推送至远程镜像仓库，可以使用 [CRI-O][4] 或其它 Kubernetes CRI 兼容的运行时运行该镜像，也可以推送到远程仓库。如果你要测试对 Docker build 命令的替代性，你可以将镜像拷贝至 docker 守护进程的本地镜像存储中，这样 Docker 也可以使用该镜像。使用 `buildah push` 可以很容易的完成推送操作： +新镜像的标签为 `hello:latest`，我们可以将其推送至远程镜像仓库，可以使用 [CRI-O][4] 或其它 Kubernetes CRI 兼容的运行时来运行该镜像，也可以推送到远程仓库。如果你要测试对 Docker build 命令的替代性，你可以将镜像拷贝至 docker 守护进程的本地镜像存储中，这样 Docker 也可以使用该镜像。使用 `buildah push` 可以很容易的完成推送操作： + ``` [chris@krang] $ sudo buildah push hello:latest docker-daemon:hello:latest Getting image source signatures @@ -76,12 +80,11 @@ docker.io/hello      latest       6d54bef73e63  2 minutes ago   398 MB [chris@krang] $ sudo docker run -t hello:latest Hello, world! - ``` ### 若干差异 -与 Docker build 不同，Buildah 不会自动的将 Dockerfile 中的每条指令产生的变更提到到新的分层layer中，只是简单的每次从头到尾执行构建。类似于自动化automation和流水线构建build pipelines，这种无缓存构建non-cached方式的好处是可以提高构建速度，在指令较多时尤为明显。从自动部署automated deployment或持续交付continuous delivery的视角来看，使用这种方式可以快速的将新变更落实到生产环境中。 +与 Docker build 不同，Buildah 不会自动的将 Dockerfile 中的每条指令产生的变更提到新的分层layer中，只是简单的每次从头到尾执行构建。类似于自动化automation和流水线构建build pipeline，这种无缓存构建non-cached方式的好处是可以提高构建速度，在指令较多时尤为明显。从自动部署automated deployment或持续交付continuous delivery的视角来看，使用这种方式可以快速的将新变更落实到生产环境中。 但从实际角度出发，缓存机制的缺乏对镜像开发不利，毕竟缓存层可以避免一遍遍的执行构建，从而显著的节省时间。自动分层只在 `build-using-dockerfile` 命令中生效。但我们在下面会看到，Buildah 原生命令允许我们选择将变更提交到硬盘的时间，提高了开发的灵活性。 @@ -89,7 +92,8 @@ Hello, world! Buildah _真正_ 有趣之处在于它的原生命令，你可以在容器构建过程中使用这些命令进行交互。相比与使用 `build-using-dockerfile/bud` 命令执行每次构建，Buildah 提供命令让你可以与构建过程中的临时容器进行交互。（Docker 也使用临时或 _中间_ intermediate容器，但你无法在镜像构建过程中与其交互。） -还是使用 "GNU Hello" 为例，考虑使用如下 Buildah 命令构建的镜像： +还是使用 “GNU Hello” 为例，考虑使用如下 Buildah 命令构建的镜像： + ``` #!/usr/bin/env bash @@ -123,18 +127,18 @@ buildah config --entrypoint /usr/local/bin/hello $container # Finally saves the running container to an image buildah commit --format docker $container hello:latest - ``` 我们可以一眼看出这是一个 Bash 脚本而不是 Dockerfile。基于 Buildah 的原生命令，可以轻易的使用任何脚本语言或你擅长的自动化工具编写脚本。形式可以是 makefile、Python 脚本或其它你擅长的类型。 -这个脚本做了哪些工作呢？首先，Buildah 命令 `container=$(buildah from fedora:28)` 基于 fedora:28 镜像创建了一个正在运行的容器，将容器名（buildah from 命令的返回值）保存到变量中，便于后续使用。后续所有命令都是有 $container 变量指明需要操作的容器。这些命令的功能大多可以从名称看出：`buildah copy` 将文件拷贝至容器，`buildah run` 会在容器中执行命令。可以很容易的将上述命令与 Dockerfile 中的指令对应起来。 +这个脚本做了哪些工作呢？首先，Buildah 命令 `container=$(buildah from fedora:28)` 基于 fedora:28 镜像创建了一个正在运行的容器，将容器名（`buildah from` 命令的返回值）保存到变量中，便于后续使用。后续所有命令都是有 `$container` 变量指明需要操作的容器。这些命令的功能大多可以从名称看出：`buildah copy` 将文件拷贝至容器，`buildah run` 会在容器中执行命令。可以很容易的将上述命令与 Dockerfile 中的指令对应起来。 -最后一条命令 `buildah commit` 将容器提交到硬盘上的镜像中。当不使用 Dockerfile 而是使用 Buildah 命令构建镜像时，你可以使用 `commit` 命令决定何时保存变更。在上例中，所有的变更是一起提交的；但也可以增加中间提交，让你可以选择作为起点的缓存点cache points。（例如，执行完 `dnf install` 命令后将变更缓存到硬盘是特别有意义的，一方面因为该操作耗时较长，另一方面每次执行的结果也确实相同。） +最后一条命令 `buildah commit` 将容器提交到硬盘上的镜像中。当不使用 Dockerfile 而是使用 Buildah 命令构建镜像时，你可以使用 `commit` 命令决定何时保存变更。在上例中，所有的变更是一起提交的；但也可以增加中间提交，让你可以选择作为起点的缓存点cache point。（例如，执行完 `dnf install` 命令后将变更缓存到硬盘是特别有意义的，一方面因为该操作耗时较长，另一方面每次执行的结果也确实相同。） ### 挂载点，安装目录以及 chroot 另一个可以大大增加构建镜像灵活性的 Buildah 命令是 `buildah mount`，可以将容器的根目录挂载到你主机的一个挂载点上。例如： + ``` [chris@krang] $ container=$(sudo buildah from fedora:28) [chris@krang] $ mountpoint=$(sudo buildah mount ${container}) @@ -145,9 +149,10 @@ Fedora release 28 (Twenty Eight) [chris@krang] $ ls ${mountpoint} bin   dev  home  lib64          media  opt   root  sbin  sys  usr boot  etc  lib   lost+found  mnt        proc  run   srv   tmp  var - ``` -这太棒了，你可以通过挂载点交互对容器镜像进行修改。这允许你使用主机上的工具进行构建和安装软件，不用将这些构建工具打包到容器镜像本身中。例如，在我们上面的 Bash 脚本中，我们需要安装 tar、Gzip、GCC 和 make，在容器内编译 "GNU Hello"。如果使用挂载点，我仍使用同样的工具进行构建，但下载的压缩包和 tar、Gzip 等 RPM 包都在主机而不是容器和生成的镜像内： + +这太棒了，你可以通过与挂载点交互对容器镜像进行修改。这允许你使用主机上的工具进行构建和安装软件，不用将这些构建工具打包到容器镜像本身中。例如，在我们上面的 Bash 脚本中，我们需要安装 tar、Gzip、GCC 和 make，在容器内编译 “GNU Hello”。如果使用挂载点，我仍使用同样的工具进行构建，但下载的压缩包和 tar、Gzip 等 RPM 包都在主机而不是容器和生成的镜像内： + ``` #!/usr/bin/env bash @@ -174,7 +179,6 @@ chroot $mountpoint bash -c "/usr/local/bin/hello -v" buildah config --entrypoint "/usr/local/bin/hello" $container buildah commit --format docker $container hello buildah unmount $container - ``` 在上述脚本中，需要提到如下几点： @@ -185,22 +189,22 @@ buildah unmount $container 4. 这里的 `chroot` 命令用于将挂载点本身当作根路径并测试 "hello" 是否正常工作；类似于前面例子中用到的 `buildah run` 命令。 -这个脚本更加短小，使用大多数 Linux 爱好者都很熟悉的工具，最后生成的镜像也更小（没有压缩包，没有额外的软件包等）。你甚至可以使用主机系统上的包管理器为容器安装软件。例如，（出于某种原因）你希望安装 GNU Hello 的同时在容器中安装 [NGINX][5]： +这个脚本更加短小，使用大多数 Linux 爱好者都很熟悉的工具，最后生成的镜像也更小（没有 tar 包，没有额外的软件包等）。你甚至可以使用主机系统上的包管理器为容器安装软件。例如，（出于某种原因）你希望安装 GNU Hello 的同时在容器中安装 [NGINX][5]： + ``` [chris@krang] $ mountpoint=$(sudo buildah mount ${container}) [chris@krang] $ sudo dnf install nginx --installroot $mountpoint [chris@krang] $ sudo chroot $mountpoint nginx -v nginx version: nginx/1.12.1 - ``` 在上面的例子中，DNF 使用 `--installroot` 参数将 NGINX 安装到容器中，可以通过 chroot 进行校验。 ### 快来试试吧！ -Buildah 是一种轻量级、灵活的容器镜像构建方法，不需要在主机上运行完整的 Docker 守护进程。除了提供基于 Dockerfiles 构建容器的开箱即用支持，Buildah 还可以很容易的与脚本或你喜欢的构建工具相结合，特别是可以使用主机上已有的工具构建容器镜像。Buildah 生成的容器体积更小，更便于网络传输，占用更小的存储空间，而且潜在的受攻击面更小。快来试试吧！ +Buildah 是一种轻量级、灵活的容器镜像构建方法，不需要在主机上运行完整的 Docker 守护进程。除了提供基于 Dockerfile 构建容器的开箱即用支持，Buildah 还可以很容易的与脚本或你喜欢的构建工具相结合，特别是可以使用主机上已有的工具构建容器镜像。Buildah 生成的容器体积更小，更便于网络传输，占用更小的存储空间，而且潜在的受攻击面更小。快来试试吧！ -**[阅读相关的故事，[使用 Buildah 创建小体积容器][6]]** +**[阅读相关的故事，[使用 Buildah 创建小体积的容器][6]]** -------------------------------------------------------------------------------- @@ -208,8 +212,8 @@ via: https://opensource.com/article/18/6/getting-started-buildah 作者：[Chris Collins][a] 选题：[lujun9972](https://github.com/lujun9972) -译者：[译者ID](https://github.com/译者ID) -校对：[校对者ID](https://github.com/校对者ID) +译者：[pinewall](https://github.com/pinewall) +校对：[wxy](https://github.com/wxy) 本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出 @@ -219,4 +223,4 @@ via: https://opensource.com/article/18/6/getting-started-buildah [3]:http://chris.collins.is/2017/08/17/buildah-a-new-way-to-build-container-images/ [4]:http://cri-o.io/ [5]:https://www.nginx.com/ -[6]:https://opensource.com/article/18/5/containers-buildah +[6]:https://linux.cn/article-9719-1.html From ae7e535b2106fb41e38737b730a415828face4c3 Mon Sep 17 00:00:00 2001 From: "Xingyu.Wang" Date: Fri, 13 Jul 2018 23:34:48 +0800 Subject: [PATCH 2/2] PUB:20180606 Getting started with Buildah.md @pinewall https://linux.cn/article-9836-1.html --- .../tech => published}/20180606 Getting started with Buildah.md | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename {translated/tech => published}/20180606 Getting started with Buildah.md (100%) diff --git a/translated/tech/20180606 Getting started with Buildah.md b/published/20180606 Getting started with Buildah.md similarity index 100% rename from translated/tech/20180606 Getting started with Buildah.md rename to published/20180606 Getting started with Buildah.md