docs: refresh service inventory and Compose usage
This commit is contained in:
@@ -12,6 +12,8 @@ Portainer ya no es el gestor de despliegue de este repo. Los despliegues se hace
|
||||
- [Servicios](#servicios)
|
||||
- [Configuracion](#configuracion)
|
||||
- [Uso](#uso)
|
||||
- [Troubleshooting](#troubleshooting)
|
||||
- [Retirar un stack](#retirar-un-stack)
|
||||
- [Anadir una nueva app](NUEVA-APP.md)
|
||||
|
||||
## Arquitectura
|
||||
@@ -23,6 +25,10 @@ La infraestructura base se levanta en este orden:
|
||||
3. `crowdsec/`: proteccion colaborativa y bouncer para Traefik.
|
||||
4. Resto de servicios: cada uno desde su propia carpeta.
|
||||
|
||||
Sablier permite arrancar y detener bajo demanda los servicios que tengan su
|
||||
middleware configurado. Un contenedor detenido no implica por sí solo una avería;
|
||||
consulta su configuración y sus logs antes de intervenir.
|
||||
|
||||
Los servicios publicados comparten la red Docker externa `proxy`, que Traefik usa para alcanzarlos.
|
||||
|
||||
Configura DNS antes de desplegar servicios expuestos. Los certificados de Let's Encrypt dependen de que los dominios resuelvan correctamente.
|
||||
@@ -30,7 +36,7 @@ Configura DNS antes de desplegar servicios expuestos. Los certificados de Let's
|
||||
## Prerequisitos
|
||||
|
||||
- Docker Engine
|
||||
- Docker Compose v2
|
||||
- Docker Compose con el comando `docker compose`
|
||||
- Red Docker externa `proxy`
|
||||
- Dominios apuntando al servidor o al Cloudflare Tunnel correspondiente
|
||||
- Puertos 80/443 disponibles para Traefik si aplica
|
||||
@@ -49,6 +55,7 @@ Cada servicio se despliega desde su carpeta con su `.env` local:
|
||||
|
||||
```bash
|
||||
cd Traefik
|
||||
docker compose --env-file .env config --quiet
|
||||
docker compose --env-file .env up -d
|
||||
```
|
||||
|
||||
@@ -74,10 +81,17 @@ cd <servicio>
|
||||
docker compose --env-file .env down
|
||||
```
|
||||
|
||||
Usa `docker compose --env-file .env -f <ruta>/docker-compose.yml up -d` si prefieres ejecutar desde la raiz del repo.
|
||||
Desde la raiz del repo, indica tanto el Compose como el `.env` del servicio:
|
||||
|
||||
```bash
|
||||
docker compose --env-file <servicio>/.env -f <servicio>/docker-compose.yml up -d
|
||||
```
|
||||
|
||||
## Servicios
|
||||
|
||||
El inventario recoge las definiciones disponibles en el repositorio; no implica
|
||||
que todos los servicios estén desplegados o activos en el host.
|
||||
|
||||
| Servicio | Descripcion | Carpeta | Documentacion |
|
||||
|---|---|---|---|
|
||||
| Traefik | Reverse proxy con TLS automatico | `Traefik/` | [README](Traefik/README.md) |
|
||||
@@ -92,7 +106,22 @@ Usa `docker compose --env-file .env -f <ruta>/docker-compose.yml up -d` si prefi
|
||||
| Wireguard | VPN | `wireguard/` | [README](wireguard/README.md) |
|
||||
| Open WebUI | UI para modelos locales/remotos | `openwebui/` | [README](openwebui/README.md) |
|
||||
| OpenCode | Entorno OpenCode servido por Traefik | `opencode/` | [README](opencode/README.md) |
|
||||
| Cloudflare | Gestion DNS y definicion opcional de Cloudflare Tunnel | `cloudflared/` | [README](cloudflared/README.md) |
|
||||
| FreshRSS | Lector y agregador de feeds RSS | `freshrss/` | [README](freshrss/README.md) |
|
||||
| Guacamole | Escritorio remoto desde el navegador | `guacamole/` | [README](guacamole/README.md) |
|
||||
| Karakeep | Archivo y busqueda de enlaces | `karakeep/` | [README](karakeep/README.md) |
|
||||
| LiteLLM | Pasarela central de APIs de modelos | `litellm/` | [README](litellm/README.md) |
|
||||
| Media Server | Streaming y gestion de contenido multimedia | `media-server/` | [README](media-server/README.md) |
|
||||
| Nextcloud | Archivos y colaboracion con OnlyOffice | `nextcloud/` | [README](nextcloud/README.md) |
|
||||
| OpenGist | Fragmentos de codigo versionados con OIDC | `opengist/` | [README](opengist/README.md) |
|
||||
| Paperless-ngx | Archivo documental con OCR y clasificacion IA | `paperless/` | [README](paperless/README.md) |
|
||||
| PrivateBin | Pastebin con cifrado en el navegador | `privatebin/` | [README](privatebin/README.md) |
|
||||
| Sablier | Arranque y parada de servicios bajo demanda | `sablier/` | [README](sablier/README.md) |
|
||||
| Kopia | Backups | `backups/kopia/` | [README](backups/kopia/README.md) |
|
||||
| n8n Observability | Scripts de monitorizacion del host invocados desde n8n | `n8n-observability/` | [README](n8n-observability/README.md) |
|
||||
|
||||
Kopia y n8n Observability tienen sus propios procedimientos documentados; no
|
||||
se despliegan siguiendo el flujo Compose de las carpetas de servicio.
|
||||
|
||||
## Configuracion
|
||||
|
||||
@@ -120,9 +149,10 @@ Para crear una app nueva, sigue [NUEVA-APP.md](NUEVA-APP.md).
|
||||
|
||||
## Uso
|
||||
|
||||
Ver contenedores:
|
||||
Ver proyectos Compose activos y todos los contenedores del host:
|
||||
|
||||
```bash
|
||||
docker compose ls
|
||||
docker ps -a
|
||||
```
|
||||
|
||||
@@ -140,6 +170,9 @@ cd <servicio>
|
||||
docker compose --env-file .env config
|
||||
```
|
||||
|
||||
Para validar sin imprimir la configuración expandida y sus posibles secretos,
|
||||
usa `docker compose --env-file .env config --quiet`.
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
Si Traefik no enruta:
|
||||
|
||||
Reference in New Issue
Block a user