Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

docker

package

v0.13.0 Latest Latest Go to latest Published: Apr 20, 2026 License: MIT Imports: 16 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/vaayne/anna

Links

Open Source Insights

Documentation ¶

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

func NewFactory ¶

func NewFactory(cfg Config) sandboxpkg.Factory

NewFactory returns a Factory backed by a Docker container-per-session strategy.

func Preflight ¶

func Preflight(ctx context.Context, cfg PreflightConfig) error

Preflight checks daemon reachability and image availability. A missing image is pulled automatically; the caller is expected to have built or published the image ahead of time for dev builds (the pull will fail with a registry error in that case).

Types ¶

type Config ¶

type Config struct {
	// Image is the container image to use. Required.
	Image string

	// ContainerPathPrefix / HostPathPrefix enable path alignment when anna
	// runs inside a container and talks to the daemon on the host (DooD).
	// Both fields are filled by applyDooDDefaults in the runner; callers
	// outside that path should leave them empty.
	ContainerPathPrefix string
	HostPathPrefix      string
}

Config configures the docker sandbox factory. All fields are populated by the runner glue layer — there are no user-facing knobs. The image is version-locked to the anna binary (via internal/config.SandboxDockerImage) and the path-prefix fields are auto-derived from ANNA_HOME_HOST when anna runs inside a container (see internal/agent/runner/sandbox_dood.go).

func (Config) TranslateToDaemonPath ¶

func (c Config) TranslateToDaemonPath(path string) string

TranslateToDaemonPath rewrites an anna-view absolute path into the path the daemon will use as a bind-mount source. When prefix translation is not configured, the input is returned unchanged.

type DirEntry ¶

type DirEntry = sandboxpkg.DirEntry

Type aliases for the pkg/sandbox contract — keeps import noise minimal in callers.

type Edit ¶

type Edit = sandboxpkg.Edit

Type aliases for the pkg/sandbox contract — keeps import noise minimal in callers.

type EditResult ¶

type EditResult = sandboxpkg.EditResult

Type aliases for the pkg/sandbox contract — keeps import noise minimal in callers.

type ExecOptions ¶

type ExecOptions = sandboxpkg.ExecOptions

Type aliases for the pkg/sandbox contract — keeps import noise minimal in callers.

type ExecResult ¶

type ExecResult = sandboxpkg.ExecResult

Type aliases for the pkg/sandbox contract — keeps import noise minimal in callers.

type FilesystemPolicy ¶

type FilesystemPolicy = sandboxpkg.FilesystemPolicy

Type aliases for the pkg/sandbox contract — keeps import noise minimal in callers.

type HTTPOptions ¶

type HTTPOptions = sandboxpkg.HTTPOptions

Type aliases for the pkg/sandbox contract — keeps import noise minimal in callers.

type HTTPResult ¶

type HTTPResult = sandboxpkg.HTTPResult

Type aliases for the pkg/sandbox contract — keeps import noise minimal in callers.

type HTTPStream ¶

type HTTPStream = sandboxpkg.HTTPStream

Type aliases for the pkg/sandbox contract — keeps import noise minimal in callers.

type Host ¶

type Host = sandboxpkg.Host

Type aliases for the pkg/sandbox contract — keeps import noise minimal in callers.

type Policy ¶

type Policy = sandboxpkg.Policy

Type aliases for the pkg/sandbox contract — keeps import noise minimal in callers.

type PolicyCompatibilityError ¶

type PolicyCompatibilityError = sandboxpkg.PolicyCompatibilityError

Type aliases for the pkg/sandbox contract — keeps import noise minimal in callers.

type PreflightConfig ¶

type PreflightConfig struct {
	AnnaHome string
	Docker   Config
}

PreflightConfig configures a Preflight check.

type ProcessHandle ¶

type ProcessHandle = sandboxpkg.ProcessHandle

Type aliases for the pkg/sandbox contract — keeps import noise minimal in callers.

type ProcessRequest ¶

type ProcessRequest = sandboxpkg.ProcessRequest

Type aliases for the pkg/sandbox contract — keeps import noise minimal in callers.

type ReadResult ¶

type ReadResult = sandboxpkg.ReadResult

Type aliases for the pkg/sandbox contract — keeps import noise minimal in callers.

type Session ¶

type Session = sandboxpkg.Session

Type aliases for the pkg/sandbox contract — keeps import noise minimal in callers.

type StatResult ¶

type StatResult = sandboxpkg.StatResult

Type aliases for the pkg/sandbox contract — keeps import noise minimal in callers.

type TempFile ¶

type TempFile = sandboxpkg.TempFile

Type aliases for the pkg/sandbox contract — keeps import noise minimal in callers.

type WriteResult ¶

type WriteResult = sandboxpkg.WriteResult

Type aliases for the pkg/sandbox contract — keeps import noise minimal in callers.

Source Files ¶

View all Source files

Directories ¶

Path	Synopsis
dockerclient Package dockerclient wraps the moby Go SDK (github.com/moby/moby/client) to manage sandbox containers for the docker sandbox backend.	Package dockerclient wraps the moby Go SDK (github.com/moby/moby/client) to manage sandbox containers for the docker sandbox backend.