.dockerignore

@@ -14,5 +14,23 @@ coverage
 .env
 .env.*
 
+# Secrets & credentials (E00-S02-T08) — never part of the build context, so a
+# secret-bearing file cannot be embedded in the image even if a developer has
+# one locally. Keep this list in sync with tests/secrets-not-embedded.test.mjs.
+.npmrc
+.netrc
+.credentials
+.aws
+.ssh
+secrets
+secrets/
+*.pem
+*.key
+*.p12
+*.pfx
+*.jks
+id_rsa
+id_ed25519
+
 # Logs
 *.log

apps/server/Dockerfile

@@ -17,6 +17,15 @@
 # T05 the runtime stage drops root privileges (runs as the image's non-root
 # `node` user).
 #
+# T08: the image embeds no secrets. The Dockerfile declares no secret-bearing
+# ARG/ENV instruction (the only ENV is `NODE_ENV=production`) and every COPY
+# copies a fixed, non-secret path (manifests, source, compiled dist) — never
+# `.env` or credential files; `.dockerignore` additionally excludes env and
+# credential files from the build context, so a local secret file cannot be
+# embedded even by mistake. Runtime credentials (e.g. DATABASE_URL) are
+# injected by Compose at run time (compose.yaml `app.environment`), never baked
+# into the image. Tests: tests/secrets-not-embedded.test.mjs.
+#
 # Image base: node:24.19.0-bookworm-slim (glibc Debian) per Technology-Stack
 # §5.4 — argon2 is a native dependency and musl/Alpine causes native-module
 # build surprises, so the image must stay on a glibc base.

compose.yaml

@@ -1,4 +1,4 @@
-# EPPP Docker Compose baseline — [E00-S02-T01..T07]
+# EPPP Docker Compose baseline — [E00-S02-T01..T08]
 #
 # `docker compose up -d` starts both the database (PostgreSQL) and the
 # application (@personal-blog/server). Rollback: `docker compose down`.
@@ -37,8 +37,14 @@
 # so local runs and the T01..T06 real-stack probes are unaffected. Rollback:
 # drop the `platforms` list from the `app` build config.
 #
-# Explicitly out of scope for T01..T07 (land in a later E00-S02 task):
-#   - secrets not embedded (T08)
+# Secrets not embedded (T08): the app image carries no secrets — the committed
+# apps/server/Dockerfile declares no secret-bearing ARG/ENV instruction and
+# copies only fixed, non-secret paths, and the committed .dockerignore excludes
+# env and credential files from the build context. Runtime credentials are
+# injected here, at run time, via service `environment` values (the app's
+# DATABASE_URL, the db service's POSTGRES_* defaults) — they live in
+# Compose/deploy config, never in the image. Rollback: rebuild the image after
+# removing any embedded secret. Tests: tests/secrets-not-embedded.test.mjs.
 #
 # All values have defaults so `docker compose up -d` works from a clean clone
 # without a .env file (a committed .env.example template lands in E00-S04).