如何在多仓库GitHub Actions中复用MySQL服务及初始化步骤？

我负责一个依赖中心数据库的多微服务项目，每个微服务部署在独立的GitHub仓库中，且各自拥有CI/CD流水线。各仓库的流水线定义大致如下：

# validate.yaml

  ...
  tests:
    runs-on: ubuntu-latest
    services:
      mysql:
        image: mysql/mysql:8
        env:
          MYSQL_DATABASE: some_db
          MYSQL_ROOT_PASSWORD: some_pw
        ports:
          - 3306:3306
    steps:
      # init database
      - run: a number
      - run: of steps to
      - run: initialise the db
      - run: with test data that
      - is the same for each microservice
      # run tests for microservice
      - run: poetry run pytest

请问能否将上述MySQL服务配置及对应的数据库初始化步骤进行通用化定义，以便在所有微服务仓库的流水线中复用？

当然可以实现复用，GitHub Actions提供了两种主流方案来提取通用配置和步骤，适配不同的复用场景：

1. 可复用工作流（Reusable Workflows） #

适合跨仓库共享完整的作业逻辑（包括服务配置+初始化步骤+测试执行），是GitHub官方推荐的跨仓库复用方式。

实现步骤： #

• 新建一个专门的共享仓库（如shared-ci-workflows），用来存放通用工作流文件。
• 在该仓库中创建可复用工作流文件.github/workflows/mysql-test-setup.yml：

name: MySQL Test Setup
on:
  workflow_call:
    # 支持参数化，按需自定义数据库配置
    inputs:
      mysql-database:
        type: string
        default: some_db
      mysql-root-password:
        type: string
        default: some_pw

jobs:
  run-tests-with-mysql:
    runs-on: ubuntu-latest
    services:
      mysql:
        image: mysql/mysql:8
        env:
          MYSQL_DATABASE: ${{ inputs.mysql-database }}
          MYSQL_ROOT_PASSWORD: ${{ inputs.mysql-root-password }}
        ports:
          - 3306:3306
        # 添加健康检查确保MySQL就绪
        options: >-
          --health-cmd="mysqladmin ping"
          --health-interval=10s
          --health-timeout=5s
          --health-retries=3
    steps:
      # 通用数据库初始化步骤
      - run: a number
      - run: of steps to
      - run: initialise the db
      - run: with test data that
      - run: is the same for each microservice
      # 执行微服务测试（若测试命令通用可固定，否则留空让调用方扩展）
      - name: Run Service Tests
        run: poetry run pytest

• 在每个微服务仓库的流水线中调用该工作流：

name: Validate Microservice
on: [push, pull_request]

jobs:
  test:
    uses: your-org/shared-ci-workflows/.github/workflows/mysql-test-setup.yml@main
    # 按需覆盖默认参数
    with:
      mysql-database: custom_db
      mysql-root-password: custom_pw

2. 复合动作（Composite Actions） #

如果只需要复用初始化步骤集合（服务配置仍需在各仓库定义），可以用复合动作来封装步骤逻辑。

实现步骤： #

• 在共享仓库中创建复合动作文件.github/actions/mysql-init/action.yml：

name: 'MySQL Initialization'
description: 'Executes common database initialization steps'
inputs:
  mysql-database:
    type: string
    default: some_db
  mysql-root-password:
    type: string
    default: some_pw

runs:
  using: "composite"
  steps:
    # 通用初始化步骤，需指定shell类型
    - run: a number
      shell: bash
    - run: of steps to
      shell: bash
    - run: initialise the db
      shell: bash
    - run: with test data that
      shell: bash
    - run: is the same for each microservice
      shell: bash

• 在微服务仓库的流水线中定义MySQL服务，并调用复合动作：

# validate.yaml

...
tests:
  runs-on: ubuntu-latest
  services:
    mysql:
      image: mysql/mysql:8
      env:
        MYSQL_DATABASE: some_db
        MYSQL_ROOT_PASSWORD: some_pw
      ports:
        - 3306:3306
      options: >-
        --health-cmd="mysqladmin ping"
        --health-interval=10s
        --health-timeout=5s
        --health-retries=3
  steps:
    # 调用复合动作完成初始化
    - name: Initialize MySQL Database
      uses: your-org/shared-ci-workflows/.github/actions/mysql-init@main
    # 执行当前微服务的测试
    - run: poetry run pytest

注意事项 #

• 确保共享仓库的权限设置正确，所有微服务仓库都能访问该仓库的Actions资源。
• 建议给共享的工作流/动作添加版本标签（如v1），避免更新时意外影响所有微服务的流水线稳定性。
• 可根据业务需求扩展参数化配置，让通用逻辑更灵活适配不同微服务的场景。

内容的提问来源于stack exchange，提问作者Nero Vanbiervliet