instrumentisto/gitlab-builder

GitLab Builder Docker镜像

https://github.com/instrumentisto/gitlab-builder-docker-image/actions/workflows/ci.yml/badge.svg?branch=main "CI"](https://github.com/instrumentisto/gitlab-builder-docker-image/actions?query=workflow%3ACI+branch%3Amain)

https://hub.docker.com/r/instrumentisto/gitlab-builder | https://github.com/orgs/instrumentisto/packages/container/package/gitlab-builder | Quay.io

https://github.com/instrumentisto/gitlab-builder-docker-image/blob/main/CHANGELOG.md

支持的标签及对应的Dockerfile链接

• https://github.com/instrumentisto/gitlab-builder-docker-image/blob/main/Dockerfile

什么是GitLab Builder Docker镜像？

GitLab Builder Docker镜像是包含GitLab Runner构建和部署容器化应用所需最小工具链的Docker镜像。

该镜像旨在被GitLab Runner使用，作为GitLab CI流水线中任何CI作业的通用环境。

其设计理念是：

1. 使用docker run和docker build命令构建任何项目制品，确保制品的构建环境固定且可控。
2. 在docker run和/或docker-compose环境中运行任何测试和检查。
3. 使用docker push将项目的Docker镜像推送到Docker Registry。
4. 使用helm（和/或kubectl）将项目部署到 staging/生产环境。
5. 上述步骤的命令可通过Makefile简化。

这种方式可确保项目在CI和本地开发中使用相同的环境，且任何项目所需的工具集仅包括：bash、git、make、curl、docker、docker-compose、kubectl、helm。

!Logo

核心功能与特性

• 完整工具链：包含构建、测试、推送和部署容器化应用所需的核心工具：
  • 基础工具：bash、git、make、curl
  • 容器构建：docker（CLI）、docker-compose
  • 部署工具：kubectl（Kubernetes CLI）、helm（Kubernetes包管理器）
  • 辅助工具：reg（Docker Registry CLI）、releasecli（GitLab Release CLI）
• 环境一致性：确保CI流水线与本地开发环境使用相同工具版本，避免"在我机器上能运行"问题。
• 通用适配性：适用于任何需要容器化构建和部署的项目，无需为不同项目维护专用镜像。

使用场景与适用范围

• GitLab CI流水线：作为GitLab Runner的执行环境，运行各类CI作业（构建、测试、打包、部署）。
• 容器化项目开发：本地开发中使用该镜像作为统一环境，确保与CI流程一致。
• 多环境部署：支持通过kubectl和helm将应用部署到Kubernetes集群（开发、测试、生产环境）。
• 制品管理：通过docker push和reg管理Docker镜像，通过releasecli创建GitLab Release。

使用方法

在GitLab CI中使用

在项目的.gitlab-ci.yml中指定该镜像作为作业执行环境：

yaml
image: instrumentisto/gitlab-builder:latest

stages:
  - build
  - test
  - deploy

build-artifact:
  stage: build
  script:
    - make build  # 假设项目通过Makefile定义构建步骤，内部调用docker build等命令

test-app:
  stage: test
  script:
    - docker-compose -f docker-compose.test.yml up --abort-on-container-exit

deploy-to-k8s:
  stage: deploy
  script:
    - kubectl config use-context my-cluster
    - helm upgrade --install my-app ./charts/my-app

许可证

• https://github.com/docker/docker-ce/blob/master/components/cli 采用 https://github.com/docker/docker-ce/blob/master/components/cli/LICENSE 许可证。
• Docker Compose CLI 采用 https://github.com/docker/compose/blob/master/LICENSE 许可证。
• Kubernetes CLI (kubectl) 采用 https://github.com/kubernetes/kubernetes/blob/master/LICENSE 许可证。
• Helm 采用 https://github.com/helm/helm/blob/master/LICENSE 许可证。
• https://github.com/genuinetools/reg 采用 https://github.com/genuinetools/reg/blob/master/LICENSE 许可证。
• GitLab Release CLI (releasecli) 采用 MIT License 许可证。

与所有Docker镜像一样，本镜像可能包含其他软件，这些软件可能采用其他许可证（如基础系统的Bash等，以及主要软件的直接或间接依赖）。使用预构建镜像时，用户有责任确保对镜像的任何使用符合其中包含的所有软件的相关许可证要求。

生成instrumentisto/gitlab-builder镜像的https://github.com/instrumentisto/gitlab-builder-docker-image采用 https://github.com/instrumentisto/gitlab-builder-docker-image/blob/main/LICENSE.md 许可证。

问题反馈

我们无法关注https://hub.docker.com（或其他容器仓库）的评论，因此请勿通过这些渠道报告问题或提问。

如遇本镜像相关问题或疑问，请通过https://github.com/instrumentisto/gitlab-builder-docker-image/issues与我们联系。