safenetlabs/k8s-cicd

k8s CI/CD辅助工具镜像

镜像概述

本镜像集成了一系列Kubernetes (k8s) 持续集成/持续部署(CI/CD)流程中常用的工具，旨在为CI/CD管道提供一站式工具支持，避免在不同环境中重复安装和配置工具，简化K8s环境下的应用部署和管理流程。

核心功能与特性

• 工具集成：包含多种K8s CI/CD关键工具，主要包括：

  • kubectl：Kubernetes命令行工具，用于与K8s集群交互、管理资源
  • kustomize：Kubernetes配置管理工具，支持通过基础配置和覆盖配置生成最终部署配置
  • kubeseal：SealedSecrets工具，用于加密Kubernetes Secrets，使其可安全存储在版本控制系统中
  • skopeo：容器镜像管理工具，支持检查、复制、删除容器镜像，无需完整容器运行时
  • j2 cli：Jinja2模板渲染工具，用于动态生成配置文件

• 轻量级设计：基于精简基础镜像构建，减少镜像体积，适合CI/CD管道快速拉取和运行

• 多工具协同：工具间版本兼容，确保在CI/CD流程中可无缝配合使用

使用场景与适用范围

• CI/CD管道集成：适用于Jenkins、GitLab CI/CD、GitHub Actions、GitLab Runner等CI/CD平台，作为执行K8s相关操作的运行环境
• K8s配置管理：使用kustomize进行配置的构建、验证和应用
• 镜像管理：通过skopeo检查、复制或推送容器镜像到镜像仓库
• 密钥管理：使用kubeseal加密Secrets，实现敏感信息的安全版本控制
• 配置模板渲染：通过j2 cli基于环境变量或配置文件动态生成K8s资源配置

使用方法与配置说明

拉取镜像

bash
docker pull [镜像仓库地址]/k8s-ci-cd-helpers:latest

基本使用（docker run）

运行容器并进入交互式终端，直接使用工具：

bash
docker run -it --rm [镜像仓库地址]/k8s-ci-cd-helpers:latest /bin/sh

进入容器后，可直接调用工具：

bash
# 查看kubectl版本
kubectl version --client

# 使用kustomize构建配置
kustomize build ./kustomize-dir

# 加密Secrets（需提前配置SealedSecrets控制器）
kubeseal < secret.yaml > sealed-secret.yaml

# 使用skopeo复制镜像
skopeo copy docker://source-image:tag docker://target-registry/image:tag

# 使用j2渲染模板
j2 template.yaml.j2 -o output.yaml

在CI/CD管道中使用（以GitLab CI为例）

在.gitlab-ci.yml中配置作业，使用该镜像执行K8s部署操作：

yaml
deploy-to-k8s:
  image: [镜像仓库地址]/k8s-ci-cd-helpers:latest
  stage: deploy
  script:
    - kubectl config use-context my-k8s-cluster
    - kustomize build ./k8s-config | kubectl apply -f -
    - echo "部署完成"
  only:
    - main

挂载配置文件（可选）

如需持久化工具配置（如kubectl配置、skopeo认证等），可通过挂载本地目录到容器：

bash
docker run -it --rm \
  -v ~/.kube:/root/.kube \  # 挂载kubectl配置
  -v ~/.skopeo:/root/.skopeo \  # 挂载skopeo配置
  [镜像仓库地址]/k8s-ci-cd-helpers:latest /bin/sh

注意事项

• 使用kubectl前需确保已配置K8s集群访问凭证（可通过挂载~/.kube/config或设置环境变量KUBECONFIG）
• 使用kubeseal需确保目标K8s集群已部署SealedSecrets控制器，且本地已获取对应的公钥（可通过kubeseal --fetch-cert获取）
• 工具版本可能随镜像更新而变化，建议在生产环境中使用固定版本标签（如:v1.0.0）而非:latest