API con Docker

Esta pagina cubre solo el funcionamiento Docker de la API.

Principio

Para una API separada y limpia:

• un contenedor militant-api
• la misma red Docker que militant-web
• la misma base SQL que la aplicacion principal
• un uploads compartido

Metodo recomendado

Usa el instalador dedicado:

mkdir -p militant-api-install
cd militant-api-install
curl -fsSLO https://gitlab.com/militant1/api-installer/-/raw/main/militant-api
chmod +x militant-api
./militant-api

Metodo manual

Tambien puedes partir de docker-compose.casaos.yml:

cp docker-compose.casaos.yml docker-compose.api.yml
docker compose -f docker-compose.api.yml up -d

Configuracion importante

Red

La API debe unirse a una red externa existente, por ejemplo:

networks:
  militant_external:
    external: true
    name: militant_militant_network

Base SQL

La imagen acepta hoy tanto variables DB_ como API_DB_. Si escribes el Compose a mano, lo mas seguro es proporcionar ambas.

environment:
  API_DB_HOST: militant-db
  API_DB_NAME: militant
  API_DB_USER: militant
  API_DB_PASS: tu_password
  DB_HOST: militant-db
  DB_NAME: militant
  DB_USER: militant
  DB_PASSWORD: tu_password

Uploads

Dos estrategias validas:

1. volumen Docker externo compartido 2. bind mount al directorio real de uploads

Ejemplo con volumen:

volumes:
  - militant_militant_uploads:/var/www/uploads

Ejemplo con bind mount:

volumes:
  - /srv/militant/uploads:/var/www/uploads

Comandos utiles

docker compose -f docker-compose.api.yml pull
docker compose -f docker-compose.api.yml up -d
docker compose -f docker-compose.api.yml logs -f api
docker compose -f docker-compose.api.yml ps
docker compose -f docker-compose.api.yml down

Reverse proxy

Expone idealmente la API detras de HTTPS, por ejemplo en api.example.org, y activa:

• API_REQUIRE_HTTPS=true
• API_CORS_ORIGINS=https://tu-cliente.example.org

Para lo demas, ver README.md.

---