castopod/docs/src/es/getting-started/docker.md

145 lines
4.5 KiB
Markdown
Raw Normal View History

2022-08-22 17:56:51 +02:00
---
title: Imágenes oficiales de Docker
sidebarDepth: 3
---
# Imágenes oficiales de Docker
Castopod lanza 2 imágenes Docker al Docker Hub durante su proceso de
construcción automatizada:
2022-09-06 16:55:46 +02:00
- [**`castopod/app`**](https://hub.docker.com/r/castopod/app): el paquete
completo de Castopod con todas las dependencias.
- [**`castopod/web-server`**](https://hub.docker.com/r/castopod/web-server): una
configuración Nginx para Castopod
2022-08-22 17:56:51 +02:00
2022-09-06 16:55:46 +02:00
Adicionalmente, Castopod requiere una base de datos compatible con MySQL.
También se puede añadir una base de datos Redis como gestor de caché.
2022-08-22 17:56:51 +02:00
## Etiquetas admitidas
2022-09-06 16:55:46 +02:00
- `develop` [unstable], última rama de desarrollo construida
2022-08-22 17:56:51 +02:00
2022-09-06 16:55:46 +02:00
// más etiquetas por venir!
2022-08-22 17:56:51 +02:00
## Ejemplo de uso
1. Instalar [docker](https://docs.docker.com/get-docker/) y
[docker-compose](https://docs.docker.com/compose/install/)
2. Crear un archivo `docker-compose.yml` con lo siguiente:
```yml
2022-09-06 16:55:46 +02:00
version: "3.7"
2022-08-22 17:56:51 +02:00
2022-09-06 16:55:46 +02:00
services:
app:
image: castopod/app:develop
container_name: "castopod-app"
volumes:
2022-08-22 17:56:51 +02:00
- castopod-media:/opt/castopod/public/media
2022-09-06 16:55:46 +02:00
environment:
2022-08-22 17:56:51 +02:00
MYSQL_DATABASE: castopod
MYSQL_USER: castopod
2022-09-06 16:55:46 +02:00
MYSQL_PASSWORD: changeme
2022-08-22 17:56:51 +02:00
CP_BASEURL: "http://castopod.example.com"
2022-09-06 16:55:46 +02:00
CP_ANALYTICS_SALT: changeme
2022-08-22 17:56:51 +02:00
CP_CACHE_HANDLER: redis
CP_REDIS_HOST: redis
2022-09-06 16:55:46 +02:00
networks:
2022-08-22 17:56:51 +02:00
- castopod-app
- castopod-db
2022-09-06 16:55:46 +02:00
restart: unless-stopped
2022-08-22 17:56:51 +02:00
2022-09-06 16:55:46 +02:00
web-server:
image: castopod/web-server:develop
container_name: "castopod-web-server"
volumes:
2022-08-22 17:56:51 +02:00
- castopod-media:/var/www/html/media
2022-09-06 16:55:46 +02:00
networks:
2022-08-22 17:56:51 +02:00
- castopod-app
2022-09-06 16:55:46 +02:00
ports:
2022-08-22 17:56:51 +02:00
- 8080:80
2022-09-06 16:55:46 +02:00
restart: unless-stopped
2022-08-22 17:56:51 +02:00
mariadb:
2022-09-06 16:55:46 +02:00
image: mariadb:10.5
container_name: "castopod-mariadb"
networks:
2022-08-22 17:56:51 +02:00
- castopod-db
2022-09-06 16:55:46 +02:00
volumes:
2022-08-22 17:56:51 +02:00
- castopod-db:/var/lib/mysql
2022-09-06 16:55:46 +02:00
environment:
MYSQL_ROOT_PASSWORD: changeme
2022-08-22 17:56:51 +02:00
MYSQL_DATABASE: castopod
MYSQL_USER: castopod
2022-09-06 16:55:46 +02:00
MYSQL_PASSWORD: changeme
restart: unless-stopped
2022-08-22 17:56:51 +02:00
redis:
2022-09-06 16:55:46 +02:00
image: redis:7.0-alpine
container_name: "castopod-redis"
volumes:
2022-08-22 17:56:51 +02:00
- castopod-cache:/data
2022-09-06 16:55:46 +02:00
networks:
2022-08-22 17:56:51 +02:00
- castopod-app
2022-09-06 16:55:46 +02:00
volumes:
2022-08-22 17:56:51 +02:00
castopod-media:
castopod-db:
castopod-cache:
2022-09-06 16:55:46 +02:00
networks:
2022-08-22 17:56:51 +02:00
castopod-app:
castopod-db:
```
Debes adaptar algunas variables a tus necesidades (ej. `CP_BASEURL`,
2022-09-06 16:55:46 +02:00
`MYSQL_ROOT_PASSWORD`, `MYSQL_PASSWORD` y `CP_ANALYTICS_SALT`).
2022-08-22 17:56:51 +02:00
2022-09-06 16:55:46 +02:00
3. Configura un servidor proxy inverso para TLS (SSL/HTTPS).
2022-08-22 17:56:51 +02:00
2022-09-06 16:55:46 +02:00
TLS es imprescindible para que ActivityPub funcione. Este trabajo puede ser
2022-08-22 17:56:51 +02:00
fácilmente manejado por un proxy inverso, por ejemplo con
[Caddy](https://caddyserver.com/):
```
#castopod
2022-09-06 16:55:46 +02:00
castopod.mi_dominio.com {
2022-08-22 17:56:51 +02:00
reverse_proxy localhost:8080
}
```
4. Ejecuta `docker-compose -d`, espera a que se inicie y ve a
2022-09-06 16:55:46 +02:00
`https://castopod.mi_dominio.com/cp-install` para terminar de configurar
2022-08-22 17:56:51 +02:00
Castopod!
2022-09-06 16:55:46 +02:00
5. Todo listo, empieza a hacer podcasting! 🎙️🚀
2022-08-22 17:56:51 +02:00
2022-09-06 16:55:46 +02:00
## Variables de Entorno
2022-08-22 17:56:51 +02:00
- **castopod/app**
2022-09-06 16:55:46 +02:00
| Nombre de la Variable | Tipo (`predeterminado`) |
| -------------------------- | ---------------------------------- |
| **`CP_URLBASE`** | string (`undefined`) |
| **`CP_MEDIA_URLBASE`** | ?string (`(vacío)`) |
| **`CP_ADMIN_GATEWAY`** | ?string (`"cp-admin"`) |
| **`CP_AUTH_GATEWAY`** | ?string (`"cp-auth"`) |
| **`CP_ANALYTICS_SALT`** | string (`indefinido`) |
| **`CP_DATABASE_HOSTNAME`** | ?string (`"mariadb"`) |
| **`CP_DATABASE_NAME`** | string (`MYSQL_DATABASE`) |
| **`CP_DATABASE_USERNAME`** | string (`MYSQL_USER`) |
| **`CP_DATABASE_PASSWORD`** | string (`MYSQL_PASSWORD`) |
| **`CP_DATABASE_PREFIX`** | ?string (`"cp_"`) |
| **`CP_CACHE_HANDLER`** | ?[`"file"` o `"redis"`] (`"file"`) |
| **`CP_REDIS_HOST`** | ?string (`"localhost"`) |
| **`CP_REDIS_PASSWORD`** | ?string (`null`) |
| **`CP_REDIS_PORT`** | ?number (`6379`) |
| **`CP_REDIS_DATABASE`** | ?number (`0`) |
2022-08-22 17:56:51 +02:00
- **castopod/web-server**
2022-09-06 16:55:46 +02:00
| Nombre de la variable | Tipo (`predeterminado`) |
| --------------------- | ----------------------- |
| **`CP_APP_HOSTNAME`** | ?string (`"app"`) |