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
|
||||
```
|
||||
86
tools/woodpecker/pipeline-list.sh
Executable file
86
tools/woodpecker/pipeline-list.sh
Executable file
@@ -0,0 +1,86 @@
|
||||
#!/usr/bin/env bash
|
||||
#
|
||||
# pipeline-list.sh — List Woodpecker CI pipelines
|
||||
#
|
||||
# Usage: pipeline-list.sh [-r owner/repo] [-l limit] [-f format]
|
||||
#
|
||||
# Options:
|
||||
# -r repo Repository in owner/repo format (default: current repo)
|
||||
# -l limit Number of pipelines to show (default: 20)
|
||||
# -f format Output format: table (default), json
|
||||
# -h Show this help
|
||||
#
|
||||
# Requires: woodpecker.url and woodpecker.token in credentials.json
|
||||
set -euo pipefail
|
||||
|
||||
MOSAIC_HOME="${MOSAIC_HOME:-$HOME/.config/mosaic}"
|
||||
source "$MOSAIC_HOME/tools/_lib/credentials.sh"
|
||||
|
||||
# Check if woodpecker credentials exist before loading
|
||||
CRED_FILE="${MOSAIC_CREDENTIALS_FILE:-$HOME/src/jarvis-brain/credentials.json}"
|
||||
if ! jq -e '.woodpecker.token // empty | select(. != "")' "$CRED_FILE" &>/dev/null; then
|
||||
echo "Error: Woodpecker API token not configured in credentials.json" >&2
|
||||
echo "" >&2
|
||||
echo "To configure:" >&2
|
||||
echo " 1. Get your token from Woodpecker CI → User Settings → API" >&2
|
||||
echo " 2. Add to credentials.json:" >&2
|
||||
echo ' "woodpecker": {"url": "https://ci.mosaicstack.dev", "token": "YOUR_TOKEN"}' >&2
|
||||
exit 1
|
||||
fi
|
||||
|
||||
load_credentials woodpecker
|
||||
|
||||
REPO=""
|
||||
LIMIT=20
|
||||
FORMAT="table"
|
||||
|
||||
while getopts "r:l:f:h" opt; do
|
||||
case $opt in
|
||||
r) REPO="$OPTARG" ;;
|
||||
l) LIMIT="$OPTARG" ;;
|
||||
f) FORMAT="$OPTARG" ;;
|
||||
h) head -14 "$0" | grep "^#" | sed 's/^# \?//'; exit 0 ;;
|
||||
*) echo "Usage: $0 [-r owner/repo] [-l limit] [-f format]" >&2; exit 1 ;;
|
||||
esac
|
||||
done
|
||||
|
||||
# Auto-detect repo from git remote if not specified
|
||||
if [[ -z "$REPO" ]]; then
|
||||
remote_url=$(git remote get-url origin 2>/dev/null || true)
|
||||
if [[ -n "$remote_url" ]]; then
|
||||
REPO=$(echo "$remote_url" | sed -E 's|.*[:/]([^/]+/[^/]+?)(\.git)?$|\1|')
|
||||
else
|
||||
echo "Error: -r owner/repo required (not in a git repository)" >&2
|
||||
exit 1
|
||||
fi
|
||||
fi
|
||||
|
||||
response=$(curl -sk -w "\n%{http_code}" \
|
||||
-H "Authorization: Bearer $WOODPECKER_TOKEN" \
|
||||
"${WOODPECKER_URL}/api/repos/${REPO}/pipelines?per_page=${LIMIT}")
|
||||
|
||||
http_code=$(echo "$response" | tail -n1)
|
||||
body=$(echo "$response" | sed '$d')
|
||||
|
||||
if [[ "$http_code" != "200" ]]; then
|
||||
echo "Error: Failed to list pipelines (HTTP $http_code)" >&2
|
||||
exit 1
|
||||
fi
|
||||
|
||||
if [[ "$FORMAT" == "json" ]]; then
|
||||
echo "$body" | jq '.'
|
||||
exit 0
|
||||
fi
|
||||
|
||||
echo "NUMBER STATUS BRANCH EVENT MESSAGE"
|
||||
echo "------ -------- -------------------- -------- ----------------------------------------"
|
||||
echo "$body" | jq -r '.[] | [
|
||||
(.number | tostring),
|
||||
.status,
|
||||
.branch,
|
||||
.event,
|
||||
(.message | split("\n")[0])
|
||||
] | @tsv' | while IFS=$'\t' read -r number status branch event message; do
|
||||
printf "%-6s %-8s %-20s %-8s %s\n" \
|
||||
"$number" "$status" "${branch:0:20}" "$event" "${message:0:40}"
|
||||
done
|
||||
93
tools/woodpecker/pipeline-status.sh
Executable file
93
tools/woodpecker/pipeline-status.sh
Executable file
@@ -0,0 +1,93 @@
|
||||
#!/usr/bin/env bash
|
||||
#
|
||||
# pipeline-status.sh — Check Woodpecker CI pipeline status
|
||||
#
|
||||
# Usage: pipeline-status.sh [-r owner/repo] [-n number] [-f format]
|
||||
#
|
||||
# Options:
|
||||
# -r repo Repository in owner/repo format (default: current repo)
|
||||
# -n number Pipeline number (default: latest)
|
||||
# -f format Output format: table (default), json
|
||||
# -h Show this help
|
||||
#
|
||||
# Requires: woodpecker.url and woodpecker.token in credentials.json
|
||||
set -euo pipefail
|
||||
|
||||
MOSAIC_HOME="${MOSAIC_HOME:-$HOME/.config/mosaic}"
|
||||
source "$MOSAIC_HOME/tools/_lib/credentials.sh"
|
||||
|
||||
CRED_FILE="${MOSAIC_CREDENTIALS_FILE:-$HOME/src/jarvis-brain/credentials.json}"
|
||||
if ! jq -e '.woodpecker.token // empty | select(. != "")' "$CRED_FILE" &>/dev/null; then
|
||||
echo "Error: Woodpecker API token not configured in credentials.json" >&2
|
||||
echo "See: ~/.config/mosaic/tools/woodpecker/README.md" >&2
|
||||
exit 1
|
||||
fi
|
||||
|
||||
load_credentials woodpecker
|
||||
|
||||
REPO=""
|
||||
NUMBER=""
|
||||
FORMAT="table"
|
||||
|
||||
while getopts "r:n:f:h" opt; do
|
||||
case $opt in
|
||||
r) REPO="$OPTARG" ;;
|
||||
n) NUMBER="$OPTARG" ;;
|
||||
f) FORMAT="$OPTARG" ;;
|
||||
h) head -14 "$0" | grep "^#" | sed 's/^# \?//'; exit 0 ;;
|
||||
*) echo "Usage: $0 [-r owner/repo] [-n number] [-f format]" >&2; exit 1 ;;
|
||||
esac
|
||||
done
|
||||
|
||||
if [[ -z "$REPO" ]]; then
|
||||
remote_url=$(git remote get-url origin 2>/dev/null || true)
|
||||
if [[ -n "$remote_url" ]]; then
|
||||
REPO=$(echo "$remote_url" | sed -E 's|.*[:/]([^/]+/[^/]+?)(\.git)?$|\1|')
|
||||
else
|
||||
echo "Error: -r owner/repo required (not in a git repository)" >&2
|
||||
exit 1
|
||||
fi
|
||||
fi
|
||||
|
||||
if [[ -z "$NUMBER" ]]; then
|
||||
# Get latest pipeline
|
||||
endpoint="${WOODPECKER_URL}/api/repos/${REPO}/pipelines?per_page=1"
|
||||
else
|
||||
endpoint="${WOODPECKER_URL}/api/repos/${REPO}/pipelines/${NUMBER}"
|
||||
fi
|
||||
|
||||
response=$(curl -sk -w "\n%{http_code}" \
|
||||
-H "Authorization: Bearer $WOODPECKER_TOKEN" \
|
||||
"$endpoint")
|
||||
|
||||
http_code=$(echo "$response" | tail -n1)
|
||||
body=$(echo "$response" | sed '$d')
|
||||
|
||||
if [[ "$http_code" != "200" ]]; then
|
||||
echo "Error: Failed to get pipeline status (HTTP $http_code)" >&2
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# If we got a list, extract the first one
|
||||
if [[ -z "$NUMBER" ]]; then
|
||||
body=$(echo "$body" | jq '.[0]')
|
||||
fi
|
||||
|
||||
if [[ "$FORMAT" == "json" ]]; then
|
||||
echo "$body" | jq '.'
|
||||
exit 0
|
||||
fi
|
||||
|
||||
echo "Pipeline Status"
|
||||
echo "==============="
|
||||
echo "$body" | jq -r '
|
||||
" Number: \(.number)\n" +
|
||||
" Status: \(.status)\n" +
|
||||
" Branch: \(.branch)\n" +
|
||||
" Event: \(.event)\n" +
|
||||
" Commit: \(.commit[:12])\n" +
|
||||
" Message: \(.message | split("\n")[0])\n" +
|
||||
" Author: \(.author)\n" +
|
||||
" Started: \(.started_at // "pending")\n" +
|
||||
" Finished: \(.finished_at // "running")"
|
||||
'
|
||||
67
tools/woodpecker/pipeline-trigger.sh
Executable file
67
tools/woodpecker/pipeline-trigger.sh
Executable file
@@ -0,0 +1,67 @@
|
||||
#!/usr/bin/env bash
|
||||
#
|
||||
# pipeline-trigger.sh — Trigger a Woodpecker CI pipeline
|
||||
#
|
||||
# Usage: pipeline-trigger.sh [-r owner/repo] [-b branch]
|
||||
#
|
||||
# Options:
|
||||
# -r repo Repository in owner/repo format (default: current repo)
|
||||
# -b branch Branch to build (default: main)
|
||||
# -h Show this help
|
||||
#
|
||||
# Requires: woodpecker.url and woodpecker.token in credentials.json
|
||||
set -euo pipefail
|
||||
|
||||
MOSAIC_HOME="${MOSAIC_HOME:-$HOME/.config/mosaic}"
|
||||
source "$MOSAIC_HOME/tools/_lib/credentials.sh"
|
||||
|
||||
CRED_FILE="${MOSAIC_CREDENTIALS_FILE:-$HOME/src/jarvis-brain/credentials.json}"
|
||||
if ! jq -e '.woodpecker.token // empty | select(. != "")' "$CRED_FILE" &>/dev/null; then
|
||||
echo "Error: Woodpecker API token not configured in credentials.json" >&2
|
||||
echo "See: ~/.config/mosaic/tools/woodpecker/README.md" >&2
|
||||
exit 1
|
||||
fi
|
||||
|
||||
load_credentials woodpecker
|
||||
|
||||
REPO=""
|
||||
BRANCH="main"
|
||||
|
||||
while getopts "r:b:h" opt; do
|
||||
case $opt in
|
||||
r) REPO="$OPTARG" ;;
|
||||
b) BRANCH="$OPTARG" ;;
|
||||
h) head -12 "$0" | grep "^#" | sed 's/^# \?//'; exit 0 ;;
|
||||
*) echo "Usage: $0 [-r owner/repo] [-b branch]" >&2; exit 1 ;;
|
||||
esac
|
||||
done
|
||||
|
||||
if [[ -z "$REPO" ]]; then
|
||||
remote_url=$(git remote get-url origin 2>/dev/null || true)
|
||||
if [[ -n "$remote_url" ]]; then
|
||||
REPO=$(echo "$remote_url" | sed -E 's|.*[:/]([^/]+/[^/]+?)(\.git)?$|\1|')
|
||||
else
|
||||
echo "Error: -r owner/repo required (not in a git repository)" >&2
|
||||
exit 1
|
||||
fi
|
||||
fi
|
||||
|
||||
echo "Triggering pipeline for $REPO on branch $BRANCH..."
|
||||
|
||||
response=$(curl -sk -w "\n%{http_code}" -X POST \
|
||||
-H "Authorization: Bearer $WOODPECKER_TOKEN" \
|
||||
-H "Content-Type: application/json" \
|
||||
-d "$(jq -n --arg b "$BRANCH" '{branch: $b}')" \
|
||||
"${WOODPECKER_URL}/api/repos/${REPO}/pipelines")
|
||||
|
||||
http_code=$(echo "$response" | tail -n1)
|
||||
body=$(echo "$response" | sed '$d')
|
||||
|
||||
if [[ "$http_code" != "200" && "$http_code" != "201" ]]; then
|
||||
echo "Error: Failed to trigger pipeline (HTTP $http_code)" >&2
|
||||
echo "$body" | jq -r '.' 2>/dev/null >&2 || echo "$body" >&2
|
||||
exit 1
|
||||
fi
|
||||
|
||||
number=$(echo "$body" | jq -r '.number')
|
||||
echo "Pipeline #$number triggered successfully"
|
||||
Reference in New Issue
Block a user