Vibe Deployer

Docker Deploy Skill

Complete Docker deployment solution cho bất kỳ project nào. Hỗ trợ tất cả registries, platforms và CI/CD pipelines phổ biến.

Overview

┌──────────────────────────────────────────────────────────────────────────────────┐
│                          DOCKER DEPLOY WORKFLOW                                   │
├──────────────────────────────────────────────────────────────────────────────────┤
│                                                                                   │
│  ┌────────┐   ┌────────────┐   ┌────────┐   ┌────────┐   ┌─────────┐           │
│  │ BUILD  │-->│ LOCAL TEST │-->│  PUSH  │-->│ DEPLOY │-->│ RUNNING │           │
│  │ Image  │   │  & Verify  │   │Registry│   │Platform│   │   App   │           │
│  └────────┘   └────────────┘   └────────┘   └────────┘   └─────────┘           │
│       │             │               │             │                               │
│       v             v               v             v                               │
│  templates/    (local docker)  registries/   platforms/                          │
│                                                                                   │
│  + CI/CD Automation ────────────────────────────────> ci-cd/                    │
│                                                                                   │
└──────────────────────────────────────────────────────────────────────────────────┘

Supported Technologies

Project Types (Dockerfile Templates)

Container Registries

Deployment Platforms

CI/CD Pipelines

Workflow

Step 1: Build Docker Image

Detect project type (auto hoặc specify):

package.json + next.config.*    → Next.js
package.json                    → Node.js
requirements.txt / pyproject.toml → Python
go.mod                          → Go
composer.json                   → PHP
pom.xml / build.gradle          → Java
*.csproj                        → .NET
Cargo.toml                      → Rust
index.html (no backend)         → Static

Generate files:

1. Dockerfile - Multi-stage build, optimized
2. docker-compose.yml - Development config
3. docker-compose.prod.yml - Production config
4. .dockerignore - Exclude unnecessary files

Templates: See templates/ folder

Step 2: Local Build & Test

QUAN TRỌNG: Sau khi tạo xong các file cấu hình Docker, PHẢI build và test trên local để đảm bảo mọi thứ hoạt động trước khi push/deploy.

2.1 - Build Docker Image

# Build image từ Dockerfile vừa tạo
docker build -t {app-name}:local-test .

# Verify image được tạo thành công
docker images {app-name}:local-test

Kiểm tra:

• Build thành công, không có error
• Image size hợp lý (< 500MB cho hầu hết apps)
• Tất cả build stages hoàn tất

Nếu build FAIL: Đọc error log, sửa Dockerfile, build lại cho đến khi thành công.

2.2 - Test Docker Container

# Chạy container từ image vừa build
docker run -d -p {host-port}:{container-port} --name {app-name}-test {app-name}:local-test

# Đợi container khởi động
sleep 5

# Kiểm tra container đang chạy
docker ps --filter "name={app-name}-test"

# Kiểm tra logs - xem có error không
docker logs {app-name}-test

# Test health endpoint (nếu có)
curl -f http://localhost:{host-port}/health || curl -f http://localhost:{host-port}/api/health || curl -f http://localhost:{host-port}/

# Kiểm tra resource usage
docker stats {app-name}-test --no-stream

Kiểm tra:

• Container status = running (không phải exited hay restarting)
• Logs không có error nghiêm trọng
• App response OK khi curl (HTTP 200)
• Resource usage hợp lý (không memory leak)

Nếu container FAIL:

1. Kiểm tra logs: docker logs {app-name}-test
2. Debug bằng interactive shell: docker run -it --entrypoint sh {app-name}:local-test
3. Sửa Dockerfile hoặc code, quay lại bước 2.1

# Cleanup container test
docker stop {app-name}-test && docker rm {app-name}-test

2.3 - Test Docker Compose

# Test docker-compose.yml (development)
docker-compose up -d

# Đợi tất cả services khởi động
sleep 10

# Kiểm tra tất cả services đang chạy
docker-compose ps

# Kiểm tra logs tất cả services
docker-compose logs --tail=50

# Test app endpoint
curl -f http://localhost:{host-port}/health || curl -f http://localhost:{host-port}/

# Kiểm tra network connectivity giữa services
docker-compose exec app sh -c "echo 'Container is accessible'"

Kiểm tra:

• Tất cả services status = Up / running
• Không có service nào bị restart loop
• Database connection thành công (nếu có)
• App có thể communicate với dependent services

# Cleanup docker-compose
docker-compose down -v

2.4 - Test Docker Compose Production (nếu có)

# Test docker-compose.prod.yml
docker-compose -f docker-compose.prod.yml up -d

# Đợi services khởi động
sleep 10

# Kiểm tra services
docker-compose -f docker-compose.prod.yml ps

# Kiểm tra logs
docker-compose -f docker-compose.prod.yml logs --tail=50

# Test app
curl -f http://localhost:{host-port}/

# Cleanup
docker-compose -f docker-compose.prod.yml down -v

2.5 - Báo cáo kết quả

Sau khi test xong, báo cáo cho user:

📋 LOCAL BUILD & TEST REPORT
═══════════════════════════════════════
✅/❌ Docker Build:     [PASS/FAIL] - Image size: XXX MB
✅/❌ Container Run:    [PASS/FAIL] - Status: running/exited
✅/❌ Health Check:     [PASS/FAIL] - HTTP {status_code}
✅/❌ Docker Compose:   [PASS/FAIL] - {N} services running
✅/❌ Compose Prod:     [PASS/FAIL] - {N} services running
═══════════════════════════════════════

Nếu tất cả PASS: Tiếp tục sang Step 3 (Choose Registry). Nếu có FAIL: Sửa lỗi và test lại cho đến khi tất cả PASS. KHÔNG được tiếp tục nếu local test chưa pass.

Step 3: Choose Container Registry

Hỏi user muốn push image lên registry nào:

Guides: See registries/ folder

Step 4: Choose Deployment Platform

Hỏi user muốn deploy lên platform nào:

Guides: See platforms/ folder

Step 5: Setup CI/CD (Optional)

Hỏi user có muốn setup CI/CD không:

Templates: See ci-cd/ folder

Quick Reference

Common Commands

# === BUILD ===
docker build -t myapp:latest .
docker build -t myapp:v1.0.0 --no-cache .

# === TAG ===
docker tag myapp:latest registry/username/myapp:latest

# === PUSH ===
docker push registry/username/myapp:latest

# === RUN LOCAL ===
docker-compose up -d
docker-compose -f docker-compose.prod.yml up -d

# === DEPLOY ===
# (varies by platform - see platform guides)

Environment Variables

# Build-time (in Dockerfile)
ARG NODE_ENV=production

# Runtime (in docker-compose or platform)
environment:
  - DATABASE_URL=${DATABASE_URL}
  - API_KEY=${API_KEY}

Important Rules

MUST DO:

• Multi-stage build để giảm image size
• Non-root user trong container
• .dockerignore để exclude files
• HEALTHCHECK cho monitoring
• Pin version base images
• Secrets qua environment variables, KHÔNG hardcode

MUST NOT:

• KHÔNG copy .env files vào image
• KHÔNG dùng latest tag cho production
• KHÔNG chạy container với root user
• KHÔNG expose database ports publicly
• KHÔNG commit secrets vào git

Recommended Combinations

For Students/Learning

Build → GitHub GHCR → Railway/Render → GitHub Actions
(Free, easy to setup, good documentation)

For Startups

Build → AWS ECR → AWS ECS/Fargate → GitHub Actions
(Scalable, professional, pay-as-you-go)

For Self-hosters

Build → Docker Hub → VPS + Coolify → GitLab CI
(Full control, one-time cost VPS)

For Enterprise

Build → Private Registry → Kubernetes → Jenkins/ArgoCD
(Maximum control and scale)

File Structure

.claude/skills/docker-deploy/
├── SKILL.md                    # This file
├── README.md                   # User guide
├── checklist.md                # Security checklist
│
├── templates/                  # Dockerfile templates
│   ├── nextjs.Dockerfile
│   ├── node.Dockerfile
│   ├── python.Dockerfile
│   ├── go.Dockerfile
│   ├── php.Dockerfile
│   ├── java.Dockerfile
│   ├── dotnet.Dockerfile
│   ├── rust.Dockerfile
│   ├── static.Dockerfile
│   ├── docker-compose.yml
│   ├── docker-compose.prod.yml
│   ├── dockerignore.txt
│   └── entrypoint.sh
│
├── registries/                 # Container registry guides
│   ├── docker-hub.md
│   ├── github-ghcr.md
│   ├── gitlab-registry.md
│   ├── aws-ecr.md
│   ├── google-gar.md
│   └── azure-acr.md
│
├── platforms/                  # Deployment platform guides
│   ├── vps-manual.md
│   ├── vps-docker-compose.md
│   ├── railway.md
│   ├── render.md
│   ├── fly-io.md
│   ├── digitalocean-app.md
│   ├── aws-ecs.md
│   ├── aws-lightsail.md
│   ├── google-cloud-run.md
│   ├── azure-container-apps.md
│   └── coolify.md
│
└── ci-cd/                      # CI/CD pipeline templates
    ├── github-actions.md
    ├── gitlab-ci.md
    ├── bitbucket-pipelines.md
    └── jenkins.md

Troubleshooting

See checklist.md for common issues and solutions.

Version History

• v2.1.0 - Added Step 2: Local Build & Test - build và verify Docker image/container/compose trên local trước khi push/deploy
• v2.0.0 - Added registries, platforms, CI/CD guides
• v1.0.0 - Initial release with Dockerfile templates

Converted and distributed by TomeVault — claim your Tome and manage your conversions.