opensandbox-group--opensandbox/components/ingress/DEVELOPMENT.md

Development Guide (Quick)

Prerequisites

• Go 1.24+
• Docker (optional, for image build)
• Access to a Kubernetes cluster with BatchSandbox CRD installed.

Install deps

cd components/ingress
go mod tidy && go mod vendor

Build & Run

make build          # binary at bin/ingress with ldflags version info
./bin/ingress \
  --namespace <target-namespace> \
  --port 28888 \
  --log-level info

Tests & Lint

make test           # go test ./...
go vet ./...        # included in make build

Docker (with build args)

docker build \
  --build-arg VERSION=$(git describe --tags --always --dirty) \
  --build-arg GIT_COMMIT=$(git rev-parse HEAD) \
  --build-arg BUILD_TIME=$(date -u +"%Y-%m-%dT%H:%M:%SZ") \
  -t opensandbox/ingress:dev .

Key Paths

• main.go — entrypoint, HTTP routes, provider initialization.
• pkg/proxy/ — HTTP/WebSocket reverse proxy logic.
• pkg/sandbox/ — Sandbox provider abstraction and BatchSandbox implementation.
• version/ — build metadata (ldflags).

Tips

• Health check: /status.ok
• Proxy endpoint: / (routes based on OpenSandbox-Ingress-To header or Host)
• Env overrides: VERSION/GIT_COMMIT/BUILD_TIME usable via Makefile and build.sh.
• BatchSandbox must have sandbox.opensandbox.io/endpoints annotation with JSON array of IPs.