docker-development
Use when working with ANY Docker task: writing Dockerfiles, configuring docker-compose/compose.yml, multi-stage builds, docker-bake.hcl, container security audits, .dockerignore optimization, or CI/CD container testing. Triggers on: Dockerfile, docker-compose, container, image build, multi-stage, docker bake, compose.
How do I install this agent skill?
npx skills add https://github.com/netresearch/docker-development-skill --skill docker-developmentIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides Docker development best practices and automated checks. It analyzes local Docker configuration files using shell-based mechanical checks and LLM-assisted reviews. A low risk of indirect prompt injection exists because the skill processes untrusted user content (Dockerfiles) within LLM prompts.
- Socketpass
No alerts
- Snykfail
Risk: CRITICAL · 2 issues
- ZeroLeakspass
Score: 93/100 · 2 sections analyzed
What does this agent skill do?
Docker Development
Core Principles
- Minimal -- Alpine/distroless, multi-stage
- Secure -- Non-root USER, no layer secrets, pin versions
- Testable -- entrypoint bypass, DNS mocking
- Cache-efficient -- deps first, clean in-layer
Quick Reference
Multi-Stage Build (Node.js)
FROM node:24-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY . .
FROM node:24-alpine
RUN addgroup -g 1001 app && adduser -u 1001 -G app -D app
USER app
COPY --from=builder /app .
HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
CMD wget -qO- http://localhost:3000/health || exit 1
CMD ["node", "server.js"]
Multi-Stage Build (Go -- scratch/distroless)
FROM golang:1.26-alpine AS builder
WORKDIR /app
COPY go.* ./
RUN go mod download
COPY . .
RUN CGO_ENABLED=0 go build -o /app/server .
FROM gcr.io/distroless/static:nonroot
COPY --from=builder /app/server /server
CMD ["/server"]
Layer Optimization
RUN apt-get update && \
apt-get install -y --no-install-recommends curl && \
rm -rf /var/lib/apt/lists/*
Build Cache: Copy Dependency Files First
COPY package*.json ./
RUN npm ci
COPY . .
Manifests before source keeps install layers cached.
BuildKit Secrets
RUN --mount=type=secret,id=ssh_key,dst=/root/.ssh/id_rsa git clone git@github.com:org/repo.git
ARG leaks via docker history and SLSA provenance --
references/build-secret-leaks.md
Docker Bake (Multi-Platform)
target "app" {
platforms = ["linux/amd64", "linux/arm64"]
}
CI builds go through Bake and netresearch/.github/.github/workflows/build-container-bake.yml@main, one image or several. The reusable adds a GHA cache per target, so the HCL declares none; a scheduled rebuild passes cache: false -- references/bake-ci-cache.md
Security Anti-Patterns
| Anti-pattern | Fix |
|---|---|
FROM image:latest | Pin version: image:1.2.3-alpine |
No USER directive | adduser + USER appuser |
chmod 777 | Use specific permissions: chmod 550 |
privileged: true in compose | Remove or use specific cap_add |
volumes: [/:/host] | Mount only needed paths |
ports: ["0.0.0.0:3000:3000"] | Bind to 127.0.0.1:3000:3000 |
ENV DB_PASSWORD=secret | Use --mount=type=secret or compose secrets |
CI Testing Gotchas
- Bypass entrypoint:
docker run --rm --entrypoint php myimage -v - Mock upstream DNS:
docker run --rm --add-host backend:127.0.0.1 nginx-image nginx -t - Compose validation:
cp .env.example .envbeforedocker compose config - Secret scanning: exclude
.env.example, README, docs - Root-owned artifacts: bind-mount dirs (
EACCES) --references/bind-mount-ownership.md
.dockerignore
Exclude: .git, node_modules/vendor, .env*, *.pem, *.key
Compose Essentials
- startup ordering:
depends_on.condition: service_healthy+healthcheckstart_period. The probe runs with the image's own tools: bare Alpine has busyboxwgetand nocurl(check the image), andlocalhostresolves to::1first -- probe the address the server listens on,127.0.0.1for IPv4 (references/compose-runtime-lifecycle.md);mariadb:11+has nomysqladmin-- usehealthcheck.sh(references/database-container-readiness.md) - swapping a service's image keeps its anonymous volume at a path the new image's
VOLUMEor the compose file declares (redis:8.0→valkey/valkey:9withvolumes: [/data]hands Valkey an RDB it cannot load) -- for disposable data rename the service (and updatedepends_onand clients) or runup -V --no-deps <service>; a bare-Valso renews a database's anonymous volume (references/compose-runtime-lifecycle.md) networks.internal: trueisolates databasesprofiles: [debug]: start only with--profile debug.downand--remove-orphansignore a disabled profile's containers, so a service you stop enabling keeps running --docker compose --profile '*' down, ordocker compose down <service>(references/compose-runtime-lifecycle.md)- logging drivers block by default: a stalled remote endpoint (
awslogs, ...) stalls the app's writes;mode: non-blocking+max-buffer-sizedrops lines instead, protecting a running container only (references/compose-runtime-lifecycle.md) - a socket-reading scheduler (Ofelia) runs the job labels of every stack on the host:
--docker-filter label=com.docker.compose.project=${COMPOSE_PROJECT_NAME}, written in the compose file itself (references/compose-runtime-lifecycle.md) COMPOSE_FILE(shell or.env) loads exactly that list, socompose.override.ymlis silently not merged -- list it in the pin; anddocker compose configprints a literal$as$$, so measure values withprintenvinside a container (references/compose-config-and-env.md)- shared image ref: define ONCE per file as top-level extension field + anchor --
x-app-image: &app-image registry/app:${APP_IMAGE_VERSION:-85}, services useimage: *app-image. The field must sit ABOVEservices:— an alias is only valid after its anchor in document order.:-defaults cover unset AND empty vars (a bare omitted tag silently resolves:latest). Anchors are file-local: every overlay file needs its own. Verify both paths:APP_IMAGE_VERSION= docker compose configand with an override
References
references/bake-ci-cache.md-- the shared bake reusable;-f docker-bake.hclbeside a compose file; GHA cache scope per target; uncached scheduled rebuild that still writes the cache; helper steps in bake-action's directoryreferences/ci-testing.md-- CI testing patterns for Docker images; busyboxshvs bash in-cstrings;timeoutarounddocker compose runleaves the container running when PID 1 ignores the signal; a negative control taken from a mutable base tag expires when upstream ships the fix; a local fallback build that matches CI (git archive <tag> | docker build -)references/dind-testing-patterns.md-- Docker-in-Docker testing patternsreferences/bind-mount-ownership.md-- root-owned bind-mount artifacts; a tmpfs on a parent path hiding a volume below itreferences/gpg-verification.md-- gpgv patterns; stale keybox locksreferences/registry-catalogue-and-pin-rot.md-- catalogue probes; pin rotreferences/build-secret-leaks.md--ARGin provenancereferences/php-fpm-worker-starvation.md-- keepalive pins php-fpm; withfastcgi.loggingon a long PHP error overflowsfastcgi_buffer_size, and on a service with several addressesmax_failsturns those 502s intono live upstreamsfor everyonereferences/engine-and-image-upgrades.md--MinAPIVersioncuts off socket-reading sidecars; probe-container upgrade check; a base image changing itsUSER; PHP 8.5 OPcache built into the core; run the tests of images builtFROMa base before changing what it shipsreferences/pinned-source-fetch.md-- a commit hash fetched from GitHub may come from any fork; fetch the upstream branch and require the pin to be its ancestorreferences/database-container-readiness.md-- seeded DB images logready for connectionstwice; verify the seed, not the log;mariadb:11+drops themysql*binaries; major upgrade of an existing data directory (MARIADB_AUTO_UPGRADE,healthcheck.sh, manualdocker stop -t,stop_grace_period)references/compose-runtime-lifecycle.md-- a disabled profile's container survivesdownandup --remove-orphans; blocking vs non-blocking log delivery and what non-blocking does not protect; an Ofelia on the Docker socket runs other stacks' jobs unless filtered to its own project; an image swap keeps an anonymous volume the new container declares; healthcheck probes inside Alpine imagesreferences/compose-config-and-env.md-- aCOMPOSE_FILEpin disables thecompose.override.ymlmerge;docker compose configre-escapes$as$$, so it is not what the container receivesreferences/image-ca-trust.md-- after a CA compromise: measure the published image'sca-certificatesversion and root subjects;grepfor a CA name in the bundle always returns 0
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/netresearch/docker-development-skill/docker-development">View docker-development on skillZs</a>