How hashicorp/waypoint works
Waypoint is an application-delivery platform: users define build, deploy, and release workflows as code, then operate them through the CLI and extensible platform plugins. The best-evidenced workflow here is pipeline configuration through execution and run inspection: configuration becomes pipeline data, the server schedules dependent jobs, and the CLI streams results. The README documents multiple build and deployment targets; their individual implementations are represented as plugin subsystems. Edges beyond the sampled pipeline path are documented capabilities or unverified integrations, marked accordingly.
Main entry points: pipeline_run.go Pipeline commands · service_pipeline.go Pipeline service · main.go Waypoint CLI · pipeline.go Pipeline configuration
Components 15
User interfaces
- Waypoint CLI
internal/cli/main.go - Waypoint UI
ui/app
Pipeline workflow
- Pipeline configuration
internal/config/pipeline.go - Pipeline model
pkg/server/ptypes/pipeline.go - Pipeline service
pkg/server/singleprocess/service_pipeline.go - Pipeline state
internal/server/boltdbstate/pipeline.go - Run state
internal/server/boltdbstate/pipeline_run.go - Run tree processor
pkg/server/ptypes/pipeline_ui.go - Pipeline commands
internal/cli/pipeline_run.go - Pipeline inspection
internal/cli/pipeline_inspect.go
Execution runtime
- Job runner
internal/runner/operation_pipeline_step.go - Server client
pkg/serverclient/client.go
Build and platform plugins
- Build plugins
builtin/docker - Deployment plugins
builtin/k8s
Other components
- Developer
Connections 15
- Developer → Waypoint CLI: invokes
README.md - Waypoint CLI → Pipeline commands: runs commands
- Pipeline configuration → Pipeline model: encodes pipeline
internal/config/pipeline.go - Pipeline commands → Pipeline configuration: syncs configuration
internal/cli/pipeline_run.go - Pipeline commands → Pipeline service: requests run
internal/cli/pipeline_run.go - Pipeline service → Pipeline state: reads state
pkg/server/singleprocess/service_pipeline.go - Pipeline service → Run state: records run
- Pipeline commands → Run state: reads run jobs
- Pipeline service → Job runner: queues jobs
- Job runner → Server client: streams job
- Pipeline commands → Pipeline inspection: inspects runs
- Pipeline inspection → Run tree processor: renders run details
- Developer → Waypoint UI: uses
- Pipeline commands → Build plugins: selects build method
- Pipeline commands → Deployment plugins: selects target