beforegolive
323bf9bfdb
lint / yamllint (push) Successful in 15s
撤销之前的「已迁移到 docker-gitea/ci-actions」banner——本仓库是被 docker-gitea 通过 git submodule 引用，**不是被合并**。业务仓库 workflow 'uses:' URL 仍指向本仓库（不变）。所有 action 改动 + tag 都在本仓库进行。
44 lines
1.6 KiB
Markdown
44 lines
1.6 KiB
Markdown
# gitea_admin/ci-actions
|
||
|
||
Gitea Actions 公共 action 仓库。
|
||
|
||
> **维护模式**（2026-07-16 起）：本仓库**独立发布**（自己打 tag：`v1.x.y`）。
|
||
> `gitea_admin/docker-gitea` 仓库通过 **git submodule** 把本仓库作为 `ci-actions/`
|
||
> 子目录引入，方便在 docker-gitea 仓库内查看/同步代码；
|
||
> 但所有 action 改动与发版都**在本仓库**进行（commit + push + tag），业务仓库
|
||
> workflow 的 `uses:` URL 仍指向本仓库 `http://gitea:3000/gitea_admin/ci-actions/<name>@<tag>`。
|
||
|
||
通过 `uses: gitea_admin/ci-actions/<name>@v1` 在业务 workflow 中复用，
|
||
避免每个仓库重复实现。
|
||
|
||
## 可用 action
|
||
|
||
| Action | 用途 |
|
||
|---|---|
|
||
| [`notify-bark/`](./notify-bark/) | 推送结果到 Bark iOS 客户端 |
|
||
| [`notify-email/`](./notify-email/) | 发送结果邮件（兼容 163/126 SMTP） |
|
||
|
||
## 引用示例
|
||
|
||
```yaml
|
||
- uses: gitea_admin/ci-actions/notify-bark@v1
|
||
with:
|
||
device_key: ${{ secrets.BARK_DEVICE_KEY }}
|
||
title: "[${{ github.repository }}] ${{ github.workflow }}"
|
||
body: "status: ${{ needs.build.result }}"
|
||
```
|
||
|
||
完整示例见各 action 的 README。
|
||
|
||
## 版本约定
|
||
|
||
- 首次发布打 `v1.0.0`；业务 workflow 用 `@v1`（永远指向 `v1.x.y` 最新）
|
||
- 改 bug → `v1.0.1`；兼容新 input → `v1.1.0`；breaking change → `v2.0.0`
|
||
|
||
## 添加新 action
|
||
|
||
1. 在仓库根下新建 `<action-name>/` 目录
|
||
2. 写 `action.yml`（composite / docker 形态）
|
||
3. 写 `README.md` 说明 inputs / outputs / 使用示例
|
||
4. 在本 README 的「可用 action」表格里加一行
|
||
5. 提交后打 tag `v1.x.y` |