BlueGit

timfa bluegit

Files

bluegit / scripts / bg

bg

bg 18.0 KiB Download Raw
1#!/usr/bin/env bash
2# bg: kleine BlueGit-CLI voor mensen en agents. Alleen bash, curl en jq.
3#
4# BLUEGIT_URL standaard https://git.timfalken.com
5# BLUEGIT_TOKEN optioneel; nodig voor schrijven en voor privé projecten.
6# Wordt nooit geprint.
7#
8# Zie docs/agents.md of `bg help`.
9set -euo pipefail
10
11BASE="${BLUEGIT_URL:-https://git.timfalken.com}"
12BASE="${BASE%/}"
13API="$BASE/api/v1"
14
15die() { echo "bg: $*" >&2; exit 64; }
16command -v curl >/dev/null || die "curl ontbreekt"
17command -v jq >/dev/null || die "jq ontbreekt"
18
19# req METHOD PATH [JSON] -> body op stdout; bij HTTP >= 400 de fout op stderr en exit 1.
20req() {
21 local method=$1 path=$2 data=${3:-} out code
22 local args=(-sS -X "$method" -w '\n%{http_code}' -H "Accept: application/json")
23 [[ -n "${BLUEGIT_TOKEN:-}" ]] && args+=(-H "Authorization: Bearer ${BLUEGIT_TOKEN}")
24 [[ -n "$data" ]] && args+=(-H "Content-Type: application/json" --data-binary "$data")
25 out=$(curl "${args[@]}" "$API$path") || { echo "bg: verbinding mislukt: $method $path" >&2; return 1; }
26 code=${out##*$'\n'}
27 out=${out%$'\n'*}
28 if (( code >= 400 )); then
29 local msg
30 msg=$(printf '%s' "$out" | jq -r '.message // .error // empty' 2>/dev/null || true)
31 echo "bg: HTTP $code bij $method $path${msg:+: $msg}" >&2
32 [[ $code == 404 ]] && echo "bg: (bestaat niet, of je hebt geen toegang)" >&2
33 return 1
34 fi
35 printf '%s' "$out"
36}
37get() { req GET "$1"; }
38enc() { jq -rn --arg v "$1" '$v|@uri'; }
39proj() { [[ "$1" == */* ]] || die "project moet owner/repo zijn: $1"; echo "/projects/$1"; }
40issues() { echo "/repos/$1/issues"; }
41json() { jq -cn "$@"; }
42
43# ---------- pipelines ----------
44
45# select_pipeline PROJECT ARGS... -> pipeline-JSON (of leeg als er nog geen is)
46select_query() {
47 local q=""
48 while (($#)); do
49 case $1 in
50 --sha) q="sha=$2"; shift 2 ;;
51 --mr) q="mr=$2"; shift 2 ;;
52 --branch|--ref) q="ref=$(enc "$2")"; shift 2 ;;
53 --id) q="id=$2"; shift 2 ;;
54 --timeout|--interval) shift 2 ;;
55 *) die "onbekende optie: $1" ;;
56 esac
57 done
58 echo "$q"
59}
60find_pipeline() {
61 local p=$1 q=$2
62 if [[ $q == id=* ]]; then get "$(proj "$p")/pipelines/${q#id=}"; return; fi
63 get "$(proj "$p")/pipelines?per_page=1${q:+&$q}" | jq -c '.[0] // empty'
64}
65show_pipeline() {
66 local p=$1 pipe=$2
67 jq -r '"pipeline #\(.id) \(.display_status // .status) \(.ref|sub("^refs/heads/";"")) \(.sha[0:8]) \(.web_url)"' <<<"$pipe"
68 get "$(proj "$p")/pipelines/$(jq -r .id <<<"$pipe")/jobs" |
69 jq -r '.[] | " \(.id)\t\(.display_status // .status)\(if .failure_reason then " (\(.failure_reason))" else "" end)\t\(.stage)/\(.name)\(if .allow_failure then " (allow_failure)" else "" end)"'
70}
71failed_logs() {
72 local p=$1 id=$2 jobs
73 jobs=$(get "$(proj "$p")/pipelines/$id/jobs")
74 jq -r '.[]|select(.status=="failed" and .allow_failure)|"bg: waarschuwing: \(.name) (#\(.id)) faalde (allow_failure)"' <<<"$jobs" >&2
75 for j in $(jq -r '.[]|select(.status=="failed" and (.allow_failure|not))|.id' <<<"$jobs"); do
76 echo "----- log job $j (laatste ${BG_LOG_LINES:-80} regels) -----" >&2
77 get "$(proj "$p")/pipelines/$id/jobs/$j/log" | tail -n "${BG_LOG_LINES:-80}" >&2 || true
78 done
79}
80cmd_pipeline() {
81 local sub=${1:-}; shift || true
82 case $sub in
83 status)
84 local p=${1:?project}; shift
85 local q pipe; q=$(select_query "$@")
86 pipe=$(find_pipeline "$p" "$q")
87 [[ -n "$pipe" ]] || { echo "geen pipeline gevonden" >&2; exit 3; }
88 show_pipeline "$p" "$pipe" ;;
89 wait)
90 local p=${1:?project}; shift
91 local timeout=1800 interval=10 a=("$@")
92 while (($#)); do case $1 in --timeout) timeout=$2; shift 2 ;; --interval) interval=$2; shift 2 ;; *) shift ;; esac; done
93 local q pipe status start=$SECONDS last=""
94 q=$(select_query "${a[@]}")
95 while :; do
96 pipe=$(find_pipeline "$p" "$q" || true)
97 status=$(jq -r '.status // empty' <<<"${pipe:-{\}}")
98 if [[ -n "$status" && "$status" != "$last" ]]; then
99 echo "pipeline #$(jq -r .id <<<"$pipe"): $status" >&2; last=$status
100 fi
101 case $status in
102 success) show_pipeline "$p" "$pipe"; failed_logs "$p" "$(jq -r .id <<<"$pipe")" 2>&1 | grep '^bg: waarschuwing' >&2 || true; exit 0 ;;
103 failed|canceled) show_pipeline "$p" "$pipe"; failed_logs "$p" "$(jq -r .id <<<"$pipe")"; exit 1 ;;
104 esac
105 (( SECONDS - start >= timeout )) && { echo "bg: timeout na ${timeout}s (status ${status:-geen pipeline})" >&2; exit 2; }
106 sleep "$interval"
107 done ;;
108 logs) get "$(proj "${1:?project}")/pipelines/${2:?pipeline-id}/jobs/${3:?job-id}/log" ;;
109 retry)
110 local mode=failed
111 [[ ${3:-} == --all ]] && mode=all
112 req POST "$(proj "${1:?project}")/pipelines/${2:?pipeline-id}/retry" "$(json --arg m "$mode" '{mode:$m}')" | jq -r '"pipeline #\(.id) \(.status) \(.web_url)"' ;;
113 cancel)
114 # Een lopende doNotInterrupt-job vraagt om --force; zonder geeft de API 409 met uitleg.
115 local f=""; [[ ${3:-} == --force ]] && f="?force=true"
116 req POST "$(proj "${1:?project}")/pipelines/${2:?pipeline-id}/cancel$f" '{}' | jq -r '"pipeline #\(.id) \(.display_status // .status) \(.web_url)"' ;;
117 cancel-job)
118 local f=""; [[ ${4:-} == --force ]] && f="?force=true"
119 req POST "$(proj "${1:?project}")/pipelines/${2:?pipeline-id}/jobs/${3:?job-id}/cancel$f" '{}' | jq -r '"job #\(.id) \(.name) \(.display_status // .status)"' ;;
120 list) get "$(proj "${1:?project}")/pipelines?per_page=${2:-10}" | jq -r '.[]|"\(.id)\t\(.display_status // .status)\t\(.ref|sub("^refs/heads/";""))\t\(.sha[0:8])"' ;;
121 *) die "pipeline status|wait|logs|retry|list|cancel|cancel-job" ;;
122 esac
123}
124
125# ---------- merge requests ----------
126cmd_mr() {
127 local sub=${1:-}; shift || true
128 case $sub in
129 list)
130 local p=${1:?project}; shift; local q="state=open"
131 while (($#)); do case $1 in --state) q="state=$2"; shift 2 ;; --source) q+="&source_branch=$(enc "$2")"; shift 2 ;; --target) q+="&target_branch=$(enc "$2")"; shift 2 ;; *) die "onbekende optie $1" ;; esac; done
132 get "$(proj "$p")/merge_requests?per_page=100&$q" | jq -r '.[]|"!\(.iid)\t\(.state)\t\(.source_branch) -> \(.target_branch)\t\(.title)"' ;;
133 show) get "$(proj "${1:?project}")/merge_requests/${2:?nummer}" | jq . ;;
134 create)
135 local p=${1:?project}; shift; local src="" tgt="" title="" desc="" remove=true
136 while (($#)); do case $1 in --source) src=$2; shift 2 ;; --target) tgt=$2; shift 2 ;; --title) title=$2; shift 2 ;; --description) desc=$2; shift 2 ;; --keep-source) remove=false; shift ;; *) die "onbekende optie $1" ;; esac; done
137 [[ -n $src && -n $tgt && -n $title ]] || die "mr create PROJECT --source B --target B --title T [--description D] [--keep-source]"
138 req POST "$(proj "$p")/merge_requests" "$(json --arg s "$src" --arg t "$tgt" --arg ti "$title" --arg d "$desc" --argjson r "$remove" '{source_branch:$s,target_branch:$t,title:$ti,description:$d,remove_source_branch:$r}')" | jq -r '"!\(.iid) \(.web_url)"' ;;
139 merge)
140 local remove=true; [[ ${3:-} == --keep-source ]] && remove=false
141 req POST "$(proj "${1:?project}")/merge_requests/${2:?nummer}/merge" "$(json --argjson r "$remove" '{remove_source_branch:$r}')" | jq -r '"\(.state) \(.web_url)"' ;;
142 comment) req POST "$(proj "${1:?project}")/merge_requests/${2:?nummer}/notes" "$(json --arg b "${3:?tekst}" '{body:$b}')" | jq -r '"notitie \(.id)"' ;;
143 *) die "mr list|show|create|merge|comment" ;;
144 esac
145}
146
147# ---------- runners ----------
148# Account-runners standaard; --group PAD voor groepsrunners (maintainer).
149cmd_runner() {
150 local sub=${1:-}; shift || true
151 local group="" args=()
152 while (($#)); do case $1 in --group) group=$2; shift 2 ;; *) args+=("$1"); shift ;; esac; done
153 set -- "${args[@]+"${args[@]}"}"
154 local base="/user/runners"
155 [[ -n $group ]] && base="/groups/$(enc "$group")/runners"
156 local fmt='"\(.id)\t\(.status)\t\(.name)\tlaatst gezien \(.last_seen // "nooit")\t\(.version)"'
157 case $sub in
158 list) get "$base" | jq -r ".[]|$fmt" ;;
159 show) get "$base/${1:?runner-id}" | jq . ;;
160 token)
161 # Het registratietoken is het doel van dit commando; alleen hier op stdout.
162 local out; out=$(req POST "$base/registration-token" '{}')
163 if [[ ${1:-} == --json ]]; then printf '%s\n' "$out"; else jq -r .token <<<"$out"; fi ;;
164 rename) req PUT "$base/${1:?runner-id}" "$(json --arg n "${2:?naam}" '{name:$n}')" | jq -r "$fmt" ;;
165 pause) req POST "$base/${1:?runner-id}/pause" '{}' | jq -r "$fmt" ;;
166 resume) req POST "$base/${1:?runner-id}/resume" '{}' | jq -r "$fmt" ;;
167 delete|revoke) req DELETE "$base/${1:?runner-id}" >/dev/null && echo "ingetrokken" ;;
168 jobs) get "$base/${1:?runner-id}/jobs?limit=${2:-20}" | jq -r '.[]|"\(.id)\t\(.status)\t\(.project // "-")\t\(.name)\t\(.finished_at // .started_at // "")"' ;;
169 pref)
170 if [[ -n ${1:-} ]]; then req PUT /user/runner-settings "$(json --arg p "$1" '{preference:$p}')" | jq -r .preference
171 else get /user/runner-settings | jq -r .preference; fi ;;
172 builtin-first)
173 [[ -n $group ]] || die "runner builtin-first --group PAD [true|false]"
174 if [[ -n ${1:-} ]]; then req PUT "/groups/$(enc "$group")/runner-settings" "$(json --argjson b "$1" '{builtin_first:$b}')" | jq -c .
175 else get "/groups/$(enc "$group")/runner-settings" | jq -c .; fi ;;
176 optin)
177 [[ -n $group ]] || die "runner optin --group PAD [on|off]"
178 case ${1:-} in
179 on) req PUT "/groups/$(enc "$group")/runner-optin" '{"enabled":true}' | jq -c . ;;
180 off) req PUT "/groups/$(enc "$group")/runner-optin" '{"enabled":false}' | jq -c . ;;
181 "") get "/groups/$(enc "$group")/runner-optin" | jq -c . ;;
182 *) die "optin on|off" ;;
183 esac ;;
184 wait)
185 # wait NAAM-of-ID [--timeout S]: tot de runner online is.
186 local want=${1:?naam of id} timeout=${3:-120} t=0 row
187 [[ ${2:-} == --timeout ]] || timeout=120
188 while (( t < timeout )); do
189 row=$(get "$base" | jq -c --arg w "$want" '.[]|select((.id|tostring)==$w or .name==$w)' | head -n1)
190 if [[ -n $row && $(jq -r .status <<<"$row") == online ]]; then jq -r "$fmt" <<<"$row"; return 0; fi
191 sleep 3; t=$((t+3))
192 done
193 echo "bg: runner $want niet online binnen ${timeout}s" >&2; return 2 ;;
194 setup)
195 # setup [--group PAD] [NAAM]: token maken, deze machine registreren
196 # (sudo bluegit-runner register, token via env) en wachten tot online.
197 local name=${1:-$(hostname)} tok
198 command -v bluegit-runner >/dev/null || die "bluegit-runner ontbreekt (yay -S bluegit-runner)"
199 tok=$(req POST "$base/registration-token" '{}' | jq -r .token)
200 local sudo=(); (( EUID == 0 )) || sudo=(sudo --preserve-env=BLUEGIT_RUNNER_REGISTRATION_TOKEN)
201 BLUEGIT_RUNNER_REGISTRATION_TOKEN="$tok" "${sudo[@]}" bluegit-runner register --url "$BASE" --name "$name"
202 unset tok
203 cmd_runner wait "$name" ${group:+--group "$group"} ;;
204 *) die "runner list|show|token|rename|pause|resume|delete|jobs|pref|builtin-first|optin|wait|setup [--group PAD]" ;;
205 esac
206}
207
208# ---------- beheer (instance admin) ----------
209cmd_admin() {
210 local sub=${1:-}; shift || true
211 case $sub in
212 list) get "$API/admin/users" | jq -r '.[]|"\(.username)\t\(if .admin then "admin" else "-" end)"' ;;
213 grant|revoke)
214 local v=true; [[ $sub == revoke ]] && v=false
215 req PUT "$API/admin/users/${1:?gebruiker}/admin" "{\"admin\":$v}" | jq -r '"\(.username) admin=\(.admin)"' ;;
216 runner)
217 # globale runners (alleen beheerders)
218 local rs=${1:-list}; shift || true
219 case $rs in
220 list) get "$API/admin/runners" | jq -r '.[]|"\(.id)\t\(.name)\t\(.status)\t\(.version)"' ;;
221 token) req POST "$API/admin/runners/registration-token" '{}' | jq -r '"WAARSCHUWING: \(.warning)\ntoken: \(.token) (24 uur geldig)\n\(.register)"' ;;
222 rename) req PUT "$API/admin/runners/${1:?id}" "$(json --arg n "${2:?naam}" '{name:$n}')" | jq -r '"\(.id) \(.name)"' ;;
223 pause|resume) req POST "$API/admin/runners/${1:?id}/$rs" | jq -r '"\(.id) \(.name) \(.status)"' ;;
224 delete) req DELETE "$API/admin/runners/${1:?id}" >/dev/null && echo "verwijderd: ${1}" ;;
225 jobs) get "$API/admin/runners/${1:?id}/jobs" | jq -r '.[]|"\(.id)\t\(.status)\t\(.project // "-")\t\(.name)"' ;;
226 *) die "admin runner list|token|rename ID NAAM|pause ID|resume ID|delete ID|jobs ID" ;;
227 esac ;;
228 *) die "admin list|grant GEBRUIKER|revoke GEBRUIKER|runner …" ;;
229 esac
230}
231
232# ---------- issues ----------
233cmd_issue() {
234 local sub=${1:-}; shift || true
235 case $sub in
236 list) get "$(issues "${1:?project}")?state=${2:-open}" | jq -r '.issues[]|"#\(.id)\t\(.status)\t\(.title)"' ;;
237 show) get "$(issues "${1:?project}")/${2:?nummer}" | jq . ;;
238 create) req POST "$(issues "${1:?project}")" "$(json --arg t "${2:?titel}" --arg d "${3:-}" '{title:$t,description:$d}')" | jq -r '"#\(.id) \(.web_url)"' ;;
239 comment) req POST "$(issues "${1:?project}")/${2:?nummer}/notes" "$(json --arg b "${3:?tekst}" '{body:$b}')" >/dev/null && echo "ok" ;;
240 close|reopen)
241 local st=closed; [[ $sub == reopen ]] && st=open
242 req PUT "$(issues "${1:?project}")/${2:?nummer}" "$(json --arg s "$st" '{state:$s}')" | jq -r '"#\(.id) \(.status)"' ;;
243 *) die "issue list|show|create|comment|close|reopen" ;;
244 esac
245}
246
247# ---------- overig ----------
248cmd_branch() {
249 [[ ${1:-} == create ]] || die "branch create PROJECT NAAM [--from REF]"
250 local p=${2:?project} name=${3:?naam} from=""
251 [[ ${4:-} == --from ]] && from=${5:?ref}
252 req POST "$(proj "$p")/repository/branches" "$(json --arg n "$name" --arg f "$from" '{name:$n} + (if $f=="" then {} else {from:$f} end)')" | jq -r '.name // .'
253}
254cmd_release() {
255 if [[ ${1:-} == visibility ]]; then
256 # release visibility PROJECT [inherit|private|public]: tonen of zetten
257 local p=${2:?project} v=${3:-}
258 if [[ -z $v ]]; then get "$(proj "$p")" | jq -r '.release_visibility'; return; fi
259 [[ $v == inherit || $v == private || $v == public ]] || die "release visibility PROJECT inherit|private|public"
260 req PUT "$(proj "$p")" "$(json --arg v "$v" '{release_visibility:$v}')" | jq -r '"\(.path) releases=\(.release_visibility) repo=\(.visibility)"'
261 return
262 fi
263 if [[ ${1:-} == delete-asset ]]; then
264 local p=${2:?project} tag=${3:?tag} name=${4:?naam}
265 req DELETE "$(proj "$p")/releases/$(enc "$tag")/assets/$(enc "$name")" >/dev/null && echo "verwijderd: $tag/$name"
266 return
267 fi
268 if [[ ${1:-} == delete ]]; then
269 local p=${2:?project} tag=${3:?tag} q=""
270 [[ ${4:-} == --delete-tag ]] && q="?delete_tag=true"
271 req DELETE "$(proj "$p")/releases/$(enc "$tag")$q" >/dev/null && echo "verwijderd: release $tag${q:+ (met tag)}"
272 return
273 fi
274 [[ ${1:-} == create ]] || die "release create PROJECT TAG [--commit SHA] [--name N] [--body B] [--asset JOB:PAD[:NAAM]]... | release visibility PROJECT [inherit|private|public]"
275 local p=${2:?project} tag=${3:?tag}; shift 3
276 local commit="" name="" body="" assets="[]"
277 while (($#)); do case $1 in
278 --commit) commit=$2; shift 2 ;; --name) name=$2; shift 2 ;; --body) body=$2; shift 2 ;;
279 --asset) IFS=: read -r j pth nm <<<"$2"; assets=$(jq -c --arg j "$j" --arg p "$pth" --arg n "${nm:-}" '. + [{job:$j,path:$p} + (if $n=="" then {} else {name:$n} end)]' <<<"$assets"); shift 2 ;;
280 *) die "onbekende optie $1" ;; esac; done
281 req POST "$(proj "$p")/releases" "$(json --arg t "$tag" --arg c "$commit" --arg n "$name" --arg b "$body" --argjson a "$assets" '{tag:$t,commit:$c,name:$n,body:$b,assets:$a}')" | jq -c .
282}
283cmd_file() {
284 [[ ${1:-} == get ]] || die "file get PROJECT PAD [--ref REF]"
285 local p=${2:?project} path=${3:?pad} ref=""
286 [[ ${4:-} == --ref ]] && ref="?ref=$(enc "${5:?ref}")"
287 local body; body=$(get "$(proj "$p")/repository/files/$(enc "$path")$ref")
288 if jq -e '.content and .encoding=="base64"' <<<"$body" >/dev/null 2>&1; then jq -r .content <<<"$body" | base64 -d
289 elif jq -e '.content' <<<"$body" >/dev/null 2>&1; then jq -r .content <<<"$body"
290 else printf '%s' "$body"; fi
291}
292
293usage() {
294 sed -n '2,8p' "$0" | sed 's/^# \{0,1\}//'
295 cat <<'U'
296
297 bg pipeline status PROJECT [--sha X | --mr N | --branch B | --id P]
298 bg pipeline wait PROJECT [selectie] [--timeout 1800] [--interval 10] exit 0 ok, 1 mislukt, 2 timeout
299 bg pipeline logs PROJECT PIPELINE JOB
300 bg pipeline retry PROJECT PIPELINE [--all]
301 bg pipeline list PROJECT [N]
302 bg pipeline cancel PROJECT PIPELINE [--force] --force nodig bij een lopende doNotInterrupt-job
303 bg pipeline cancel-job PROJECT PIPELINE JOB [--force]
304 bg mr list|show|create|merge|comment ...
305 bg issue list|show|create|comment|close|reopen ...
306 bg branch create PROJECT NAAM [--from REF]
307 bg release create PROJECT TAG [--commit SHA] [--asset JOB:PAD[:NAAM]]
308 bg release delete-asset PROJECT TAG NAAM één asset verwijderen (tag en broncode blijven)
309 bg release delete PROJECT TAG [--delete-tag] release met assets verwijderen
310 bg release visibility PROJECT [inherit|private|public] zichtbaarheid releases tonen of zetten
311 bg file get PROJECT PAD [--ref REF]
312 bg runner list|show ID|jobs ID [N] [--group PAD] (account-runners zonder --group)
313 bg runner token [--json] [--group PAD] registratietoken (eenmalig, 24 uur)
314 bg runner rename ID NAAM | pause ID | resume ID | delete ID [--group PAD]
315 bg runner pref [own_first|builtin_first]
316 bg runner builtin-first --group PAD [true|false]
317 bg runner optin --group PAD [on|off] alleen je eigen toestemming (maintainer)
318 bg runner wait NAAM|ID [--timeout S] [--group PAD]
319 bg runner setup [NAAM] [--group PAD] token + register op deze machine + wachten
320 bg admin runner list|token|rename ID NAAM|pause ID|resume ID|delete ID|jobs ID globale runners (alleen beheerders)
321 bg admin list | grant GEBRUIKER | revoke GEBRUIKER beheerders (alleen beheerders; jezelf afnemen kan niet)
322U
323}
324
325case ${1:-help} in
326 pipeline|pl) shift; cmd_pipeline "$@" ;;
327 mr) shift; cmd_mr "$@" ;;
328 issue) shift; cmd_issue "$@" ;;
329 branch) shift; cmd_branch "$@" ;;
330 release) shift; cmd_release "$@" ;;
331 file) shift; cmd_file "$@" ;;
332 runner) shift; cmd_runner "$@" ;;
333 admin) shift; cmd_admin "$@" ;;
334 help|-h|--help) usage ;;
335 *) usage >&2; exit 64 ;;
336esac