Skip to content

DEPLOYMENT.md

Latest commit

 

History

History
35 lines (26 loc) · 1.35 KB

DEPLOYMENT.md

File metadata and controls

35 lines (26 loc) · 1.35 KB
Raw

Capa Runtime Deployment Notes

Current Status

  • Repository: capa-cloud/capa
  • Runtime: Go sidecar process
  • Container build file: docker/Dockerfile
  • Public documentation: https://capa.rxcloud.group/

Local Validation

The module selects Go 1.26.5 through go.mod. Keep GOTOOLCHAIN=auto enabled so older bootstrap installations use the patched toolchain automatically.

go test ./...
go build ./...
docker build -f docker/Dockerfile -t capa-runtime:local .

Runtime Checklist

  • Set --listen-address=0.0.0.0 when the gRPC port must be reachable outside the container.
  • Confirm the gRPC and callback ports do not conflict with the host application.
  • Set a finite --shutdown-timeout and give the orchestrator a larger termination grace period.
  • Keep component credentials and future binding secrets in deployment secrets, not Git.

Release Checklist

  • Regenerate or review API specs in spec/ when runtime contracts change.
  • Test at least one SDK integration path after sidecar API changes.
  • Exercise metadata and shutdown RPCs before promoting a runtime image.
  • Confirm the process exits after the Shutdown RPC without requiring a second signal.
  • Treat gRPC UNIMPLEMENTED from actor methods as the expected scaffolding behavior.
  • Do not route production traffic through actor or interception APIs while they remain incomplete.