Woodpecker CI 高级使用指南：YAML技巧与Docker集成-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_01033/article/details/148507658

Woodpecker CI 高级使用指南：YAML技巧与Docker集成

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

引言

Woodpecker CI作为一款轻量级持续集成工具，提供了强大的YAML配置能力。本文将深入探讨Woodpecker CI的高级使用技巧，帮助开发者编写更高效、更简洁的CI/CD流水线配置。

YAML高级语法技巧

锚点与别名：消除重复配置

在复杂的CI/CD流水线中，经常会出现重复的配置项。Woodpecker CI支持YAML的锚点(Anchor)和别名(Alias)特性，可以有效减少配置冗余。

示例场景：多个步骤使用相同的Golang镜像

variables:
  - &golang_image 'golang:1.18'  # 定义锚点

steps:
  - name: test
    image: *golang_image         # 使用别名引用
    commands: go test ./...
  - name: build
    image: *golang_image         # 复用相同配置
    commands: build

这种方法不仅减少了代码量，更重要的是当需要更新镜像版本时，只需修改一处即可。

映射合并与覆盖

对于复杂的插件配置，可以使用映射合并功能组合多个配置块：

variables:
  - &base-settings
    target: dist
    recursive: false
    try: true
  - &special-options
    special: true

steps:
  - name: deploy-dev
    settings:
      <<: [*base-settings, *special-options]  # 合并两个配置映射
      try: false                               # 覆盖已有值

序列合并

命令序列也可以进行合并操作，这在准备执行环境时特别有用：

variables:
  pre_cmds: &pre_cmds
    - echo "准备环境..."
    - whoami
  post_cmds: &post_cmds
    - echo "清理环境..."

steps:
  - name: setup
    commands:
      - <<: *pre_cmds       # 前置命令
      - echo "执行核心任务"
      - <<: *post_cmds      # 后置命令

环境变量持久化

在CI/CD流程中，经常需要在不同步骤间共享数据。Woodpecker CI提供了多种方式实现这一需求。

文件共享方式

steps:
  - name: init
    commands:
      - echo "DB_HOST=localhost" >> .env
      - echo "DB_PORT=5432" >> .env

  - name: test
    commands:
      - source .env
      - echo "连接数据库: $DB_HOST:$DB_PORT"

全局环境变量

对于需要跨项目共享的变量，可以在服务器配置中定义：

WOODPECKER_ENVIRONMENT=API_KEY=123456,DB_URL=postgres://user:pass@host/db

注意：这种方式会将变量暴露给所有流水线，请谨慎使用敏感信息。

Docker-in-Docker (DinD) 集成

在CI流程中构建Docker镜像是一个常见需求，Woodpecker CI支持通过DinD方式实现。

安全注意事项

DinD需要特权模式运行，存在安全风险，因此：

仅应在可信环境中使用
必须启用项目的"Trusted"设置

完整配置示例

services:
  - name: docker
    image: docker:27.4-dind
    privileged: true
    environment:
      DOCKER_TLS_CERTDIR: /dind-certs  # 启用TLS证书
    volumes:
      - /opt/woodpeckerci/dind-certs:/dind-certs  # 共享证书目录
    ports:
      - 2376

steps:
  - name: build-image
    image: docker:27.4-cli
    environment:
      DOCKER_HOST: "tcp://docker:2376"  # 连接DinD服务
      DOCKER_CERT_PATH: "/dind-certs/client"
      DOCKER_TLS_VERIFY: "1"
    volumes:
      - /opt/woodpeckerci/dind-certs:/dind-certs
    commands:
      - docker build -t myapp .
      - docker images