nginx-golang: add dev envs support (#273)

* Add Docker Desktop Developer Environments config
* Upgrade from Go 1.13 (🙀) to 1.18
* Rename `frontend` -> `proxy` for clarity & consistency
  with other samples
* Add Chi as a dependency to provide an example of Go
  module dependencies for parity with other samples

Signed-off-by: Milas Bowman <milas.bowman@docker.com>

nginx-golang/.docker/docker-compose.yaml

@@ -0,0 +1,19 @@
+services:
+  proxy:
+    image: nginx
+    volumes:
+      - type: bind
+        source: ./proxy/nginx.conf
+        target: /etc/nginx/conf.d/default.conf
+        read_only: true
+    ports:
+      - 80:80
+    depends_on:
+      - backend
+
+  backend:
+    build:
+      context: backend
+      target: dev-envs
+    volumes:
+      - /var/run/docker.sock:/var/run/docker.sock

nginx-golang/README.md

@@ -1,5 +1,5 @@
 ## Compose sample application
-### NGINX proxy with GO backend
+### NGINX proxy with Go backend
 
 Project structure:
 ```
@@ -8,25 +8,32 @@ Project structure:
 │   ├── Dockerfile
 │   └── main.go
 ├── compose.yaml
-├── frontend
-│   ├── Dockerfile
+├── proxy
 │   └── nginx.conf
 └── README.md
 ```
 
-[_compose.yaml_](compose.yaml)
+[`compose.yaml`](compose.yaml)
 ```
 services:
-  frontend:
-    build: frontend
+  proxy:
+    image: nginx
+    volumes:
+      - type: bind
+        source: ./proxy/nginx.conf
+        target: /etc/nginx/conf.d/default.conf
+        read_only: true
     ports:
       - 80:80
     depends_on:
       - backend
+
   backend:
-    build: backend
+    build:
+      context: backend
+      target: builder
 ```
-The compose file defines an application with two services `frontend` and `backend`.
+The compose file defines an application with two services `proxy` and `backend`.
 When deploying the application, docker compose maps port 80 of the frontend service container to the same port of the host as specified in the file.
 Make sure port 80 on the host is not already in use.
 
@@ -40,20 +47,19 @@ Step 1/7 : FROM golang:1.13 AS build
 1.13: Pulling from library/golang
 ...
 Successfully built 4b24f27138cc
-Successfully tagged nginx-golang_frontend:latest
-WARNING: Image for service frontend was built because it did not already exist. To rebuild this image you must use `docker-compose build` or `docker-compose up --build`.
+Successfully tagged nginx-golang_proxy:latest
 Creating nginx-golang_backend_1 ... done
-Creating nginx-golang_frontend_1 ... done
+Creating nginx-golang_proxy_1 ... done
 ```
 
 ## Expected result
 
 Listing containers must show two containers running and the port mapping as below:
 ```
-$ docker ps
-CONTAINER ID        IMAGE                   COMMAND                  CREATED             STATUS              PORTS                  NAMES
-8bd5b0d78e73        nginx-golang_frontend   "nginx -g 'daemon of…"   53 seconds ago      Up 52 seconds       0.0.0.0:80->80/tcp     nginx-golang_frontend_1
-56f929c240a0        nginx-golang_backend    "/usr/local/bin/back…"   53 seconds ago      Up 53 seconds                              nginx-golang_backend_1
+$ docker compose ps
+NAME                     COMMAND                  SERVICE             STATUS              PORTS
+nginx-golang-backend-1   "/code/bin/backend"      backend             running
+nginx-golang-proxy-1     "/docker-entrypoint.…"   proxy               running             0.0.0.0:80->80/tcp
 ```
 
 After the application starts, navigate to `http://localhost:80` in your web browser or run:
@@ -77,3 +83,14 @@ 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/nginx-golang
+```

nginx-golang/backend/Dockerfile

@@ -1,11 +1,41 @@
-FROM golang:1.13 AS build
+# syntax=docker/dockerfile:1.4
+FROM --platform=$BUILDPLATFORM golang:1.18-alpine AS builder
 
-WORKDIR /compose/hello-docker
-COPY main.go main.go
-RUN CGO_ENABLED=0 go build -o backend main.go
+WORKDIR /code
 
-FROM scratch
-COPY --from=build /compose/hello-docker/backend /usr/local/bin/backend
-CMD ["/usr/local/bin/backend"]
+ENV CGO_ENABLED 0
+ENV GOPATH /go
+ENV GOCACHE /go-build
+
+COPY go.mod go.sum ./
+RUN --mount=type=cache,target=/go/pkg/mod/cache \
+    go mod download
+
+COPY . .
+
+RUN --mount=type=cache,target=/go/pkg/mod/cache \
+    --mount=type=cache,target=/go-build \
+    go build -o bin/backend main.go
+
+CMD ["/code/bin/backend"]
 
+FROM builder as dev-envs
 
+RUN <<EOF
+apk update
+apk add git
+EOF
+
+RUN <<EOF
+addgroup -S docker
+adduser -S --shell /bin/bash --ingroup docker vscode
+EOF
+
+# install Docker tools (cli, buildx, compose)
+COPY --from=gloursdocker/docker / /
+
+CMD ["go", "run", "main.go"]
+
+FROM scratch
+COPY --from=builder /code/bin/backend /usr/local/bin/backend
+CMD ["/usr/local/bin/backend"]

nginx-golang/backend/go.mod

@@ -0,0 +1,5 @@
+module github.com/docker/awesome-compose/nginx-golang/backend
+
+go 1.18
+
+require github.com/go-chi/chi/v5 v5.0.7

nginx-golang/backend/go.sum

@@ -0,0 +1,2 @@
+github.com/go-chi/chi/v5 v5.0.7 h1:rDTPXLDHGATaeHvVlLcR4Qe0zftYethFucbjVQ1PxU8=
+github.com/go-chi/chi/v5 v5.0.7/go.mod h1:DslCQbL2OYiznFReuXYUmQ2hGd1aDpCnlMNITLSKoi8=

nginx-golang/backend/main.go

@@ -4,11 +4,14 @@ import (
 	"fmt"
 	"log"
 	"net/http"
+
+	"github.com/go-chi/chi/v5"
+	"github.com/go-chi/chi/v5/middleware"
 )
 
 func handler(w http.ResponseWriter, r *http.Request) {
-	fmt.Println(r.URL.RawQuery)
-	fmt.Fprintf(w, `
+	fmt.Fprintf(
+		w, `
           ##         .
     ## ## ##        ==
  ## ## ## ## ##    ===
@@ -21,10 +24,15 @@ func handler(w http.ResponseWriter, r *http.Request) {
 	
 Hello from Docker!
 
-`)
+`,
+	)
 }
 
 func main() {
-	http.HandleFunc("/", handler)
-	log.Fatal(http.ListenAndServe(":80", nil))
+	r := chi.NewRouter()
+	r.Use(middleware.Logger)
+	r.Get("/", handler)
+
+	fmt.Println("Go backend started!")
+	log.Fatal(http.ListenAndServe(":80", r))
 }

nginx-golang/compose.yaml

@@ -1,9 +1,17 @@
 services:
-  frontend:
-    build: frontend
+  proxy:
+    image: nginx
+    volumes:
+      - type: bind
+        source: ./proxy/nginx.conf
+        target: /etc/nginx/conf.d/default.conf
+        read_only: true
     ports:
       - 80:80
     depends_on:
       - backend
+
   backend:
-    build: backend
+    build:
+      context: backend
+      target: builder

nginx-golang/frontend/Dockerfile

@@ -1,4 +0,0 @@
-FROM nginx:alpine 
-COPY nginx.conf /etc/nginx/conf.d/default.conf
-
-