HUB
Sign inSign up

nellblaise/edusphere

By nellblaise

•Updated over 1 year ago

Image
0

131

nellblaise/edusphere repository overview

⁠EduSphere - Images Docker Officielles

Docker Pulls Docker Image Size Docker Image Version

⁠🐳 Images Disponibles

EduSphere propose plusieurs images Docker pour différents composants de la plateforme :

ImageDescriptionTailleTags
edusphere/appApplication mobile (Expo/React Native)~200MBlatest, v1.0, dev

⁠🚀 Démarrage Rapide

⁠Application Complète avec Docker Compose
version: '3.8'
services:
  app:
    image: edusphere/app:latest
    ports:
      - "19006:19006"
    environment:
      - EXPO_DEVTOOLS_LISTEN_ADDRESS=0.0.0.0
    volumes:
      - ./app-data:/app/data

  api-backend:
    image: edusphere/api-backend:latest
    ports:
      - "3001:3001"
    environment:
      - NODE_ENV=production
      - SUPABASE_URL=your_supabase_url
      - SUPABASE_SERVICE_KEY=your_service_key
      - GOOGLE_GEMINI_API_KEY=your_gemini_key
      - DIGITALOCEAN_API_TOKEN=your_do_token
    depends_on:
      - redis
    volumes:
      - ./api-logs:/app/logs

  redis:
    image: redis:7-alpine
    ports:
      - "6379:6379"
    volumes:
      - redis-data:/data

  workshop-code:
    image: edusphere/workshop-code:latest
    ports:
      - "8080:8080"
    environment:
      - WORKSHOP_TYPE=code
      - USER_ID=\${USER_ID}
    volumes:
      - user-projects:/workspace
    cap_add:
      - SYS_PTRACE
    security_opt:
      - seccomp:unconfined

volumes:
  redis-data:
  user-projects:
⁠Lancement Simple
# Télécharger et lancer l'application
docker run -d -p 19006:19006 --name edusphere-app edusphere/app:latest

# Lancer l'API backend
docker run -d -p 3001:3001 \
  -e SUPABASE_URL=your_url \
  -e SUPABASE_SERVICE_KEY=your_key \
  --name edusphere-api \
  edusphere/api-backend:latest

# Lancer un atelier de code
docker run -d -p 8080:8080 \
  -v $(pwd)/projects:/workspace \
  --name code-workshop \
  edusphere/workshop-code:latest

⁠⚙️ Configuration

⁠Variables d'Environnement
⁠edusphere/app
VariableDescriptionDéfautRequis
EXPO_DEVTOOLS_LISTEN_ADDRESSAdresse d'écoute ExpolocalhostNon
API_BASE_URLURL de l'API backendhttp://localhost:3001Non
SUPABASE_URLURL Supabase-Oui
SUPABASE_ANON_KEYClé anonyme Supabase-Oui
⁠edusphere/api-backend
VariableDescriptionDéfautRequis
NODE_ENVEnvironnement Node.jsdevelopmentNon
PORTPort d'écoute3001Non
SUPABASE_URLURL Supabase-Oui
SUPABASE_SERVICE_KEYClé service Supabase-Oui
GOOGLE_GEMINI_API_KEYClé API Gemini-Oui
DIGITALOCEAN_API_TOKENToken DigitalOcean-Oui
REDIS_URLURL Redisredis://localhost:6379Non
JWT_SECRETSecret JWT-Oui
⁠edusphere/workshop-*
VariableDescriptionDéfautRequis
WORKSHOP_TYPEType d'ateliercodeNon
USER_IDID utilisateur1000Non
WORKSPACE_PATHChemin workspace/workspaceNon
VNC_PASSWORDMot de passe VNCedusphereNon
⁠Volumes Recommandés
# Données persistantes de l'application
-v ./app-data:/app/data

# Logs de l'API
-v ./api-logs:/app/logs

# Projets utilisateur (ateliers)
-v ./user-projects:/workspace

# Configuration personnalisée
-v ./config:/app/config

⁠🏗️ Architecture des Conteneurs

⁠edusphere/app
  • Base : Node.js 18 Alpine
  • Framework : Expo/React Native
  • Port : 19006 (Metro bundler)
  • Volumes : /app/data (cache et données locales)
⁠edusphere/api-backend
  • Base : Node.js 18 Alpine
  • Framework : Express.js
  • Port : 3001
  • Dépendances : Redis (optionnel), PostgreSQL (externe)
⁠edusphere/workshop-code
  • Base : Ubuntu 22.04
  • Outils : VS Code Server, Node.js, Python, Git
  • Port : 8080 (VS Code Web)
  • Accès : HTTP via navigateur
⁠edusphere/workshop-cyber
  • Base : Kali Linux
  • Outils : Metasploit, Nmap, Wireshark, Burp Suite
  • Port : 6080 (noVNC)
  • Accès : VNC via navigateur

⁠🔧 Exemples d'Utilisation

⁠Développement Local
# Créer un réseau Docker
docker network create edusphere-net

# Lancer Redis
docker run -d --name redis --network edusphere-net redis:7-alpine

# Lancer l'API avec variables d'environnement
docker run -d --name api \
  --network edusphere-net \
  -p 3001:3001 \
  -e SUPABASE_URL=https://your-project.supabase.co \
  -e SUPABASE_SERVICE_KEY=your-service-key \
  -e REDIS_URL=redis://redis:6379 \
  edusphere/api-backend:dev

# Lancer l'application
docker run -d --name app \
  --network edusphere-net \
  -p 19006:19006 \
  -e API_BASE_URL=http://api:3001 \
  edusphere/app:dev
⁠Production avec Docker Swarm
version: '3.8'
services:
  app:
    image: edusphere/app:latest
    deploy:
      replicas: 2
      update_config:
        parallelism: 1
        delay: 10s
      restart_policy:
        condition: on-failure
    ports:
      - "19006:19006"
    networks:
      - edusphere-net

  api:
    image: edusphere/api-backend:latest
    deploy:
      replicas: 3
      resources:
        limits:
          memory: 512M
        reservations:
          memory: 256M
    environment:
      - NODE_ENV=production
    secrets:
      - supabase_key
      - gemini_key
    networks:
      - edusphere-net

networks:
  edusphere-net:
    driver: overlay

secrets:
  supabase_key:
    external: true
  gemini_key:
    external: true
⁠Atelier Collaboratif
# Lancer un atelier de code pour plusieurs utilisateurs
docker run -d \
  --name workshop-user1 \
  -p 8081:8080 \
  -v ./projects/user1:/workspace \
  -e USER_ID=1001 \
  edusphere/workshop-code:latest

docker run -d \
  --name workshop-user2 \
  -p 8082:8080 \
  -v ./projects/user2:/workspace \
  -e USER_ID=1002 \
  edusphere/workshop-code:latest

⁠🔒 Sécurité

⁠Bonnes Pratiques
# Utiliser des utilisateurs non-root
docker run --user 1000:1000 edusphere/app:latest

# Limiter les ressources
docker run --memory=512m --cpus=1.0 edusphere/api-backend:latest

# Utiliser des secrets Docker
echo "your-secret-key" | docker secret create supabase_key -
docker service create --secret supabase_key edusphere/api-backend:latest

# Scanner les vulnérabilités
docker scan edusphere/app:latest
⁠Variables Sensibles

⚠️ Important : Ne jamais exposer les variables sensibles dans les commandes Docker. Utilisez :

  • Fichiers .env
  • Docker secrets
  • Variables d'environnement du système
  • Gestionnaires de secrets (HashiCorp Vault, AWS Secrets Manager)

⁠📊 Monitoring et Logs

⁠Logs
# Voir les logs en temps réel
docker logs -f edusphere-app

# Logs avec timestamps
docker logs -t edusphere-api

# Limiter les logs
docker logs --tail 100 edusphere-api
⁠Monitoring avec Prometheus
version: '3.8'
services:
  app:
    image: edusphere/app:latest
    labels:
      - "prometheus.io/scrape=true"
      - "prometheus.io/port=19006"

  prometheus:
    image: prom/prometheus
    ports:
      - "9090:9090"
    volumes:
      - ./prometheus.yml:/etc/prometheus/prometheus.yml

⁠🚀 Déploiement

⁠Kubernetes
apiVersion: apps/v1
kind: Deployment
metadata:
  name: edusphere-app
spec:
  replicas: 3
  selector:
    matchLabels:
      app: edusphere-app
  template:
    metadata:
      labels:
        app: edusphere-app
    spec:
      containers:
      - name: app
        image: edusphere/app:latest
        ports:
        - containerPort: 19006
        env:
        - name: SUPABASE_URL
          valueFrom:
            secretKeyRef:
              name: edusphere-secrets
              key: supabase-url
---
apiVersion: v1
kind: Service
metadata:
  name: edusphere-app-service
spec:
  selector:
    app: edusphere-app
  ports:
  - port: 80
    targetPort: 19006
  type: LoadBalancer
⁠Docker Compose pour Production
# Télécharger le docker-compose de production
curl -O https://raw.githubusercontent.com/edusphere/docker-configs/main/docker-compose.prod.yml

# Configurer les variables d'environnement
cp .env.example .env
# Éditer .env avec vos valeurs

# Lancer en production
docker-compose -f docker-compose.prod.yml up -d

# Vérifier le statut
docker-compose -f docker-compose.prod.yml ps

⁠🔄 Mise à Jour

# Mettre à jour vers la dernière version
docker pull edusphere/app:latest
docker pull edusphere/api-backend:latest

# Redémarrer avec la nouvelle image
docker-compose down
docker-compose up -d

# Nettoyer les anciennes images
docker image prune -f

⁠🐛 Dépannage

⁠Problèmes Courants

L'application ne démarre pas

# Vérifier les logs
docker logs edusphere-app

# Vérifier les variables d'environnement
docker exec edusphere-app env | grep SUPABASE

Problèmes de réseau

# Vérifier la connectivité
docker exec edusphere-app ping api-backend

# Lister les réseaux
docker network ls

Problèmes de permissions

# Vérifier les permissions des volumes
ls -la ./app-data

# Changer le propriétaire si nécessaire
sudo chown -R 1000:1000 ./app-data

⁠📞 Support

⁠🏷️ Tags et Versions

  • latest : Version stable la plus récente
  • v1.0, v1.1 : Versions spécifiques
  • dev : Version de développement (instable)
  • beta : Version bêta pour tests

⁠📄 Licence

Images Docker sous licence MIT. Voir LICENSE⁠.


EduSphere - Révolutionner l'apprentissage étudiant avec Docker 🐳

Tag summary

Content type

Image

Digest

sha256:1f3e9ae9d…

Size

643.1 MB

Last updated

over 1 year ago

docker pull nellblaise/edusphere