wernight/beroux-builder

wernight/beroux-builder 镜像文档

支持的标签及对应Dockerfile链接

• latest: 最新稳定版本
• 1、1.8、1.8.0（或类似版本号）: 特定Kubernetes（kubectl）版本的稳定版

镜像概述

Beroux-Builder是一个集成了构建Docker镜像和在Kubernetes上部署所需工具的镜像，包含几乎最小化的实用工具集，旨在简化项目的构建与部署流程。

核心功能和特性

• 工具集成：包含构建和部署所需的核心工具
  • docker：Docker引擎客户端
  • docker-compose：Docker容器编排工具
  • kubectl：Kubernetes命令行工具
  • envsubst：环境变量替换工具
• 自动配置：检测到Kubernetes服务账户时，自动创建kubectl上下文

使用场景

适用于CI/CD环境（如GitLab CI）中自动化构建Docker镜像并部署到Kubernetes集群的场景，简化构建部署流程，减少环境配置复杂度。

使用方法

Docker守护进程配置

使用本镜像前需提供Docker守护进程，可通过以下方式之一实现：

• 链接docker:dind服务作为Docker主机
• 挂载主机Docker socket：/var/run/docker.sock
• 设置环境变量DOCKER_HOST指向可访问的Docker守护进程地址

GitLab CI示例

在GitLab CI中使用时，可配置.gitlab-ci.yml如下：

yaml
build:
  stage: build
  image: wernight/beroux-builder
  services:
    - docker:dind
  before_script:
    - docker info
    - docker-compose version
    - docker login -u _json_key -p "$DOCKER_REGISTRY_TOKEN" https://eu.gcr.io
    - kubectl cluster-info
  script:
    - docker-compose build --pull
    - docker push my-repo/my-image
    - cat kubernetes.yml | envsubst | kubectl apply -f -

前置条件

使用上述配置需满足：

• GitLab Runner需配置为Docker模式
• 环境变量DOCKER_REGISTRY_TOKEN已设置（用于访问私有Docker仓库）
• Kubernetes服务账户已挂载（路径：/var/run/secrets/kubernetes.io/serviceaccount/）