Caicloud Cyclone 云原生持续集成平台安装指南

前言

Caicloud Cyclone 是一款基于 Kubernetes 的云原生持续集成与持续交付(CI/CD)平台，它能够帮助开发团队在 Kubernetes 环境中高效地构建、测试和部署应用。本文将详细介绍如何在不同环境中安装和配置 Cyclone 平台。

系统要求

在开始安装前，请确保您的环境满足以下要求：

• Kubernetes 集群版本 1.12、1.13 或 1.14
• Helm 版本高于 2.10（推荐使用最新稳定版）
• 集群节点有足够的资源运行 Cyclone 组件
• 网络能够访问公共镜像仓库或您指定的私有镜像仓库

Helm 安装方式

1. 准备工作

Helm 是 Kubernetes 的包管理工具，使用 Helm 可以简化 Cyclone 的安装和管理过程。

首先需要初始化 Helm 并安装 Tiller（Helm 的服务端组件）：

helm init --history-max 200

2. 基础安装

最简单的安装方式是使用默认配置：

helm install --name cyclone --namespace cyclone-system ./helm/cyclone

此命令会：

1. 创建名为 cyclone-system 的命名空间
2. 从公共镜像仓库拉取所有必需镜像
3. 部署 Cyclone 所有组件

3. 自定义安装

3.1 使用私有镜像仓库

如果您的环境无法访问公共镜像仓库，或者需要使用私有镜像仓库：

helm install --name cyclone --namespace cyclone-system \
  --set imageRegistry.registry=your.private.registry,imageRegistry.project=your-project \
  ./helm/cyclone

3.2 使用自定义配置

对于生产环境，建议使用 values 文件进行详细配置：

helm install --name cyclone --namespace cyclone-system \
  -f custom-values.yaml \
  ./helm/cyclone

4. 升级与卸载

升级 Cyclone 版本：

helm upgrade cyclone ./helm/cyclone

卸载 Cyclone：

helm delete --purge cyclone

核心配置详解

1. 通用配置

参数	说明	默认值
imageRegistry.registry	镜像仓库地址	公共镜像仓库地址
imageRegistry.project	Cyclone 组件镜像所在项目	caicloud
serverAddress	Cyclone 服务器地址	cyclone-server.default.svc.cluster.local::7099

2. 工作流引擎配置

工作流引擎是 Cyclone 的核心组件，负责执行 CI/CD 流水线：

engine:
  gc:
    enabled: true  # 是否启用垃圾回收
    delaySeconds: 300  # 执行完成后保留时间(秒)
  limits:
    maxWorkflowRuns: 50  # 每个工作流保留的最大执行记录数
  resourceRequirement:  # 默认资源限制
    limits:
      cpu: 100m
      memory: 256Mi

3. 服务器配置

Cyclone 服务器提供 RESTful API 接口：

server:
  listenPort: 7099  # 服务监听端口
  init:
    defaultTenant: true  # 是否初始化默认租户
  pvc:
    size: 10Gi  # 默认 PVC 大小

4. Web 界面配置

web:
  replicas: 1  # 实例数
  nodePort: 30022  # NodePort 服务端口

从源码构建镜像

如果您需要自定义 Cyclone 组件，可以从源码构建镜像：

docker login your.private.registry -u username -p password
make push REGISTRIES=your.private.registry/your-project

然后使用自定义镜像安装：

helm install --name cyclone --namespace cyclone-system \
  --set imageRegistry.registry=your.private.registry,imageRegistry.project=your-project \
  ./helm/cyclone

安装后验证

安装完成后，可以通过以下方式验证：

1. 检查 Pod 状态：

   kubectl get pods -n cyclone-system
   

2. 访问 Web 界面（如果配置了 NodePort）：

   http://<节点IP>:30022
   

常见问题解决

1. 镜像拉取失败：检查网络连接和镜像仓库配置
2. PVC 创建失败：确认 StorageClass 配置正确
3. 资源不足：调整资源请求和限制配置

最佳实践建议

1. 生产环境建议：

   • 使用高可用配置（增加副本数）
   • 配置持久化存储
   • 设置合理的资源限制

2. 开发环境可以：

   • 启用开发模式（engine.developMode: true）
   • 使用较小的资源规格

通过本文的指导，您应该能够顺利完成 Caicloud Cyclone 的安装和基础配置。根据实际需求调整配置参数，可以充分发挥 Cyclone 在云原生 CI/CD 中的强大能力。