Woodpecker CI 入门指南：创建你的第一个自动化构建流水线-优快云博客

Woodpecker CI 入门指南：创建你的第一个自动化构建流水线

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

什么是Woodpecker CI

Woodpecker CI是一个轻量级、开源的持续集成工具，它可以帮助开发者自动化构建、测试和部署流程。与传统CI工具相比，Woodpecker采用简单直观的YAML配置方式，让开发者能够快速上手并实现自动化工作流。

准备工作

在开始创建第一个流水线之前，你需要确保：

已经安装并配置好Woodpecker服务
拥有一个代码仓库的管理员权限
了解基本的YAML语法

第一步：激活代码仓库

登录Woodpecker控制台
在仓库列表中找到"新建仓库"选项
从列表中选择你要激活的代码仓库

注意事项：

必须拥有仓库管理员权限才能激活
Woodpecker会自动配置webhook，用于监听代码变更事件

第二步：创建第一个工作流配置

在代码仓库根目录下创建.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)：
- 按顺序执行定义的步骤
- 每个步骤运行在独立的容器环境中
- 支持自定义Docker镜像
工作区(workspace)：
- Woodpecker会自动创建并共享工作区
- 所有步骤都可以访问工作区中的文件
- 前一步骤生成的文件可以被后续步骤使用

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

将配置文件推送到代码仓库后，Woodpecker会自动检测变更并开始执行流水线。你可以在Woodpecker的UI界面中查看流水线执行状态和详细日志。

进阶技巧：使用插件简化流程

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/path

插件使用要点：