Deploiement avec Docker Compose

Cette methode deploie l'ensemble des services HCW@Home dans des conteneurs Docker. C'est l'approche recommandee pour le developpement, les tests et les environnements cloud.

Prerequis

• Docker Engine 20+ et Docker Compose v2
• 2 Go de RAM minimum
• Un nom de domaine (production) ou localhost (developpement)

Architecture des services

graph TD
    subgraph Services externes
        LK[LiveKit - WebRTC SFU]
        SMTP[Serveur SMTP]
        SMS[Passerelle SMS - optionnel]
    end

    subgraph Reverse Proxy
        NGINX[Nginx / Traefik / Caddy]
    end

    subgraph Frontends
        PRACT[Practitioner :8080]
        PAT[Patient :8081]
        ADM[Admin :8082]
    end

    subgraph Backend
        API[API :8000 - Django]
        CEL[Celery Worker]
        SCHED[Celery Beat]
        MIG[Migrate]
    end

    subgraph Donnees
        PG[(PostgreSQL :5432)]
        RD[(Redis :6379)]
    end

    NGINX --> PRACT
    NGINX --> PAT
    NGINX --> ADM
    PRACT --> API
    PAT --> API
    ADM --> API
    API --> PG
    API --> RD
    API --> LK
    CEL --> PG
    CEL --> RD
    CEL --> SMTP
    CEL --> SMS
    SCHED --> RD
    MIG --> PG

Mise en place rapide

1. Recuperer le fichier docker-compose

wget https://raw.githubusercontent.com/HCW-home/hcw/refs/heads/master/docker-compose.yml

2. Configurer l'environnement

Recuperer les images :

TAG=0.10.0 docker compose pull

Adaptez ensuite les blocs environment: de docker-compose.yml a votre installation. Les services api, celery, scheduler et migrate doivent tous partager les memes reglages de base de donnees, de Redis et de cle secrete. Voir Variables d'environnement pour la reference complete.

3. Lancer les services

docker compose up -d

Au premier lancement, le service migrate applique automatiquement les migrations de base de donnees.

4. Creer un tenant

HCW@Home utilise le multi-tenancy avec isolation par schema PostgreSQL. Chaque tenant possede ses propres donnees, utilisateurs et configuration. Les tenants sont crees via le shell Django.

docker compose exec api python3 manage.py create_tenant

• schema name : localhost
• name : localhost
• domain : 127.0.0.1

docker compose exec api python3 manage.py tenant_command createsuperuser -s localhost

5. Charger les donnees de test (optionnel)

docker compose exec api python manage.py loaddata initial/TestData.json

Cela cree des utilisateurs de test (mot de passe : Test1234). Voir le README pour la liste complete.

Services et ports

Volumes persistants

Les donnees sont stockees dans le dossier ./data/ :