Skip to main content
Examples/Container Sandbox
EXAMPLE

Container Sandbox

Run an entire [Atmos workflow](https://atmos.tools/cli/commands/workflow) inside one shared container sandbox.

DX
Try it out View on GitHub
cloudposse / atmos

Try it out

Copy the example into a new directory and make it your own:

atmos init examples/container-sandbox
cd container-sandbox

Follow the README for prerequisites and next steps.

Initialization and repository settings

See it in action

RECORDED DEMO
container-sandbox
Recorded from this example
Real commands. Real output.
README.md1.1 KB
View on GitHub

Example: Container Sandbox

Run an entire Atmos workflow inside one shared container sandbox.

Shell steps inherit the workflow-level container: configuration and execute in the same long-lived container. The example writes a file in one containerized step, reads it from another, opts one step out to run on the host, then cleans up the generated file.

Try It

cd examples/container-sandbox

# Preview the sandbox container and exec commands
atmos workflow sandbox -f container-sandbox --dry-run

# Run the workflow. Requires Docker or Podman.
atmos workflow sandbox -f container-sandbox

Key Files

FilePurpose
atmos.yamlConfigures the workflow base path
workflows/container-sandbox.yamlWorkflow-level container sandbox example