Woodpecker CI 入门指南：创建你的第一个持续集成流水线-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00401/article/details/148507912

Woodpecker CI 入门指南：创建你的第一个持续集成流水线

woodpecker Woodpecker is a simple CI engine with great extensibility. 项目地址: https://gitcode.com/gh_mirrors/wo/woodpecker

前言

Woodpecker 是一个轻量级的持续集成(CI)工具，它通过简单的 YAML 配置帮助开发者自动化构建、测试和部署流程。本文将带你从零开始创建第一个 Woodpecker 流水线，适合初次接触 CI/CD 的开发者。

准备工作

在开始之前，请确保：

你已经安装并配置好 Woodpecker 服务
你拥有一个代码仓库的管理员权限

第一步：激活代码仓库

登录 Woodpecker 控制台
在仓库列表中找到"新建仓库"选项
从你的代码托管平台(GitHub/GitLab等)选择需要激活的仓库

关键点：

必须拥有仓库的 Admin 权限
Woodpecker 会自动配置 webhook，用于监听代码变更事件

第二步：创建基础流水线配置

Woodpecker 通过检测仓库中的 .woodpecker/ 目录下的 YAML 文件来定义流水线。让我们创建一个基础配置文件：

# 文件路径：.woodpecker/my-first-workflow.yaml
when:
  - event: push
    branch: main

steps:
  - name: build
    image: debian
    commands:
      - echo "模拟构建过程"
      - echo "binary-data-123" > executable
  - name: test
    image: golang:1.16
    commands:
      - echo "开始测试..."
      - ./executable

配置解析

触发条件(when)：
- 当 main 分支有 push 操作时触发
- 支持多种事件类型：push、pull_request、tag 等
步骤定义(steps)：
- 按顺序执行 build 和 test 两个步骤
- 每个步骤运行在独立的容器环境中
- 步骤间通过工作区(workspace)共享文件
容器镜像(image)：
- 可以使用任何公开的 Docker 镜像
- 示例中使用了 debian 和 golang 官方镜像

第三步：推送并触发流水线

将配置文件推送到仓库后，Woodpecker 会自动检测并执行流水线。你可以在 Woodpecker 的界面中查看执行详情：

流水线视图展示所有步骤的执行状态
系统会自动添加一个 clone 步骤，将代码克隆到工作区
每个步骤的日志输出都可以实时查看

工作区特性：

所有步骤共享同一个工作目录
前一步骤生成的文件可以被后续步骤使用
默认路径为 /workspace

第四步：使用插件扩展功能

Woodpecker 提供了丰富的插件系统，可以轻松实现常见任务的自动化。例如使用 S3 插件上传文件：

steps:
  - name: upload-to-s3
    image: woodpeckerci/plugin-s3
    settings:
      bucket: my-bucket
      access_key: my-access-key
      secret_key:
        from_secret: aws_secret_key
      source: dist/*
      target: /deploy/