zt-closet-backend/.codebuddy/plans/gitea流水线checkout改用gitee镜像_e665acda.md

name, overview, todos

name	overview	todos
gitea流水线checkout改用gitee镜像	将 .gitea/workflows 下三个工作流的 actions/checkout@v4 替换为 Gitee 镜像 https://gitee.com/liu_zhengchi/checkout@v4。	id content status replace-checkout-ref 将 3 个 .gitea/workflows 文件的 actions/checkout@v4 替换为 Gitee 镜像地址 completed id content status dependencies verify-workflows 确认三处均已替换、无残留 actions/checkout@v4 且 YAML 结构完整 completed replace-checkout-ref

产品概述

将 Gitea Actions 流水线中的代码拉取步骤，从官方 actions/checkout@v4 替换为 Gitee 镜像 https://gitee.com/liu_zhengchi/checkout@v4，以解决 runner 无法访问 GitHub 拉取官方 action 的问题。

核心功能

• 替换仓库 .gitea/workflows/ 下 3 个工作流的「拉取代码」步骤引用：
• deploy.yaml（构建并部署）
• mysqlup.yaml（数据库迁移-升级）
• mysqldown.yaml（数据库迁移-回滚）
• 仅替换 checkout 的 uses 引用，保持步骤名、其他步骤（docker 构建/推送、SSH 部署、迁移执行）与 env 变量不变。

技术栈

• Gitea Actions（GitHub Actions 兼容语法），工作流文件为 YAML
• 目标引用：uses: https://gitee.com/liu_zhengchi/checkout@v4（Gitea 支持在 uses 中使用完整 URL 引用外部实例 action）

实现方式

将 3 个文件中唯一一处的 uses: actions/checkout@v4 精确替换为 uses: https://gitee.com/liu_zhengchi/checkout@v4。

• 已验证 https://gitee.com/liu_zhengchi/checkout 为 actions/checkout 的 Gitee 镜像（含 action.yml），且存在 v4 标签（另有 v4.4.0 / v4.3.1），故沿用现有 @v4 版本号，保持行为一致。
• 保留步骤名 - name: 拉取代码 与缩进层级，避免 YAML 结构变化。

实现注意

• 每个文件仅一处匹配，直接替换即可，禁止改动其余步骤与 env。
• 镜像为第三方账号维护，属预期选择（用户指定），不做额外引入；凭据相关配置（secrets）保持原样，不新增 token/ssh-key。
• 修改后确认三处均已替换且无残留 actions/checkout@v4。

目录结构

zt-closet-backend/
└── .gitea/
    └── workflows/
        ├── deploy.yaml     # [MODIFY] 第 20-21 行「拉取代码」步骤 uses 改为 https://gitee.com/liu_zhengchi/checkout@v4
        ├── mysqlup.yaml    # [MODIFY] 第 25-26 行「拉取代码」步骤 uses 改为 https://gitee.com/liu_zhengchi/checkout@v4
        └── mysqldown.yaml  # [MODIFY] 第 34-35 行「拉取代码」步骤 uses 改为 https://gitee.com/liu_zhengchi/checkout@v4