PrepZone Logo
PrepZone

Writing Your First Production-Ready Dockerfile

FROM, COPY, RUN, EXPOSE, CMD — containerise the BookStore API step by step.

Why this matters

  • This topic directly affects how reliably BookStore reaches production — a dockerfile packages bookstore's jvm app with explicit runtime dependencies and a non-root user..
  • Interviewers connect hands-on commands and manifests to real delivery stories, not buzzwords.
  • Later modules assume you can explain both the why and the concrete file or command involved.
  • Platform maturity shows up when teams automate this instead of relying on tribal knowledge.
bookstore:1.2.0
Layer 4 — CMDjava -jar app.jar
Layer 3 — COPY jarApplication artefact
Layer 2 — RUN adduserNon-root user
Layer 1 — FROMeclipse-temurin:21-jre

Changing Layer 3 invalidates cache for layers 3 and 4 only

Each Dockerfile instruction creates a layer. Cached layers speed up rebuilds when nothing changed above them.

Instruction choices

COPY, USER, ENTRYPOINT: BookStore engineers treat this as part of the standard path from laptop to dockerfile essentials readiness. Document decisions in the team runbook so on-call knows which knobs exist.

Key ideas

  • Instruction choices — primary idea for dockerfile-essentials
  • BookStore context — catalog API, checkout, and inventory services share the same pattern
  • Automation — prefer pipeline jobs over manual SSH steps
  • Verification — staging must prove the change before prod traffic

BookStore runtime image

JRE-only final stage: When staging matches production architecture, BookStore catches misconfigurations early. Pair this section's practice with observability dashboards to confirm behavior under load.

Key ideas

  • BookStore runtime image — operational detail
  • Rollback — know how to revert without rebuilding artefacts
  • Security — least privilege for deploy roles
  • Documentation — link runbooks from the service README

Production checklist

Before promoting BookStore changes tied to this topic, run automated tests, inspect artefact immutability (image digest or JAR checksum), execute a staging smoke test on /actuator/health, and watch error-rate dashboards for thirty minutes after prod rollout.

Key ideas

  • Staging soak — validate under synthetic load
  • Change ticket — attach pipeline URL and artefact digest
  • On-call — page owner stays on dashboards during rollout
  • Post-deploy — record metrics baseline for comparison
Java
FROM eclipse-temurin:21-jre-alpine
WORKDIR /app
COPY target/bookstore-api.jar app.jar
USER 10001
EXPOSE 8080
ENTRYPOINT ["java","-jar","/app/app.jar"]

Quick recall

Everything you need if you only revisit this box.

  • BookStore uses dockerfile essentials as a standard delivery practice.
  • Prefer automation and versioned config over manual server changes.
  • Staging proves changes before customer-facing promotion.
  • Observability confirms success — do not rely on silence alone.
  • Rollback plans must be tested, not invented during an outage.
  • Security and least privilege apply to every pipeline and cluster role.

Test yourself

Answer these before moving on — recall is what makes it stick.