77 lines
2.4 KiB
Bash
77 lines
2.4 KiB
Bash
#!/usr/bin/env bash
|
||
# bin/railiance — Rails-style CLI entrypoint for Railiance
|
||
set -euo pipefail
|
||
|
||
ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
|
||
|
||
usage() {
|
||
cat <<'EOF'
|
||
Usage: bin/railiance <command>
|
||
|
||
Commands:
|
||
next Show canonical first-time sequence
|
||
doctor Check local prerequisites (git, curl, jq, ansible)
|
||
plan-host Print provider-neutral host specs & checklist
|
||
gen-ssh-key Generate an SSH key (ed25519) and print pubkey
|
||
cloudinit Emit minimal cloud-init user-data
|
||
init-repo Idempotently furnish repo housekeeping
|
||
build-spore Build a distributable "Spore" bundle
|
||
seed-local Run the seed script on this machine
|
||
checklist Print a pre-VM checklist
|
||
help Show this help
|
||
EOF
|
||
}
|
||
|
||
cmd="${1:-help}"
|
||
|
||
need(){ command -v "$1" >/dev/null 2>&1 || { echo "Missing: $1" >&2; exit 1; }; }
|
||
|
||
case "$cmd" in
|
||
help) usage ;;
|
||
next) cat "$ROOT/docs/first_host.md" ;;
|
||
doctor)
|
||
for c in git curl jq; do
|
||
command -v "$c" >/dev/null && echo "OK: $c" || { echo "Missing: $c"; exit 1; }
|
||
done
|
||
command -v ansible >/dev/null && echo "OK: ansible" || echo "Note: ansible not found (only needed for host bootstrap)"
|
||
;;
|
||
plan-host)
|
||
sed -n '1,200p' "$ROOT/docs/first_host.md" | sed -n '/^## 2\) Choose/,/^## 3\)/p'
|
||
;;
|
||
gen-ssh-key)
|
||
need ssh-keygen
|
||
key="${HOME}/.ssh/id_ed25519"
|
||
[[ -f "$key" ]] || ssh-keygen -t ed25519 -N "" -f "$key"
|
||
echo "Public key:"
|
||
cat "${key}.pub"
|
||
;;
|
||
cloudinit) cat "$ROOT/cloudinit/user-data.yaml" ;;
|
||
init-repo) bash "$ROOT/tools/furnish_railiance_repo.sh" ;;
|
||
build-spore) bash "$ROOT/tools/build_spore.sh" ;;
|
||
seed-local) bash "$ROOT/tools/seed_node.sh" ;;
|
||
init-inventory)
|
||
if [[ -f "$ROOT/ansible/hosts.ini" ]]; then
|
||
echo "ansible/hosts.ini already exists."
|
||
else
|
||
cp "$ROOT/ansible/hosts.ini.example" "$ROOT/ansible/hosts.ini"
|
||
echo "Created ansible/hosts.ini from example."
|
||
fi
|
||
;;
|
||
checklist)
|
||
cat <<'CK'
|
||
Rent-a-VM Checklist
|
||
-------------------
|
||
[ ] Provider account ready (billing set)
|
||
[ ] Region chosen (low latency to you/users)
|
||
[ ] Image: Ubuntu 24.04 LTS
|
||
[ ] Size: 2 vCPU / 4–8 GB RAM / 60+ GB SSD
|
||
[ ] SSH key uploaded (see gen-ssh-key)
|
||
- Run: bin/railiance gen-ssh-key
|
||
[ ] Cloud-init pasted (see: bin/railiance cloudinit)
|
||
[ ] Hostname set (e.g., railiance-seed-1)
|
||
[ ] Record public IP / DNS
|
||
CK
|
||
;;
|
||
*) usage; exit 2 ;;
|
||
esac
|