automerge-action Docker镜像文档

镜像概述

automerge-action 是一个用于运行 conda-forge 机器人自动合并（automerge）GitHub Actions 集成的 Docker 镜像。该镜像由 autotick 机器人使用，用于在 feedstock 维护者选择启用自动合并功能时，自动合并通过检查的 Pull Request (PR)。

核心功能与特性

• 自动合并 PR：基于 GitHub Actions 集成，自动检测并合并通过所有检查的 PR。
• 维护者控制：仅当 feedstock 维护者选择启用时才触发自动合并流程。
• CI/CD 集成：与 GitHub 的状态检查（status）和检查套件（check_suite）事件联动，确保 PR 在完成所有必要检查后才合并。
• 多标签支持：提供生产环境和开发测试环境的镜像标签，满足不同阶段的使用需求。

使用场景与适用范围

该镜像主要适用于 conda-forge 生态系统中的 feedstock 项目。具体场景包括：

• feedstock 维护者希望减少手动合并 PR 的工作量。
• 需要自动化处理由 conda-forge 机器人（如 autotick）生成的常规更新 PR。
• 希望通过 GitHub Actions 实现 PR 合并流程的标准化和自动化。

重要镜像标签

使用方法与配置说明

前置条件

• 已在 GitHub 上托管的 conda-forge feedstock 项目。
• 项目维护者已选择启用自动合并功能。
• 配置 GitHub Secrets（GITHUB_TOKEN 和 RERENDERING_GITHUB_TOKEN）。

配置步骤

在项目根目录下创建 .github/workflows/automerge.yml 文件，添加以下 GitHub Actions 配置：

on:
  status: {}
  check_suite:
    types:
      - completed

jobs:
  automerge-action:
    runs-on: ubuntu-latest
    name: automerge
    steps:
      - name: 检出代码
        uses: actions/checkout@v2
      - name: 执行自动合并
        id: automerge-action
        uses: conda-forge/automerge-action@main
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}
          rerendering_github_token: ${{ secrets.RERENDERING_GITHUB_TOKEN }}

参数说明

许可证

本镜像基于 BSD-3 Clause 许可证 授权，其基础镜像基于 MIT 许可证 授权。

文档与贡献

文档资源

详细使用文档可参考上游代码库：conda-forge/automerge-action。

联系维护者

如需联系镜像维护者，请通过上游代码库提交 issue：新建 issue，并 @conda-forge/core 团队。

贡献指南

欢迎按照 conda-forge 的 行为准则 提交贡献。贡献需通过上游代码库的 Pull Request 进行：提交 PR。