container

The container module manages containers using Docker or Podman. The runtime is auto-detected, or can be specified explicitly.

Usage

container "myapp" {
    image "registry.example.com/myapp:latest"
    state "running"
    runtime "podman"
    install-runtime #true
    restart "always"
    ports {
        - "8080:80"
        - "8443:443"
    }
    environment {
        DATABASE_URL "postgres://db:5432/app"
        LOG_LEVEL "info"
    }
    volumes {
        - "/data/myapp:/app/data"
    }
}

Parameters

Parameter	Type	Description
(positional)	string	Container name
image	string	Container image reference
state	string	"running", "stopped", or "absent"
runtime	string	"docker" or "podman" (default: auto-detect)
install-runtime	boolean	Auto-install the runtime if not found
restart	string	Restart policy: "always", "on-failure", "no"
ports	list	Port mappings (host:container)
environment	map	Environment variables
volumes	list	Volume mounts (host:container)

Idempotency

The module checks if a container with the given name exists and is in the desired state. For running, it also verifies the image matches. If a container exists with a different image, it is replaced.

Example

See the container-app example for a complete containerized deployment.