chefworks/ci-helper

镜像概述

该Docker镜像专为Gitlab CI/CD流水线设计，旨在简化CI流程中容器化和Kubernetes相关操作的执行。通过预先集成docker-cli、kubectl、docker-compose等工具，避免了在CI作业中手动安装依赖的步骤，有效提升流水线效率和稳定性，适用于各类基于Gitlab CI的自动化构建、测试和部署场景。

核心功能和特性

工具集成

• docker-cli：支持Docker镜像的构建、标记、推送等标准操作
• kubectl：提供Kubernetes集群资源管理能力，可执行部署、扩展、配置更新等命令
• docker-compose：支持多容器应用的编排和管理，适用于本地测试或多服务部署场景
• （可选）基础工具集：根据版本可能包含git、curl、jq等辅助工具，满足基础脚本执行需求

核心特性

• 轻量级：基于精简基础镜像构建，减少CI作业启动时间
• 兼容性：兼容主流Gitlab Runner环境，支持Linux/amd64等常见架构
• 易用性：无需额外配置即可直接集成到.gitlab-ci.yml，开箱即用

使用场景和适用范围

典型使用场景

• Docker镜像构建与推送：在CI流水线中自动化构建应用镜像并推送到私有/公共仓库
• Kubernetes部署：通过kubectl在CI流程中直接部署应用到Kubernetes集群，实现自动化发布
• 多容器应用测试：使用docker-compose启动多容器依赖环境（如数据库、缓存服务）进行集成测试
• 容器化CI/CD全流程：覆盖从代码构建、镜像打包到集群部署的完整自动化流程

适用范围

• Gitlab CI/CD环境（需配合Gitlab Runner使用）
• 开发团队的自动化构建、测试、部署流程
• 需要在CI中执行容器化操作（Docker/Kubernetes）的场景

使用方法和配置说明

基本使用方式

在.gitlab-ci.yml文件中通过image字段指定该镜像，即可在CI作业中直接使用集成工具：

示例1：构建并推送Docker镜像

yaml
build-and-push:
  stage: build
  image: [镜像名称]  # 替换为实际镜像名称
  script:
    - docker login -u $DOCKER_REGISTRY_USER -p $DOCKER_REGISTRY_PASSWORD $DOCKER_REGISTRY
    - docker build -t $DOCKER_REGISTRY/my-app:$CI_COMMIT_SHA .
    - docker push $DOCKER_REGISTRY/my-app:$CI_COMMIT_SHA
  only:
    - main

示例2：使用kubectl部署到Kubernetes

yaml
deploy-to-k8s:
  stage: deploy
  image: [镜像名称]  # 替换为实际镜像名称
  script:
    - kubectl config use-context my-cluster  # 切换集群上下文（如需）
    - kubectl apply -f k8s/deployment.yaml
    - kubectl rollout status deployment/my-app
  environment:
    name: production
  only:
    - main

环境变量配置

在Gitlab项目的「设置 > CI/CD > 变量」中配置以下常用环境变量：

注意事项

• 确保Gitlab Runner具备足够权限（如Docker-in-Docker配置或访问宿主机Docker套接字）
• 敏感信息（如认证凭证）需通过Gitlab CI变量存储，并设置为「保护」和「掩码」状态
• 建议使用固定版本标签而非latest，确保CI流程稳定性