Binary to Image:发布制品到 Kubernetes

Binary-to-Image (B2I) 是一个工具箱和工作流,用于从二进制可执行文件(例如 Jar、War 和二进制包)构建可再现容器镜像。更确切地说,您可以上传一个制品并指定一个目标仓库,例如 Docker Hub 或者 Harbor,用于推送镜像。如果一切运行成功,会推送您的镜像至目标仓库,并且如果您在工作流中创建服务 (Service),也会自动部署应用程序至 Kubernetes。

在 B2I 工作流中,您不需要编写 Dockerfile。这不仅能降低学习成本,也能提升发布效率,使用户更加专注于业务。

本教程演示在 B2I 工作流中基于制品构建镜像的两种不同方式。最终,镜像会发布至 Docker Hub。

以下是一些示例制品,用于演示和测试,您可以用来实现 B2I 工作流:

制品包 GitHub 仓库
b2i-war-java8.war spring-mvc-showcase
b2i-war-java11.war springmvc5
b2i-binary devops-go-sample
b2i-jar-java11.jar java-maven-example
b2i-jar-java8.jar devops-maven-sample

视频演示

准备工作

  • 您已启用 KubeSphere DevOps 系统
  • 您需要创建一个 Docker Hub 帐户,也支持 GitLab 和 Harbor。
  • 您需要创建一个企业空间、一个项目和一个用户 (project-regular),请务必邀请该用户至项目中并赋予 operator 角色。有关更多信息,请参见创建企业空间、项目、用户和角色
  • 设置一个 CI 专用节点用于构建镜像。该操作不是必需,但建议开发和生产环境进行设置,专用节点会缓存依赖项并缩短构建时间。有关更多信息,请参见为缓存依赖项设置 CI 节点

使用 Binary-to-Image (B2I) 创建服务

下图中的步骤展示了如何在 B2I 工作流中通过创建服务来上传制品、构建镜像并将其发布至 Kubernetes。

服务构建

步骤 1:创建 Docker Hub 保密字典

您必须创建 Docker Hub 保密字典,以便将通过 B2I 创建的 Docker 镜像推送至 Docker Hub。以 project-regular 身份登录 KubeSphere,转到您的项目并创建一个 Docker Hub 保密字典。有关更多信息,请参见创建常用保密字典

步骤 2:创建服务

  1. 在该项目中,转到应用负载下的服务,点击创建

  2. 下拉至通过制品构建服务,选择 WAR。本教程使用 spring-mvc-showcase 项目作为示例并上传 WAR 制品至 KubeSphere。设置一个名称,例如 b2i-war-java8,点击下一步

  3. 构建设置页面,请提供以下相应信息,并点击下一步

    服务类型:本示例选择无状态服务。有关不同服务的更多信息,请参见服务类型

    制品文件:上传 WAR 制品 (b2i-war-java8)。

    构建环境:选择 kubesphere/tomcat85-java8-centos7:v2.1.0

    镜像名称:输入 <DOCKERHUB_USERNAME>/<IMAGE NAME><HARBOR-PROJECT_NAME>/<IMAGE NAME> 作为镜像名称。

    镜像标签:镜像标签,请输入 latest

    目标镜像仓库:镜像会推送至 Docker Hub,故请选择 Docker Hub 保密字典。

  4. 容器组设置页面,下拉至端口设置,为容器设置访问策略。协议选择 HTTP,自定义名称(例如 http-port),容器端口服务端口都输入 8080。点击下一步继续。

    备注

    有关如何在容器设置页面设置其他参数的更多信息,请参见容器组设置
  5. 存储卷设置页面,您可以为容器添加存储卷。有关更多信息,请参见存储卷

  6. 高级设置页面,选中外部访问并选择 NodePort 作为访问方式。点击创建完成整个操作过程。

  7. 点击左侧导航栏的镜像构建器,您可以看到正在构建示例镜像。

步骤 3:查看结果

  1. 稍等片刻,您可以看到镜像构建器状态变为成功

  2. 点击该镜像前往其详情页面。在任务记录下,点击记录右侧的 查看构建日志。如果一切运行正常,您可以在日志末尾看到 Build completed successfully

  3. 回到服务部署任务页面,您可以看到该镜像相应的服务、部署和任务都已成功创建。

  4. 在您的 Docker Hub 仓库,您可以看到 KubeSphere 已经向仓库推送了带有预期标签的镜像。

步骤 4:访问 B2I 服务

  1. 服务页面,请点击 B2I 服务前往其详情页面,您可以查看暴露的端口号。

  2. 通过 http://<Node IP>:<NodePort>/<Binary-Package-Name>/ 访问服务。

    备注

    取决于您的部署环境,您可能需要在安全组中放行端口并配置端口转发规则。

使用 Image Builder 构建镜像

前述示例通过创建服务来实现整个 B2I 工作流。此外,您也可以直接使用镜像构建器基于制品构建镜像,但这个方式不会将镜像发布至 Kubernetes。

build-binary

备注

请确保您已经创建了 Docker Hub 保密字典。有关更多信息,请参见创建常用保密字典

步骤 1:上传制品

  1. project-regular 身份登录 KubeSphere,转到您的项目。

  2. 在左侧导航栏中选择镜像构建器,然后点击创建

  3. 在弹出的对话框中,选择 二进制 并点击下一步

  4. 构建设置页面,请提供以下相应信息,然后点击创建

    上传制品:下载 b2i-binary 并上传至 KubeSphere。

    构建环境:选择 kubesphere/s2i-binary:v2.1.0

    镜像名称:自定义镜像名称。

    镜像标签:镜像标签,请输入 latest

    目标镜像仓库:镜像会推送至 Docker Hub,故请选择 Docker Hub 保密字典。

  5. 镜像构建器页面,您可以看到正在构建镜像。

步骤 2:检查结果

  1. 稍等片刻,您可以看到镜像构建器状态变为成功

  2. 点击该镜像构建器前往其详情页面。在任务记录下,点击记录右侧的 查看构建日志。如果一切运行正常,您可以在日志末尾看到 Build completed successfully

  3. 前往任务页面,您可以看到该镜像相应的任务已成功创建。

  4. 在您的 Docker Hub 仓库,您可以看到 KubeSphere 已经向仓库推送了带有预期标签的镜像。

通过邮件接收 KubeSphere 最新的技术博客与产品更新的通知


感谢您的反馈。如果您有关于如何使用 KubeSphere 的具体问题,请在 Slack 上提问。如果您想报告问题或提出改进建议,请在 GitHub 存储库中打开问题。