# Docker — Multi-Stack Deploy

> Extraído de `xcloud-docker-deploy` v1.2.1 + habilidades de openclaw-power-ops

## 🗺️ Stack Detection Router

| Arquivo encontrado | Stack | Ação |
|-------------------|-------|------|
| `wp-config.php` ou `wp-content/` | WordPress | Ver ref `xcloud-native-wordpress.md` |
| `composer.json` + `artisan` | Laravel | Ver ref `xcloud-native-laravel.md` |
| `package.json` + `next.config.*` | Next.js | Usar `dockerfiles/nextjs.Dockerfile` |
| `package.json` | Node.js | Ver ref `xcloud-native-nodejs.md` |
| `composer.json` (sem artisan) | PHP | Ver ref `xcloud-native-php.md` |
| `requirements.txt` ou `pyproject.toml` | Python | Usar `dockerfiles/python-fastapi.Dockerfile` |
| `go.mod` | Go | Gerar Dockerfile manualmente |
| `docker-compose.yml` existe | Docker existente | Prosseguir Step 1 |

## Step 1 — Cenário Detection
| Sinal | Cenário |
|-------|---------|
| `build:` ou `context: .` | **A** — Build-from-source |
| Caddy/Traefik/nginx-proxy | **B** — Proxy conflict |
| Múltiplos `ports:` por service | **B** — Multi-port |
| `./nginx.conf` volume mount | **B** — External config |
| Múltiplos services com `build:` | **C** — Multi-service build |
| `image: public-image`, 1 porta | ✅ Já compatível |

## Cenário A — Build-from-Source
1. Remover `build:` do compose
2. Trocar `image:` por `ghcr.io/OWNER/REPO:latest`
3. Gerar `.github/workflows/docker-build.yml`
4. Gerar `.env.example`

## Cenário B — Proxy Conflict
1. Remover Caddy/Traefik/nginx-proxy service
2. Remover SSL labels e multi-port — usar `expose:` (interno)
3. Adicionar `nginx-router` service com `configs:` inline
4. Expor uma porta (default: 3080)

## Cenário C — Multi-Service Build
- Matrix GitHub Actions — cada service com `build:` vira um GHCR image
- Compose atualizado com todas as imagens GHCR

## 🚨 Regras de Ouro (xCloud)
- ❌ Nunca incluir `build:` no compose final — xCloud ignora silenciosamente
- ❌ Nunca expor portas de DB diretas (`5432:5432`) — usar `expose:`
- ❌ Nunca incluir Caddy, Traefik, nginx-proxy, Let's Encrypt
- ✅ Preservar `environment:`, `volumes:`, `healthcheck:`
- ✅ Sempre usar `expose:` (interno), não `ports:` (para serviços internos)

## Dockerfiles Disponíveis
| Stack | Dockerfile |
|-------|------------|
| PHP genérico | `dockerfiles/php-generic.Dockerfile` |
| Laravel | `dockerfiles/laravel.Dockerfile` |
| Node.js | `dockerfiles/node-app.Dockerfile` |
| Next.js | `dockerfiles/nextjs.Dockerfile` |
| Python FastAPI | `dockerfiles/python-fastapi.Dockerfile` |

## Compose Templates
- `compose-templates/laravel-mysql.yml`
- `compose-templates/nextjs-postgres.yml`
- `compose-templates/nodejs-api-postgres.yml`
- `compose-templates/python-fastapi-postgres.yml`