README
¶
Dagger: a better way to ship
Dagger is a platform for automating software delivery. It can build, test and ship any codebase, reliably and at scale.
Dagger runs locally, in your CI server, or directly in the cloud.
brew install dagger/tap/dagger
Why Dagger?
Dagger makes your software delivery programmable, local-first, repeatable and observable.
Programmable. Shell scripts and proprietary YAML are no longer acceptable for automating software delivery. Dagger provides: a complete execution engine and system API; SDKs for 8 languages; an interactive REPL; a rich ecosystem of reusable modules; and more.
Local-first. Once you automate a task with Dagger, it will reliably run on any supported system: your laptop, AI sandbox, CI server, or dedicated cloud infrastructure. The only dependency is a container runtime like Docker.
Repeatable. Tools run in containers, orchestrated by sandboxed functions. Host dependencies are explicit and strictly typed. Intermediate artifacts are built just-in-time. Every operation is incremental by default, with advanced cache control. Whether it's a test report, a build or a deployment, Dagger gives you an output you can trust.
Observable. Every operation emits a full OpenTelemetry trace, enriched by granular logs and metrics. Visualize the trace in directly in the terminal, or in a web view. Debug complex workflows immediately instead of guessing what went wrong from a wall of text logs.
Features
System API. A cross-language API for orchestrating containers, filesystems, secrets, git repositories, network tunnels, and more. Every operation is typed and composable.
SDKs in 8 languages. Native SDKs for Go, Python, TypeScript, PHP, Java, .NET, Elixir and Rust. Each SDK is generated from the API schema, so you get idiomatic code with full type safety and editor support.
Typed artifacts. Define custom object types with encapsulated state and functions. Types are content-addressed and can be passed across SDK language boundaries and module boundaries without serialization.
Incremental execution. Every operation is keyed by its inputs. Change one file and only the affected operations re-run. Caching is content-addressed and works automatically across local runs and CI.
Runs anywhere. The only requirement is a Linux container runtime. Runs natively on Linux, or via Docker Desktop and similar products on macOS and Windows. Local and CI behavior are identical.
Built-in tracing. Every operation emits OpenTelemetry spans. The CLI includes a live TUI; traces can also be exported to Jaeger, Honeycomb, or any OTel-compatible backend.
Getting started
Community
Contributing
See CONTRIBUTING.md.
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
codegen
command
|
|
|
codegen/generator/go/templates
Go name linting.
|
Go name linting. |
|
dagger
command
|
|
|
dialstdio
command
|
|
|
dnsname
command
This is a post-setup plugin that establishes port forwarding - using iptables, from the host's network interface(s) to a pod's network interface.
|
This is a post-setup plugin that establishes port forwarding - using iptables, from the host's network interface(s) to a pod's network interface. |
|
dump-id
command
|
|
|
dump-labels
command
|
|
|
engine
command
|
|
|
init
command
|
|
|
introspect
command
|
|
|
json-schema
command
dagger-json-schema is a tool to generate json schema from Dagger module config struct.
|
dagger-json-schema is a tool to generate json schema from Dagger module config struct. |
|
idtui
Package idtui provides terminal user interface frontends for Dagger operations.
|
Package idtui provides terminal user interface frontends for Dagger operations. |
|
internal/ioctx
Package ioctx provides a way to pass standard input, output, and error streams through a context.Context.
|
Package ioctx provides a way to pass standard input, output, and error streams through a context.Context. |
|
docs
|
|
|
src/scripts
command
|
|
|
distconsts
Package consts exists to facilitate sharing values between our CI infra and dependent code (e.g.
|
Package consts exists to facilitate sharing values between our CI infra and dependent code (e.g. |
|
ebpf
Package ebpf provides eBPF-based tracing utilities for the Dagger engine.
|
Package ebpf provides eBPF-based tracing utilities for the Dagger engine. |
|
ebpf/filetracer
Package filetracer provides an eBPF-based tracer for file operations performed by the dagger-engine process.
|
Package filetracer provides an eBPF-based tracer for file operations performed by the dagger-engine process. |
|
ebpf/ovltracer
Package ovltracer provides an eBPF-based tracer for catching overlayfs "in-use" errors (EBUSY).
|
Package ovltracer provides an eBPF-based tracer for catching overlayfs "in-use" errors (EBUSY). |
|
vcs
Package vcs exposes functions for resolving import paths and using version control systems, which can be used to implement behavior similar to the standard "go get" command.
|
Package vcs exposes functions for resolving import paths and using version control systems, which can be used to implement behavior similar to the standard "go get" command. |
|
internal
|
|
|
buildkit/client/connhelper
Package connhelper provides helpers for connecting to a remote daemon host with custom logic.
|
Package connhelper provides helpers for connecting to a remote daemon host with custom logic. |
|
buildkit/client/connhelper/kubepod
Package kubepod provides connhelper for kube-pod://<pod>
|
Package kubepod provides connhelper for kube-pod://<pod> |
|
buildkit/client/connhelper/ssh
Package ssh provides connhelper for ssh://<SSH URL>
|
Package ssh provides connhelper for ssh://<SSH URL> |
|
buildkit/frontend/dockerfile/command
Package command contains the set of Dockerfile commands.
|
Package command contains the set of Dockerfile commands. |
|
buildkit/frontend/dockerfile/parser
The parser package implements a parser that transforms a raw byte-stream into a low-level Abstract Syntax Tree.
|
The parser package implements a parser that transforms a raw byte-stream into a low-level Abstract Syntax Tree. |
|
sdk
|
|
|
go/engineconn
This is an extremely minimal subset of github.com/dagger/otel-go so we can avoid depending on everything else.
|
This is an extremely minimal subset of github.com/dagger/otel-go so we can avoid depending on everything else. |
|
skills
|
|
|
cache-expert/scripts
command
|
|
|
util
|
|
|
ctrns
ctrns provides utilities for containerd resources that are pre-namespaced (instead)
|
ctrns provides utilities for containerd resources that are pre-namespaced (instead) |
|
gitutil
gitutil and its contents is originally forked from github.com/dagger/dagger/internal/buildkit/util/gitutil
|
gitutil and its contents is originally forked from github.com/dagger/dagger/internal/buildkit/util/gitutil |
|
llbtodagger
Package llbtodagger converts BuildKit LLB definitions into Dagger call IDs.
|
Package llbtodagger converts BuildKit LLB definitions into Dagger call IDs. |
|
patternmatcher
package patternmatcher is used for implementing globbing, and is forked from github.com/moby/patternmatcher/
|
package patternmatcher is used for implementing globbing, and is forked from github.com/moby/patternmatcher/ |