Skip to content

README.md

Latest commit

 

History

History
52 lines (32 loc) · 2.15 KB

README.md

File metadata and controls

52 lines (32 loc) · 2.15 KB

Labspace - Compose Quickstart

An interactive lab that teaches Docker Compose fundamentals by building a multi-container Python Flask and Redis application from scratch. Learners progress from a bare compose.yaml through health checks, live development with watch mode, data persistence with volumes, and multi-file Compose configurations.

Learning objectives

This Labspace will teach you the following:

  • Define a multi-service app in a compose.yaml file
  • Control startup order with health checks and depends_on
  • Iterate on code quickly using watch mode
  • Persist data across container restarts with named volumes
  • Compose multi-file configurations with the include directive
  • Use core debugging commands (config, logs, exec)

Launch the Labspace

To launch the Labspace, run the following command:

docker compose -f oci://dockersamples/labspace-compose-quickstart up -d

And then open your browser to http://localhost:3030.

Using the Docker Desktop extension

If you have the Labspace extension installed (docker extension install dockersamples/labspace-extension if not), you can also click this link to launch the Labspace.

Contributing

If you find something wrong or something that needs to be updated, feel free to submit a PR. If you want to make a larger change, feel free to fork the repo into your own repository.

Important note: If you fork it, you will need to update the GHA workflow to point to your own Hub repo.

  1. Clone this repo

  2. Start the Labspace in content development mode:

    # On Mac/Linux
CONTENT_PATH=$PWD docker compose up --watch

# On Windows with PowerShell
$Env:CONTENT_PATH = (Get-Location).Path; docker compose up --watch

  3. Open the Labspace at http://dockerlabs.xyz.

  4. Make the necessary changes and validate they appear as you expect in the Labspace

    Be sure to check out the docs for additional information and guidelines.