API kun Docker

Tiu paĝo kovras nur la Docker-flankon de la API.

Principo

Por pura aparta API-deplojo:

• unu militant-api ujo
• la sama Docker-reto kiel militant-web
• la sama SQL-datumbazo kiel la ĉefa aplikaĵo
• kundividitaj uploads

Rekomendita metodo

Uzu la dediĉitan instalilon:

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

Mana metodo

Vi ankaŭ povas komenci de docker-compose.casaos.yml:

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

Grava agordo

Reto

La API devas aliĝi al ekzistanta ekstera reto, ekzemple:

networks:
  militant_external:
    external: true
    name: militant_militant_network

SQL-datumbazo

La bildo nun akceptas kaj DB_ kaj API_DB_ variablojn. Se vi skribas Compose permane, la plej sekura maniero estas doni ambaŭ.

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

Uploads

Du validaj strategioj:

1. kundividita ekstera Docker-volumo 2. bind mount al la gastiga uploads-dosierujo

Ekzemplo kun volumo:

volumes:
  - militant_militant_uploads:/var/www/uploads

Ekzemplo kun bind mount:

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

Utilaj komandoj

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

Inversa prokurilo

Elmontru la API malantaŭ HTTPS, ekzemple ĉe api.example.org, kaj aktivigu:

• API_REQUIRE_HTTPS=true
• API_CORS_ORIGINS=https://via-kliento.example.org

Por la resto, vidu README.md.

---