Update Dockerfile and documentation for http-server example

Co-authored-by: coolwednesday <[email protected]>

Author: ckshitij

examples/http-server/Dockerfile

@@ -1,16 +1,25 @@
 # Build stage
-FROM golang:1.24 AS build
+FROM golang:1.25-alpine AS build
+RUN apk add --no-cache build-base
 
 WORKDIR /src
+
+# Copy go.mod + go.sum first for better caching
+COPY go.mod go.sum ./
+RUN go mod download
+
+# Copy the rest of the source code
 COPY . .
-RUN go get ./...
-RUN go build -ldflags "-linkmode external -extldflags -static" -a -o /app/main main.go
+
+# Move into http-server folder and build the package (not main.go)
+WORKDIR /src/examples/http-server
+RUN CGO_ENABLED=0 go build -a -o /app/main .
 
 # Final stage
 FROM alpine:3.14
 RUN apk add --no-cache tzdata ca-certificates
 COPY --from=build /app/main /main
-COPY --from=build /src/configs /configs
+COPY --from=build /src/examples/http-server/configs /configs
 EXPOSE 9000
 
-CMD ["/main"]
+CMD ["/main"]

examples/http-server/README.md

@@ -2,16 +2,56 @@
 
 This GoFr example demonstrates a simple HTTP server which supports Redis and MySQL as datasources.
 
-### To run the example follow the steps below:
+### To run the example, follow the steps below:
+
+#### 1. Run with Docker Compose (recommended)
+
+From the project root (`/gofr`):
+
+```console
+docker compose -f examples/http-server/docker/docker-compose.yml up -d
+```
+
+* Explanation:
+
+    * `-f examples/http-server/docker/docker-compose.yml` → path to the docker-compose file
+    * `up -d` → builds (if needed) and runs services in detached mode
+
+---
+
+#### 2. Build & Run Manually (without docker-compose)
+
+##### Build the Docker image
+
+From the project root (`/gofr`):
+
+```console
+docker build -f examples/http-server/Dockerfile -t http-server:latest .
+```
+
+* Explanation:
+
+    * `-f examples/http-server/Dockerfile` → path to the Dockerfile
+    * `-t http-server:latest` → tag for the Docker image
+    * `.` → build context (project root; needed for `go.mod` and `go.sum`)
+
+##### Run the Docker container
 
-- Run the docker image of the application
 ```console
-docker-compose up -d
+docker run -p 9000:9000 --name http-server http-server:latest
 ```
 
+* Explanation:
+    * `-p 9000:9000` → maps container port 9000 to host port 9000
+    * `--name http-server` → optional, gives your container a name
+
+* Use **Compose** when you want the whole stack (app + Redis + MySQL + Grafana + Prometheus).
+* Use **Docker build/run** when you just want to run the app container alone.
+
 To test the example, follow these steps:
 
 1. Open your browser and navigate to `http://localhost:9000/hello`.
 2. To view the GoFr trace, open `https://tracer.gofr.dev` and paste the traceid.
-3. To view the Grafana Dashboard open `http://localhost:3000`
-
+3. To access the Grafana Dashboard, open `http://localhost:3000`. The dashboard UI will be displayed. Use the default admin credentials to log in:
+    - Username: `admin`
+    - Password: `password`

examples/http-server/docker/docker-compose.yaml

@@ -3,19 +3,19 @@ version: '3.8'
 services:
   gofr-http-server:
     build:
-      context: ../.
-      dockerfile: Dockerfile
+      context: ../../../           # project root (so go.mod and go.sum are included)
+      dockerfile: examples/http-server/Dockerfile
     environment:
-      - TRACE_EXPORTER=gofr
-      - TRACER_RATIO=0.1
-      - REDIS_HOST=redisdb
-      - REDIS_PORT=6379
-      - DB_HOST=mysqldb
-      - DB_USER=root
-      - DB_PASSWORD=password
-      - DB_NAME=test
-      - DB_PORT=3306
-      - DB_DIALECT=mysql
+      TRACE_EXPORTER: gofr
+      TRACER_RATIO: 0.1
+      REDIS_HOST: redisdb
+      REDIS_PORT: 6379
+      DB_HOST: mysqldb
+      DB_USER: root
+      DB_PASSWORD: password
+      DB_NAME: test
+      DB_PORT: 3306
+      DB_DIALECT: mysql
     ports:
       - "9000:9000"
       - "2121:2121"
@@ -49,8 +49,8 @@ services:
     ports:
       - "3000:3000"
     environment:
-      - GF_SECURITY_ADMIN_USER=admin
-      - GF_SECURITY_ADMIN_PASSWORD=password
+      GF_SECURITY_ADMIN_USER: admin
+      GF_SECURITY_ADMIN_PASSWORD: password
     volumes:
       - ./provisioning:/etc/grafana/provisioning
     networks: