Add Docker run and test setup

Author: gabriele.sisinna

.dockerignore

@@ -0,0 +1,8 @@
+.git
+.github
+.gradle
+build
+out
+.idea
+.vscode
+*.iml

Dockerfile

@@ -0,0 +1,21 @@
+FROM eclipse-temurin:17-jdk-jammy AS builder
+
+WORKDIR /workspace
+
+COPY gradlew gradlew
+COPY gradlew.bat gradlew.bat
+COPY gradle gradle
+COPY build.gradle settings.gradle ./
+COPY src src
+
+RUN chmod +x gradlew && ./gradlew --no-daemon bootJar
+
+FROM eclipse-temurin:17-jre-jammy AS runtime
+
+WORKDIR /app
+
+COPY --from=builder /workspace/build/libs/*.jar app.jar
+
+EXPOSE 8080
+
+ENTRYPOINT ["java", "-jar", "/app/app.jar"]

README.md

@@ -60,6 +60,25 @@ Read these files in order:
 
 The app starts on `http://localhost:8080`.
 
+## Run with Docker
+
+Build and start the app container:
+
+```bash
+docker compose up --build app
+```
+
+Then open:
+
+- `http://localhost:8080/api/students`
+- `http://localhost:8080/swagger-ui.html`
+
+To stop it:
+
+```bash
+docker compose down
+```
+
 ## Try the API
 
 Get the seeded students:
@@ -119,6 +138,12 @@ openapi.yaml
 ./gradlew test
 ```
 
+Run the tests inside a container:
+
+```bash
+docker compose run --rm test
+```
+
 ## GitHub CI
 
 This repo includes a GitHub Actions workflow at `.github/workflows/ci.yml`.

docker-compose.yml

@@ -0,0 +1,19 @@
+services:
+  app:
+    build:
+      context: .
+      dockerfile: Dockerfile
+    image: java-spring-learning:local
+    ports:
+      - "8080:8080"
+
+  test:
+    image: eclipse-temurin:17-jdk-jammy
+    working_dir: /workspace
+    command: ["./gradlew", "--no-daemon", "test"]
+    volumes:
+      - .:/workspace
+      - gradle-cache:/root/.gradle
+
+volumes:
+  gradle-cache: