feat: rename rails/ to tools/ and add service tool suites (#4)
Co-authored-by: Jason Woltje <jason@diversecanvas.com> Co-committed-by: Jason Woltje <jason@diversecanvas.com>
This commit was merged in pull request #4.
This commit is contained in:
58
tools/woodpecker/README.md
Normal file
58
tools/woodpecker/README.md
Normal file
@@ -0,0 +1,58 @@
|
||||
# Woodpecker CI Tool Suite
|
||||
|
||||
Interact with Woodpecker CI pipelines (list builds, check status, trigger builds).
|
||||
|
||||
## Prerequisites
|
||||
|
||||
- `jq` and `curl` installed
|
||||
- Woodpecker credentials in `~/src/jarvis-brain/credentials.json`
|
||||
|
||||
## Setup
|
||||
|
||||
A Woodpecker API token is required. To configure:
|
||||
|
||||
1. Go to Woodpecker CI → User Settings → API
|
||||
2. Generate a personal token
|
||||
3. Add to `credentials.json`:
|
||||
|
||||
```json
|
||||
{
|
||||
"woodpecker": {
|
||||
"url": "https://ci.mosaicstack.dev",
|
||||
"token": "YOUR_TOKEN_HERE"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## Scripts
|
||||
|
||||
| Script | Purpose |
|
||||
|--------|---------|
|
||||
| `pipeline-list.sh` | List recent pipelines for a repo |
|
||||
| `pipeline-status.sh` | Get status of a specific or latest pipeline |
|
||||
| `pipeline-trigger.sh` | Trigger a new pipeline build |
|
||||
|
||||
## Common Options
|
||||
|
||||
- `-r owner/repo` — Repository (auto-detected from git remote if omitted)
|
||||
- `-f json` — JSON output (default: table)
|
||||
- `-h` — Show help
|
||||
|
||||
## API Reference
|
||||
|
||||
- Base URL: `https://ci.mosaicstack.dev`
|
||||
- API prefix: `/api/`
|
||||
- Auth: Bearer token in `Authorization` header
|
||||
|
||||
## Examples
|
||||
|
||||
```bash
|
||||
# List recent builds
|
||||
~/.config/mosaic/tools/woodpecker/pipeline-list.sh
|
||||
|
||||
# Check latest build status
|
||||
~/.config/mosaic/tools/woodpecker/pipeline-status.sh
|
||||
|
||||
# Trigger a build on a specific branch
|
||||
~/.config/mosaic/tools/woodpecker/pipeline-trigger.sh -b feature/my-branch
|
||||
```
|
||||
Reference in New Issue
Block a user