Skip to content

Document Docker as a prerequisite for AWS deployment #237

Description

@scottgerring

Problem

The mise run aws:deploy:local command uses CDK's ContainerImage.fromAsset(), which shells out to docker build to build images locally. If Docker Desktop isn't running, the deploy fails with an unclear error. The README doesn't list Docker as a prerequisite for AWS deployment — only for Docker Compose usage.

Suggested Fix

  1. The deploy task should validate that Docker exists and is usable (e.g. docker info) before starting, and produce a clear error message if not.

  2. Add an explicit prerequisites section to the AWS deployment docs that states Docker Desktop (or a compatible daemon) must be installed and running for local deploy variants that build container images on the machine.

Part of #235

Metadata

Metadata

Assignees

No one assigned

    Labels

    awsdocumentationImprovements or additions to documentation

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions