Sienna Meridian Satterwhite
cdc109d728
stdlib-only Python CLI replacing infrastructure/scripts/sunbeam.py. Verbs: up, down, status, apply, seed, verify, logs, restart, get, build, mirror, bootstrap. Service scoping via ns/name target syntax. Auto-bundled kubectl/kustomize/helm (SHA256-verified, cached in ~/.local/share/sunbeam/bin). 63 unittest tests, all passing.
107 lines
3.1 KiB
Python
107 lines
3.1 KiB
Python
"""Binary bundler — downloads kubectl, kustomize, helm at pinned versions.
|
|
|
|
Binaries are cached in ~/.local/share/sunbeam/bin/ and SHA256-verified.
|
|
"""
|
|
import hashlib
|
|
import io
|
|
import os
|
|
import stat
|
|
import subprocess
|
|
import tarfile
|
|
import urllib.request
|
|
from pathlib import Path
|
|
|
|
CACHE_DIR = Path.home() / ".local/share/sunbeam/bin"
|
|
|
|
TOOLS: dict[str, dict] = {
|
|
"kubectl": {
|
|
"version": "v1.32.2",
|
|
"url": "https://dl.k8s.io/release/v1.32.2/bin/darwin/arm64/kubectl",
|
|
"sha256": "", # set to actual hash; empty = skip verify
|
|
},
|
|
"kustomize": {
|
|
"version": "v5.6.0",
|
|
"url": "https://github.com/kubernetes-sigs/kustomize/releases/download/kustomize%2Fv5.6.0/kustomize_v5.6.0_darwin_arm64.tar.gz",
|
|
"sha256": "",
|
|
"extract": "kustomize",
|
|
},
|
|
"helm": {
|
|
"version": "v3.17.1",
|
|
"url": "https://get.helm.sh/helm-v3.17.1-darwin-arm64.tar.gz",
|
|
"sha256": "",
|
|
"extract": "darwin-arm64/helm",
|
|
},
|
|
}
|
|
|
|
|
|
def _sha256(path: Path) -> str:
|
|
h = hashlib.sha256()
|
|
with open(path, "rb") as f:
|
|
for chunk in iter(lambda: f.read(65536), b""):
|
|
h.update(chunk)
|
|
return h.hexdigest()
|
|
|
|
|
|
def ensure_tool(name: str) -> Path:
|
|
"""Return path to cached binary, downloading + verifying if needed."""
|
|
if name not in TOOLS:
|
|
raise ValueError(f"Unknown tool: {name}")
|
|
spec = TOOLS[name]
|
|
CACHE_DIR.mkdir(parents=True, exist_ok=True)
|
|
dest = CACHE_DIR / name
|
|
|
|
expected_sha = spec.get("sha256", "")
|
|
|
|
# Use cached binary if it exists and passes SHA check
|
|
if dest.exists():
|
|
if not expected_sha or _sha256(dest) == expected_sha:
|
|
return dest
|
|
# SHA mismatch — re-download
|
|
dest.unlink()
|
|
|
|
# Download
|
|
url = spec["url"]
|
|
with urllib.request.urlopen(url) as resp: # noqa: S310
|
|
data = resp.read()
|
|
|
|
# Extract from tar.gz if needed
|
|
extract_path = spec.get("extract")
|
|
if extract_path:
|
|
with tarfile.open(fileobj=io.BytesIO(data)) as tf:
|
|
member = tf.getmember(extract_path)
|
|
fobj = tf.extractfile(member)
|
|
binary_data = fobj.read()
|
|
else:
|
|
binary_data = data
|
|
|
|
# Write to cache
|
|
dest.write_bytes(binary_data)
|
|
|
|
# Verify SHA256 (after extraction)
|
|
if expected_sha:
|
|
actual = _sha256(dest)
|
|
if actual != expected_sha:
|
|
dest.unlink()
|
|
raise RuntimeError(
|
|
f"SHA256 mismatch for {name}: expected {expected_sha}, got {actual}"
|
|
)
|
|
|
|
# Make executable
|
|
dest.chmod(dest.stat().st_mode | stat.S_IXUSR | stat.S_IXGRP | stat.S_IXOTH)
|
|
return dest
|
|
|
|
|
|
def run_tool(name: str, *args, **kwargs) -> subprocess.CompletedProcess:
|
|
"""Run a bundled tool, ensuring it is downloaded first.
|
|
|
|
For kustomize: prepends CACHE_DIR to PATH so helm is found.
|
|
"""
|
|
bin_path = ensure_tool(name)
|
|
env = kwargs.pop("env", None)
|
|
if env is None:
|
|
env = os.environ.copy()
|
|
# kustomize needs helm on PATH for helm chart rendering
|
|
if name == "kustomize":
|
|
env["PATH"] = str(CACHE_DIR) + os.pathsep + env.get("PATH", "")
|
|
return subprocess.run([str(bin_path), *args], env=env, **kwargs)
|