chore: add deployment (Docker, compose, k8s) and CI workflow for bookkeeper app

Author: github-copilot

samples/book-app-project/Dockerfile

@@ -0,0 +1,12 @@
+FROM python:3.10-slim
+
+WORKDIR /app
+
+# Install test tool (no runtime dependencies required for the app itself)
+RUN pip install --no-cache-dir pytest
+
+# Copy application files
+COPY . /app
+
+# Default to showing help when container runs without args
+CMD ["python", "book_app.py", "help"]

samples/book-app-project/README.deploy.md

@@ -0,0 +1,27 @@
+Deployment instructions for the sample book app
+
+Build locally with Docker:
+
+```bash
+cd samples/book-app-project
+docker build -t bookkeeper-app:local .
+```
+
+Run the container (interactive CLI):
+
+```bash
+docker run --rm -it -v "$(pwd)/data.json:/app/data.json" bookkeeper-app:local python book_app.py list
+```
+
+Or use docker-compose for an interactive shell session:
+
+```bash
+cd samples/book-app-project
+docker-compose run --rm bookkeeper-app list
+```
+
+Run tests inside the image:
+
+```bash
+docker run --rm bookkeeper-app:local pytest -q
+```

samples/book-app-project/docker-compose.yml

@@ -0,0 +1,11 @@
+version: "3.8"
+
+services:
+  bookkeeper-app:
+    build: .
+    image: bookkeeper-app:local
+    volumes:
+      - ./data.json:/app/data.json
+    stdin_open: true
+    tty: true
+    entrypoint: ["python", "book_app.py"]

samples/book-app-project/k8s/README.md

@@ -0,0 +1,26 @@
+Kubernetes deployment for the Bookkeeper sample
+
+This folder contains a `ConfigMap` with `data.json` and a `Job` manifest that runs the CLI command `python book_app.py list`.
+
+Usage (build and push image to a registry first):
+
+```bash
+# Build and tag
+cd samples/book-app-project
+docker build -t ghcr.io/<your-user>/bookkeeper-app:latest .
+
+# Push (example: GitHub Container Registry)
+docker push ghcr.io/<your-user>/bookkeeper-app:latest
+
+# Apply k8s resources
+kubectl apply -f k8s/configmap-data.yaml
+kubectl apply -f k8s/job-list.yaml
+
+# Watch job
+kubectl get jobs
+kubectl logs job/bookkeeper-list-job
+```
+
+Notes:
+- The sample app is a CLI, not a long-running server. A `Job` is used to execute a one-time command.
+- If you use a local cluster (kind/minikube) you may need to load the local image into the cluster instead of pushing to a registry.

samples/book-app-project/k8s/configmap-data.yaml

@@ -0,0 +1,38 @@
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: book-data
+data:
+  data.json: |-
+    [
+      {
+        "title": "The Hobbit",
+        "author": "J.R.R. Tolkien",
+        "year": 1937,
+        "read": false
+      },
+      {
+        "title": "1984",
+        "author": "George Orwell",
+        "year": 1949,
+        "read": true
+      },
+      {
+        "title": "Dune",
+        "author": "Frank Herbert",
+        "year": 1965,
+        "read": false
+      },
+      {
+        "title": "To Kill a Mockingbird",
+        "author": "Harper Lee",
+        "year": 1960,
+        "read": false
+      },
+      {
+        "title": "Mysterious Book",
+        "author": "",
+        "year": 0,
+        "read": false
+      }
+    ]

samples/book-app-project/k8s/job-list.yaml

@@ -0,0 +1,27 @@
+apiVersion: batch/v1
+kind: Job
+metadata:
+  name: bookkeeper-list-job
+  labels:
+    app: bookkeeper
+spec:
+  template:
+    metadata:
+      labels:
+        app: bookkeeper
+    spec:
+      containers:
+      - name: bookkeeper
+        image: bookkeeper-app:latest
+        imagePullPolicy: IfNotPresent
+        command: ["python", "book_app.py", "list"]
+        volumeMounts:
+        - name: data-json
+          mountPath: /app/data.json
+          subPath: data.json
+      restartPolicy: Never
+      volumes:
+      - name: data-json
+        configMap:
+          name: book-data
+  backoffLimit: 2