container-imageslisted
Install: claude install-skill rustcircle/c101
# Container images
Build-side engineering for OCI images. The security checklist for containers (privileges, secrets,
runtime hardening review) stays in `security-review`; this skill is how to build images that pass it.
Image tags below were current in October 2026; pin by digest in real files (section 4).
Deep material:
[Dockerfile templates for Node, Go, Rust, JVM](references/dockerfile-templates.md) |
[multi-arch CI build, scanning, signing, compose](references/build-release-compose.md)
## 1. Layer ordering, context, cache and secret mounts
Order layers from least to most frequently changed. Every instruction after the first changed input is
rebuilt.
```
FROM base@digest # changes monthly (Renovate)
system packages # changes rarely
COPY lockfiles only # changes when deps change
install dependencies # cached unless lockfiles changed
COPY source # changes every commit
build / install project # cheap, last
```
`.dockerignore` (start from deny-by-default for large repos):
```
.git
**/.venv
**/node_modules
**/__pycache__
**/target
dist/
build/
.env*
*.pem
*.key
compose*.yaml
Dockerfile*
```
BuildKit mounts (`# syntax=docker/dockerfile:1` on line 1):
| Mount | Example | Effect |
|---|---|---|
| cache | `RUN --mount=type=cache,target=/root/.cache/uv uv sync --locked` | package cache survives across builds, never lands in a layer |
| cache (pnpm) | `--mount=type=cache,id=pnpm,target=/var/cache/pnpm` + `-