WindsurfDockerArchitecture

Docker Windsurf Rules

Windsurf rules for Docker and container architecture: compose patterns, registries, and microservice conventions.

.windsurfrules

- Use docker compose for local development with named volumes for data persistence
- Use profiles in docker-compose.yml to separate dev, test, and optional services
- Build images with GitHub Actions or GitLab CI; push to GHCR or ECR
- Use BuildKit with --cache-from to speed up CI image builds
- Apply distroless images for production services where possible
- Tag images with git commit SHA for precise deployment tracking
- Use Watchtower or CI-driven rolling updates; never manual docker pull on prod
- Document required environment variables in a compose.env.example file

How to use with Windsurf

Create a `.windsurfrules` file in your project root. Windsurf's Cascade AI applies these rules automatically.

← All Windsurf rules All Docker rules →

#docker#windsurf#compose#devops#coding-rules

Related Rules

TypeScript Windsurf Rules

WindsurfTypeScript

Windsurf rules for TypeScript: strict type safety, functional patterns, and modern TypeScript conventions.

Code Style

typescript · windsurfCopy Ready

React Windsurf Rules

WindsurfReact

Windsurf rules for React: modern patterns, performance, and scalable React architecture.

Architecture

react · windsurfCopy Ready

Go Windsurf Rules

WindsurfGo

Windsurf rules for Go: hexagonal architecture, clean code, observability, and production Go patterns.

Architecture

go · windsurfCopy Ready

Rust Windsurf Rules

WindsurfRust

Windsurf rules for Rust: async Rust, WASM, systems programming, and production Rust patterns.

Architecture

rust · windsurfCopy Ready