oussamadouhou/ai-stack-deployer
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: add Gitea Actions workflow status checking documentation

Browse Source 
- Add API endpoint and curl commands to check CI status
- Document authentication with Authorization: token header
- Add response field descriptions (status, conclusion)
- Reference BWS key for GITEA_API_TOKEN
This commit is contained in:
Oussama Douhou
2026-01-10 14:38:53 +01:00
parent f5f10ed6c4
commit 8b1556c034
2 changed files with 94 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

33
CLAUDE.md
View File

@@ -416,6 +416,39 @@ Grafana service account token stored in BWS:
- Key: `GRAFANA_OPENCODE_ACCESS_TOKEN` - Key: `GRAFANA_OPENCODE_ACCESS_TOKEN`
- BWS ID: `c77e58e3-fb34-41dc-9824-b3ce00da18a0` - BWS ID: `c77e58e3-fb34-41dc-9824-b3ce00da18a0`
## CI/CD - Gitea Actions
The `oh-my-opencode-free` Docker image is built automatically via Gitea Actions on push to main.
### Check Workflow Status
**Web UI:**
```
https://git.app.flexinit.nl/oussamadouhou/oh-my-opencode-free/actions
```
**API:**
```bash
# Get token from BWS (key: GITEA_API_TOKEN)
GITEA_TOKEN="<token>"
# List recent runs with status
curl -s -H "Authorization: token $GITEA_TOKEN" \
"https://git.app.flexinit.nl/api/v1/repos/oussamadouhou/oh-my-opencode-free/actions/runs?limit=5" | \
jq '.workflow_runs[] | {run_number, status, conclusion, display_title, head_sha: .head_sha[0:7]}'
```
### API Response Fields
| Field | Values |
|-------|--------|
| `status` | `queued`, `in_progress`, `completed` |
| `conclusion` | `success`, `failure`, `cancelled`, `skipped` |
### Credentials
- **GITEA_API_TOKEN** - Gitea API access (stored in BWS)
## Project Status ## Project Status
✅ **Completed**: ✅ **Completed**:

61
docs/TESTING.md
View File

@@ -200,3 +200,64 @@ source .env && curl -s -H "x-api-key: $DOKPLOY_API_TOKEN" \
"https://app.flexinit.nl/api/project.one?projectId=<PROJECT_ID>" | \ "https://app.flexinit.nl/api/project.one?projectId=<PROJECT_ID>" | \
jq '.environments[0].applications[0] | {name: .name, status: .applicationStatus}' jq '.environments[0].applications[0] | {name: .name, status: .applicationStatus}'
``` ```
---
## Gitea Actions CI/CD Status
### Check Workflow Status
The `oh-my-opencode-free` Docker image is built via Gitea Actions. To check CI status:
**Web UI:**
```
https://git.app.flexinit.nl/oussamadouhou/oh-my-opencode-free/actions
```
**API (requires token):**
```bash
# Get GITEA_API_TOKEN from BWS (key: GITEA_API_TOKEN)
GITEA_TOKEN="<your-token>"
# List recent workflow runs
curl -s -H "Authorization: token $GITEA_TOKEN" \
"https://git.app.flexinit.nl/api/v1/repos/oussamadouhou/oh-my-opencode-free/actions/runs?limit=5" | \
jq '.workflow_runs[] | {id, run_number, status, conclusion, display_title, head_sha: .head_sha[0:7]}'
# Get specific run details
curl -s -H "Authorization: token $GITEA_TOKEN" \
"https://git.app.flexinit.nl/api/v1/repos/oussamadouhou/oh-my-opencode-free/actions/runs/<RUN_ID>" | jq .
# Get jobs for a specific run
curl -s -H "Authorization: token $GITEA_TOKEN" \
"https://git.app.flexinit.nl/api/v1/repos/oussamadouhou/oh-my-opencode-free/actions/runs/<RUN_ID>/jobs" | jq .
```
### API Response Fields
| Field | Description |
|-------|-------------|
| `status` | `queued`, `in_progress`, `completed` |
| `conclusion` | `success`, `failure`, `cancelled`, `skipped` (only when status=completed) |
| `head_sha` | Commit SHA that triggered the run |
| `run_number` | Sequential run number |
| `display_title` | Commit message or PR title |
### Gitea API Authentication
From [Gitea docs](https://docs.gitea.com/development/api-usage):
```bash
# Header format
Authorization: token <your-api-token>
# Alternative: query parameter
?token=<your-api-token>
```
### BWS Token Reference
| Key | Purpose |
|-----|---------|
| `GITEA_API_TOKEN` | Gitea API access for workflow status |
| `DOKPLOY_API_TOKEN` | Dokploy deployment API (BWS ID: `6b3618fc-ba02-49bc-bdc8-b3c9004087bc`) |