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