From 035e3c5b4354cc3d945260a8202a8fcc98c7c2c9 Mon Sep 17 00:00:00 2001
From: Milas Bowman <milas.bowman@docker.com>
Date: Tue, 5 Jul 2022 11:58:31 -0400
Subject: [PATCH] fastapi: add dev envs support

Signed-off-by: Milas Bowman <milas.bowman@docker.com>
---
 fastapi/.docker/docker-compose.yaml | 13 +++++++++++++
 fastapi/Dockerfile                  | 23 +++++++++++++++++++----
 fastapi/README.md                   |  9 +++++++++
 fastapi/compose.yaml                |  5 +++--
 4 files changed, 44 insertions(+), 6 deletions(-)
 create mode 100644 fastapi/.docker/docker-compose.yaml

diff --git a/fastapi/.docker/docker-compose.yaml b/fastapi/.docker/docker-compose.yaml
new file mode 100644
index 0000000..d4f2188
--- /dev/null
+++ b/fastapi/.docker/docker-compose.yaml
@@ -0,0 +1,13 @@
+services:
+  api:
+    build:
+      context: .
+      target: dev-envs
+    container_name: fastapi-application
+    environment:
+      PORT: 8000
+    ports:
+      - '8000:8000'
+    volumes:
+      - /var/run/docker.sock:/var/run/docker.sock
+    restart: "no"
diff --git a/fastapi/Dockerfile b/fastapi/Dockerfile
index 5b5bf8c..ec2aa35 100644
--- a/fastapi/Dockerfile
+++ b/fastapi/Dockerfile
@@ -1,11 +1,26 @@
-FROM tiangolo/uvicorn-gunicorn-fastapi:python3.9-slim
+# syntax = docker/dockerfile:1.4
+
+FROM tiangolo/uvicorn-gunicorn-fastapi:python3.9-slim AS builder
 
 WORKDIR /app
 
-RUN apt update
-
 COPY requirements.txt ./
-RUN pip install --no-cache-dir -r requirements.txt
+RUN --mount=type=cache,target=/root/.cache/pip \
+    pip install -r requirements.txt
 
 COPY ./app ./app
 
+FROM builder as dev-envs
+
+RUN <<EOF
+apt-get update
+apt-get install -y --no-install-recommends git
+EOF
+
+RUN <<EOF
+useradd -s /bin/bash -m vscode
+groupadd docker
+usermod -aG docker vscode
+EOF
+# install Docker tools (cli, buildx, compose)
+COPY --from=gloursdocker/docker / /
diff --git a/fastapi/README.md b/fastapi/README.md
index 27f5957..4d20eea 100644
--- a/fastapi/README.md
+++ b/fastapi/README.md
@@ -52,4 +52,13 @@ Stop and remove the containers
 $ docker compose down
 ```
 
+## Use with Docker Development Environments
 
+You can use this sample with the Dev Environments feature of Docker Desktop.
+
+![Screenshot of creating a Dev Environment in Docker Desktop](../dev-envs.png)
+
+To develop directly on the services inside containers, use the HTTPS Git url of the sample:
+```
+https://github.com/docker/awesome-compose/tree/master/fastapi
+```
diff --git a/fastapi/compose.yaml b/fastapi/compose.yaml
index bcd0c6e..c481217 100644
--- a/fastapi/compose.yaml
+++ b/fastapi/compose.yaml
@@ -1,10 +1,11 @@
 services:
   api:
-    build: .
+    build:
+      context: .
+      target: builder
     container_name: fastapi-application
     environment:
       PORT: 8000
     ports:
       - '8000:8000'
     restart: "no"
-