vibe-deployer

name	vibe-deployer
description	DevOps agent with complete Docker deployment skill - Build, Push, Deploy to any platform. Supports all major registries, cloud platforms, and CI/CD pipelines.
disable-model-invocation	true
argument-hint	[action] - Options: build, push, deploy, ci-cd, full
allowed-tools	Read, Write, Edit, Glob, Grep, Bash(docker:*), Bash(docker-compose:*), Bash(curl:*), Bash(sleep:*)

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)

Category	Technologies
JavaScript/TypeScript	Next.js, Node.js, Express, NestJS, Fastify
Python	FastAPI, Flask, Django, Streamlit
Go	Gin, Echo, Fiber, Chi, standard library
PHP	Laravel, Symfony, WordPress
Java	Spring Boot, Quarkus, Micronaut
.NET	ASP.NET Core, Blazor
Rust	Actix-web, Axum, Rocket
Static	HTML/CSS/JS, React, Vue, Angular

Container Registries

Registry	Guide
Docker Hub	registries/docker-hub.md
GitHub Container Registry	registries/github-ghcr.md
GitLab Container Registry	registries/gitlab-registry.md
AWS ECR	registries/aws-ecr.md
Google Artifact Registry	registries/google-gar.md
Azure Container Registry	registries/azure-acr.md

Deployment Platforms

Platform	Type	Guide
VPS (Manual)	Self-managed	platforms/vps-manual.md
VPS (Docker Compose)	Self-managed	platforms/vps-docker-compose.md
Railway	PaaS	platforms/railway.md
Render	PaaS	platforms/render.md
Fly.io	PaaS	platforms/fly-io.md
DigitalOcean App Platform	PaaS	platforms/digitalocean-app.md
AWS ECS	Cloud	platforms/aws-ecs.md
AWS Lightsail	Cloud	platforms/aws-lightsail.md
Google Cloud Run	Cloud	platforms/google-cloud-run.md
Azure Container Apps	Cloud	platforms/azure-container-apps.md
Coolify	Self-hosted PaaS	platforms/coolify.md

CI/CD Pipelines

Provider	Guide
GitHub Actions	ci-cd/github-actions.md
GitLab CI	ci-cd/gitlab-ci.md
Bitbucket Pipelines	ci-cd/bitbucket-pipelines.md
Jenkins	ci-cd/jenkins.md

---

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:

Registry	Best For	Cost
Docker Hub	Public images, beginners	1 free private repo
GitHub GHCR	GitHub projects	Free unlimited private
GitLab Registry	GitLab projects	Free unlimited
AWS ECR	AWS deployments	500MB free tier
Google GAR	GCP deployments	Free tier available
Azure ACR	Azure deployments	Paid

Guides: See registries/ folder

---

Step 4: Choose Deployment Platform

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

If user wants...	Recommend
Free, easy, learning	Railway, Render
Full control, cheap	VPS + Docker Compose
Self-hosted PaaS	Coolify
Enterprise/Scale	AWS ECS, Google Cloud Run
Edge deployment	Fly.io

Guides: See platforms/ folder

---

Step 5: Setup CI/CD (Optional)

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

If using...	Recommend
GitHub	GitHub Actions
GitLab	GitLab CI
Bitbucket	Bitbucket Pipelines
Self-hosted	Jenkins

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