vim-ale/skills/deploy-webicached/SKILL.md

name, description

name	description
deploy-webicached	Deploy webicached binary to beta.webi.sh. Use when building, uploading, or restarting the cache daemon. Covers cross-compile, conf sync, service management.

One-step deploy

./scripts/deploy-webicached.sh beta.webi.sh

Builds with version ldflags, stops service, uploads, syncs conf, starts, verifies.

Manual steps (if needed)

Build

VERSION="$(git describe --tags --always)"
COMMIT="$(git rev-parse --short HEAD)"
DATE="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
GOOS=linux GOARCH=amd64 GOAMD64=v2 go build \
  -ldflags "-X main.version=${VERSION} -X main.commit=${COMMIT} -X main.date=${DATE}" \
  -o agents/tmp/webicached ./cmd/webicached

MUST: Build from the ref-webi-go worktree (or branch containing cmd/webicached).

Deploy

ssh beta.webi.sh "serviceman stop webicached"
scp agents/tmp/webicached beta.webi.sh:~/bin/webicached

MUST: Stop service before scp — Linux refuses to overwrite a running binary.

Sync releases.conf

rsync -av --include='*/' --include='releases.conf' --exclude='*' \
  ./ beta.webi.sh:~/srv/beta.webinstall.dev/installers/

MUST: Run from the worktree root. The server has no checkout of this branch — conf files must be synced explicitly.

Start

ssh beta.webi.sh "serviceman start webicached"

Verify

ssh beta.webi.sh "sleep 5 && serviceman logs webicached"

Expected: "batch: N stale, refreshing 20" or "all packages fresh, sleeping 9s"

Smoke test

ssh beta.webi.sh "curl -sSf http://localhost:3080/api/releases/bat.json | head -c 100"
ssh beta.webi.sh "curl -sSf -A 'curl/7.81.0 Linux x86_64' http://localhost:3080/api/installers/bat.sh | head -3"

Expected: JSON array with release objects; shell script with PKG_NAME='bat'.

Service management

serviceman status webicached
serviceman restart webicached
serviceman logs webicached

Server layout

Path	Purpose
~/bin/webicached	Binary
~/srv/beta.webinstall.dev/installers/	Conf dir (releases.conf files)
~/.cache/webi/legacy/	Cache output (fsstore, legacy JSON format)
~/.cache/webi/raw/	Raw upstream API responses
~/srv/beta.webinstall.dev/.env.secret	GITHUB_TOKEN
/etc/systemd/system/webicached.service	Service unit (created by serviceman)

Flags reference

Flag	Default	Purpose
--conf	.	Dir with {pkg}/releases.conf files
--legacy	~/.cache/webi/legacy	Legacy cache output directory
--raw	~/.cache/webi/raw	Raw upstream response cache
--token	$GITHUB_TOKEN	GitHub API token
--interval	9s	Delay between package fetches in a batch
--once	false	Run once then exit
--eager	false	Fetch all on startup (not staleness-based)
--shallow	false	Only first page of releases
--no-fetch	false	Classify from rawcache only
--page-delay	2s	Delay between paginated API pages

One-shot refresh (specific packages)

ssh beta.webi.sh ". ~/srv/beta.webinstall.dev/.env.secret && ~/bin/webicached \
  --conf ~/srv/beta.webinstall.dev/installers/ \
  --raw ~/.cache/webi/raw \
  --once bat goreleaser"