Skip to content
Ansible Developer Tools

EE Dev Containers

Ansible Execution Environments (EEs) are container images that bundle Ansible, collections, and dependencies. This extension uses VS Code Dev Containers for EE-based development (see ADR-003) rather than routing host commands through docker run / podman run.

Full guide

Section titled “Full guide”

See Dev Containers under Editor Integration for:

  • Using a Dev Container day to day
  • Adding a .devcontainer/ file with ansible-creator (ac_add_res_devc / CLI)
  • Layering ansible-dev-tools onto an EE (outer Containerfile or EE definition)
  • Podman path, SSH agent, and C-in-C runArgs notes

Quick path

Section titled “Quick path”

  1. Ensure the EE includes ansible-dev-tools (bake into execution-environment.yml or build an outer Containerfile).

  2. Scaffold config:

    Terminal window
    ansible-creator add resource devcontainer /path/to/project --image <ee-or-layered-image>

    Or right-click an EE in the sidebar → Add Dev Container.

  3. Dev Containers: Reopen in Container.

Migrating from the old EE mode

Section titled “Migrating from the old EE mode”

If you used ansible.executionEnvironment.* on the main branch, see Migrating from EE Mode.