dockhand 0.4.0

FORK

虽然https://github.com/6si/shipwright将保持更新，但我只能访问PyPI上的dockhand名称。

Shipwright在git仓库中按正确顺序构建共享Docker镜像，并使用git的修订/分支信息进行标记发布，这样您就永远不会失去对镜像来源的追踪。

这是构建和发布您的镜像到Docker Hub或您自己的私有仓库等地方的完美工具。查看我们的动机，了解我们为什么构建它以及它为您解决了哪些痛点。

安装

Shipwright是一个简单的Python脚本，您可以使用pip进行安装

$ pip install shipwright

快速入门

安装后，只需将您的项目切换到包含多个Dockerfile且在git中的项目。

在项目的根目录中添加一个名为.shipwright.json的json格式文件。至少它应包含Shipwright配置的版本号和一个namespace，该namespace是您的Docker Hub用户名或您的私有仓库的URL。

1.0是当前版本的配置。

{
  "version": 1.0,
  "namespace": "[your docker hub name or private repository]"
}

此外，您的配置文件可以将目录名称映射到替代的Docker仓库。例如，这里有一个为Docker Hub用户 shipwright 创建的 .shipwright.json 文件，它将git仓库的根目录映射到Docker镜像 shipwright/shared，以及将 /foo 目录映射到 shipwright/awesome_sauce。

{
  "version": 1.0,

  "namespace": "shipwright",
  "names": {
    "/": "shipwright/shared",
    "/foo": "shipwright/awesome_sauce"
}

现在，您只需将目录切换到您的git仓库下的任何目录，并运行

$ shipwright

这将递归遍历所有目录，查找包含Dockerfile的目录。Shipwright将按顺序构建这些Dockerfile，并默认使用 <namespace>/<dirname>:<git commit> 标签进行标记，以及 <namespace>/<dirname>:<git branch> 和 <namespace>/<dirname>:latest

$ git clone https://github.com/6si/shipwright-sample.git
$ cd shipwright-sample
$ shipwright

$ git checkout new_feature
$ shipwright

构建

默认情况下，如果您不提供任何参数运行shipwright，它将构建您的git仓库中的所有Dockerfile。您可以通过指定一个或多个 specifiers 来选择构建更少的镜像。例如，您可以通过在命令行上指定其名称来构建单个镜像及其依赖项。

$ shipwright <namespace>/some_image

运行 `shipwright –help’ 获取更多有关specifiers及其用法的示例。

发布

Shipwright可以使用一条命令构建您的镜像并将它们推送到远程仓库。

$ shipwright push

如果您愿意，您可以直接推送最新的镜像而不进行构建。

$ shipwright push --no-build

构建时使用的相同specifiers也可以与 push 一起使用。您可以使用此功能在一步中构建整个树，然后推送特定的镜像，如下所示。

$ shipwright build
$ shipwright push -e <namespace>/public_image