Move lab launch instructions to above the fold

Author: mikesir87

content/guides/lab-agentic-apps.md

@@ -26,6 +26,10 @@ Get up and running with building agentic applications using Compose, Docker
 Model Runner, and the Docker MCP Gateway. This hands-on lab takes you from
 understanding AI models to building complete agentic applications.
 
+## Launch the lab
+
+{{< labspace-launch image="dockersamples/labspace-agentic-apps-with-docker" model-download="true" >}}
+
 ## What you'll learn
 
 This lab covers three core areas of agentic application development:
@@ -51,27 +55,3 @@ file, and configuring your app to use those models and tools
 | 5 | The Docker MCP Gateway | Set up and configure the MCP Gateway |
 | 6 | Putting It All Together | Build a complete agentic application |
 | 7 | Conclusion | Summary and next steps |
-
-## Prerequisites
-
-- Install the latest version of Docker Desktop
-- Enable **Docker Model Runner** by going into Settings in Docker Desktop, choosing AI, then selecting Docker Model Runner
-- Pull the Gemma 3 model before launching by running this command:
-
-```console
-$ docker model pull ai/gemma3
-```
-
-## Launch the lab
-
-Start the labspace:
-
-```console
-$ docker compose -f oci://dockersamples/labspace-agentic-apps-with-docker up -d
-```
-
-Then open your browser to [http://localhost:3030](http://localhost:3030).
-
-> [!NOTE]
->
-> It may take a little while to start due to the AI model download.

content/guides/lab-docker-agent.md

@@ -28,6 +28,10 @@ agent concepts, then build sophisticated multi-agent teams that handle complex
 real-world tasks. Learn how to create, share, and orchestrate AI agents with
 Docker.
 
+## Launch the lab
+
+{{< labspace-launch image="dockersamples/labspace-cagent" >}}
+
 ## What you'll learn
 
 - Create simple agents with Docker Agent
@@ -48,18 +52,3 @@ Docker.
 | 5 | Sharing Agents | Package and share agents via Docker Registry |
 | 6 | Introduction to Sub-agents | Build multi-agent systems with sub-agent orchestration |
 | 7 | Conclusion | Summary and next steps |
-
-## Prerequisites
-
-- Latest version of Docker Desktop
-- Basic familiarity with Docker
-
-## Launch the lab
-
-Start the labspace:
-
-```console
-$ docker compose -f oci://dockersamples/labspace-cagent up -d
-```
-
-Then open your browser to [http://localhost:3030](http://localhost:3030).

content/guides/lab-mcp-gateway.md

@@ -23,9 +23,13 @@ params:
 ---
 
 This lab provides a comprehensive, hands-on overview of the Docker MCP Gateway,
-which enables you to run containerized MCP servers safely and securely. Learn
+which lets you run containerized MCP servers safely and securely. Learn
 how to configure, secure, and connect MCP servers to your agentic applications.
 
+## Launch the lab
+
+{{< labspace-launch image="dockersamples/labspace-mcp-gateway" >}}
+
 ## What you'll learn
 
 - Learn about the Docker MCP Gateway and its architecture
@@ -46,18 +50,3 @@ how to configure, secure, and connect MCP servers to your agentic applications.
 | 5 | Connecting MCP Gateway to Your App | Integrate the MCP Gateway with agentic frameworks |
 | 6 | Using a Custom MCP Server | Build and run your own custom MCP server |
 | 7 | Conclusion | Summary and next steps |
-
-## Prerequisites
-
-- The latest version of Docker Desktop with Docker Model Runner enabled
-- Basic familiarity with Docker and Docker Compose
-
-## Launch the lab
-
-Start the labspace:
-
-```console
-$ docker compose -f oci://dockersamples/labspace-mcp-gateway up -d
-```
-
-Then open your browser to [http://localhost:3030](http://localhost:3030).

content/includes/labspace-quickstart.md

@@ -0,0 +1,12 @@
+{{ $image := .Get "image" }}
+{{ $modelDownload := .Get "model-download" | default "false" }}
+
+{{ $step1 := printf "1. Start the labspace:\n\n   ```console\n   $ docker compose -f oci://%s up -d\n   ```" $image }}
+
+{{ if eq $modelDownload "true" }}
+  {{ $step1 = printf "%s\n\n   > [!NOTE]\n   >\n   > The lab may take a few minutes to launch, as this lab requires an AI model that will need to be downloaded." $step1 }}
+{{ end }}
+
+{{ $step2 := "2. Open your browser to [http://localhost:3030](http://localhost:3030)." }}
+
+{{ printf "%s\n\n%s" $step1 $step2 | .Page.RenderString (dict "display" "block") }}