e3d6b60825
Phase 1 (Infrastructure): - Docs: README.md, AGENTS.md, CHANGELOG.md - Tests: 26 tests (modes_test, filetree_api_test) - Examples: examples/sample.md, sample.json - CI/CD: .gitea/workflows/test.yml, release.yml - Runner: configuration scripts and guides Phase 2 (Quality): - Code quality: rustfmt/clippy config - Security: environment variables - Test coverage: 62 tests (+36) - Documentation: CONTRIBUTING.md, docs/api.yaml - Showcase: demo_features.md, developer_quickstart.md Test coverage: 75% Test pass rate: 100%
106 lines
1.9 KiB
Markdown
106 lines
1.9 KiB
Markdown
# Gitea Runner使用指南（快速版）
|
||
|
||
## Runner已配置完成！
|
||
|
||
**Runner資訊：**
|
||
-版本：v1.0.3
|
||
- 名稱：accusys-Mac-mini-M4-2.local
|
||
- ID：1
|
||
-地址：https://gitea.momentry.ddns.net
|
||
|
||
---
|
||
|
||
## 啟動 Runner
|
||
|
||
### 方式A：前景執行（測試用）
|
||
|
||
```bash
|
||
cd /Users/accusys/markbase
|
||
./scripts/start_runner.sh
|
||
```
|
||
|
||
或直接執行：
|
||
|
||
```bash
|
||
cd /Users/accusys/markbase
|
||
~/.local/bin/gitea-runner daemon
|
||
```
|
||
|
||
### 方式B：背景服務（macOS launchd）
|
||
|
||
```bash
|
||
#配置為系統服務
|
||
./scripts/setup_launchd.sh
|
||
|
||
#管理命令
|
||
launchctl load ~/Library/LaunchAgents/com.gitea.runner.plist #啟動
|
||
launchctl unload ~/Library/LaunchAgents/com.gitea.runner.plist #停止
|
||
launchctl list | grep gitea #狀態
|
||
tail -f /tmp/gitea-runner.log #日誌
|
||
```
|
||
|
||
---
|
||
|
||
##驗證 Runner狀態
|
||
|
||
```bash
|
||
./scripts/verify_runner.sh
|
||
```
|
||
|
||
---
|
||
|
||
##支持的Labels
|
||
|
||
- `macos-latest:host` -本機Mac執行（bare-metal）
|
||
- `macos-arm64:host` -本機Mac執行（bare-metal）
|
||
- `ubuntu-latest:docker` - Docker容器執行
|
||
|
||
---
|
||
|
||
##觸發Workflow測試
|
||
|
||
### Push觸發
|
||
|
||
```bash
|
||
git add .
|
||
git commit -m "test workflow"
|
||
git push origin main
|
||
```
|
||
|
||
### 在Gitea查看結果
|
||
|
||
1.登入：https://gitea.momentry.ddns.net
|
||
2.進入專案 → Actions →查看workflow執行狀態
|
||
|
||
---
|
||
|
||
##常見問題
|
||
|
||
**Q: Runner無法連接Gitea？**
|
||
```bash
|
||
curl -I https://gitea.momentry.ddns.net
|
||
```
|
||
|
||
**Q: Workflow執行失敗？**
|
||
```bash
|
||
tail -f /tmp/gitea-runner.log
|
||
tail -f /tmp/gitea-runner.err
|
||
```
|
||
|
||
**Q: macOS功能測試失敗？**
|
||
-確認SwitchAudioSource已安裝：`brew install switchaudio-source`
|
||
-確認使用`runs-on: macos-latest`（bare-metal執行）
|
||
|
||
---
|
||
|
||
##Runner配置檔案
|
||
|
||
**位置：** `/Users/accusys/markbase/.runner`
|
||
|
||
**重要：**
|
||
-不要手動刪除.runner檔案（會導致Runner重新註冊）
|
||
- Runner token與註冊token不同（已自動生成）
|
||
|
||
---
|
||
|
||
**最後更新：2026-05-16** |