#Mode multi-environnement

#Introduction

Le mode multi-application en mémoire partagée présente des avantages de déploiement et d'exploitation. Cependant, avec l'augmentation du nombre d'applications et de la complexité métier, une instance unique peut être confrontée à des problèmes de concurrence de ressources et de baisse de stabilité. Pour ces scénarios, les utilisateurs peuvent adopter une solution de déploiement hybride multi-environnement afin de répondre à des besoins métier plus complexes.

Le système déploie une application d'entrée comme centre de gestion/ordonnancement, et plusieurs instances NocoBase comme environnements d'exécution indépendants. Les environnements sont isolés les uns des autres tout en collaborant, ce qui permet de disperser efficacement la pression sur une instance unique et d'améliorer considérablement la stabilité, l'extensibilité et la capacité d'isolation des pannes du système.

Au niveau du déploiement, les différents environnements peuvent s'exécuter dans des processus indépendants, être déployés en tant que conteneurs Docker distincts ou sous forme de plusieurs Deployments Kubernetes, s'adaptant ainsi de manière flexible à des infrastructures de différentes tailles et architectures.

#Déploiement

Dans ce mode :

• L'application d'entrée (Supervisor) gère centralement applications et environnements
• Les applications Worker exécutent réellement les charges métier
• Les configurations applications/environnements sont mises en cache via Redis
• Les commandes et synchronisations d'état entre Supervisor et Workers passent par Redis

La création d'environnements n'est pas encore fournie. chaque application Worker doit être déployée manuellement et configurée avec les informations d'environnement correspondantes avant de pouvoir être reconnue par l'application d'entrée.

#Dépendances d'architecture

Avant déploiement :

• Redis

  • Cache des configurations applications/environnements
  • Canal de communication de commandes entre Supervisor et Workers

• Base de données

  • Services de base utilisés par Supervisor et Workers

#Application d'entrée (Supervisor)

Le Supervisor gère la création d'applications, démarrage/arrêt, planification des environnements et proxy d'accès.

Variables d'environnement Supervisor :

# Application mode
APP_MODE=supervisor
# Application discovery adapter
APP_DISCOVERY_ADAPTER=remote
# Application process adapter
APP_PROCESS_ADAPTER=remote
# Redis for application and environment configuration cache
APP_SUPERVISOR_REDIS_URL=
# Command communication adapter
APP_COMMAND_ADPATER=redis
# Redis for command communication
APP_COMMAND_REDIS_URL=

#Application Worker

Le Worker héberge et exécute les instances NocoBase.

Variables d'environnement Worker :

# Application mode
APP_MODE=worker
# Application discovery adapter
APP_DISCOVERY_ADAPTER=remote
# Application process adapter
APP_PROCESS_ADAPTER=local
# Redis for application and environment configuration cache
APP_SUPERVISOR_REDIS_URL=
# Command communication adapter
APP_COMMAND_ADPATER=redis
# Redis for command communication
APP_COMMAND_REDIS_URL=
# Environment identifier
ENVIRONMENT_NAME=
# Environment access URL
ENVIRONMENT_URL=
# Environment proxy access URL
ENVIRONMENT_PROXY_URL=

#Exemple Docker Compose

L'exemple suivant présente une solution de déploiement hybride multi-environnement utilisant des conteneurs Docker comme unités d'exécution, déployant simultanément une application d'entrée et deux applications Worker via Docker Compose.

networks:
  nocobase:
    driver: bridge

services:
  redis:
    networks:
      - nocobase
    image: redis/redis-stack-server:latest
  supervisor:
    container_name: nocobase-supervisor
    image: nocobase/nocobase:alpha
    restart: always
    platform: linux/amd64
    networks:
      - nocobase
    depends_on:
      - redis
    environment:
      - DB_DIALECT=postgres
      - DB_HOST=postgres
      - DB_PORT=5432
      - DB_DATABASE=nocobase_supervisor
      - DB_USER=postgres
      - DB_PASSWORD=postgres
      - TZ=Asia/Shanghai
      - APP_MODE=supervisor
      - APP_DISCOVERY_ADAPTER=remote
      - APP_PROCESS_ADAPTER=remote
      - APP_SUPERVISOR_REDIS_URL=redis://redis:6379/0
      - APP_COMMAND_ADAPTER=redis
      - APP_COMMAND_REDIS_URL=redis://redis:6379/0
      - APPEND_PRESET_BUILT_IN_PLUGINS=@nocobase/plugin-app-supervisor
    volumes:
      - ./storage-supervisor:/app/nocobase/storage
    ports:
      - '14000:80'
  worker_a:
    container_name: nocobase-worker-a
    image: nocobase/nocobase:alpha
    restart: always
    platform: linux/amd64
    networks:
      - nocobase
    depends_on:
      - redis
    environment:
      - DB_DIALECT=postgres
      - DB_HOST=postgres
      - DB_PORT=5432
      - DB_DATABASE=nocobase_worker_a
      - DB_USER=postgres
      - DB_PASSWORD=postgres
      - TZ=Asia/Shanghai
      - APP_MODE=worker
      - APP_DISCOVERY_ADAPTER=remote
      - APP_PROCESS_ADAPTER=local
      - APP_SUPERVISOR_REDIS_URL=redis://redis:6379/0
      - APP_COMMAND_ADAPTER=redis
      - APP_COMMAND_REDIS_URL=redis://redis:6379/0
      - ENVIRONMENT_NAME=env_a
      - ENVIRONMENT_URL=http://localhost:15000
      - ENVIRONMENT_PROXY_URL=http://worker_a
      - APPEND_PRESET_BUILT_IN_PLUGINS=@nocobase/plugin-app-supervisor
    volumes:
      - ./storage-worker-a:/app/nocobase/storage
    ports:
      - '15000:80'
  worker_b:
    container_name: nocobase-worker-b
    image: nocobase/nocobase:alpha
    restart: always
    platform: linux/amd64
    networks:
      - nocobase
    depends_on:
      - redis
    environment:
      - DB_DIALECT=postgres
      - DB_HOST=postgres
      - DB_PORT=5432
      - DB_DATABASE=nocobase_worker_b
      - DB_USER=postgres
      - DB_PASSWORD=postgres
      - TZ=Asia/Shanghai
      - APP_MODE=worker
      - APP_DISCOVERY_ADAPTER=remote
      - APP_PROCESS_ADAPTER=local
      - APP_SUPERVISOR_REDIS_URL=redis://redis:6379/0
      - APP_COMMAND_ADAPTER=redis
      - APP_COMMAND_REDIS_URL=redis://redis:6379/0
      - ENVIRONMENT_NAME=env_b
      - ENVIRONMENT_URL=http://localhost:16000
      - ENVIRONMENT_PROXY_URL=http://worker_b
      - APPEND_PRESET_BUILT_IN_PLUGINS=@nocobase/plugin-app-supervisor
    volumes:
      - ./storage-worker-b:/app/nocobase/storage
    ports:
      - '16000:80'

#Guide d'utilisation

Les opérations de base sont identiques au mode mémoire partagée, voir mode mémoire partagée. Ici, focus sur la configuration multi-environnement.

#Liste des environnements

Après déploiement, accédez à la page Gestionnaire d'applications (App Supervisor) de l'application d'entrée, vous pouvez consulter la liste des environnements de travail enregistrés dans l'onglet Environnements, vous voyez les environnements Worker enregistrés (identifiant, version, URL, statut). Les Workers envoient un heartbeat toutes les 2 minutes.

#Création d'application

À la création, vous pouvez sélectionner un ou plusieurs environnements. Un seul suffit généralement. Choisissez plusieurs environnements uniquement si une division des services a été effectuée sur les applications Worker, nécessitant le déploiement de la même application sur plusieurs environnements d'exécution pour réaliser la répartition de charge ou l'isolation des capacités.

#Liste des applications

La liste affiche l'environnement d'exécution et l'état de chaque application. Si une application est déployée dans plusieurs environnements, plusieurs états d'exécution seront affichés. Dans des conditions normales, la même application dans plusieurs environnements maintiendra un état unifié et devra être démarrée ou arrêtée de manière centralisée.

#Démarrage d'application

Étant donné que le démarrage d'une application peut entraîner l'écriture de données d'initialisation dans la base de données, afin d'éviter les conditions de concurrence dans un contexte multi-environnement, le démarrage des applications déployées dans plusieurs environnements s'effectue en file d'attente. Pour éviter les conditions de course, les démarrages multi-environnements sont mis en file d'attente.

#Proxy d'accès

Les applications Worker peuvent être accédées via le sous-chemin /apps/:appName/admin de l'application d'entrée.

Si une application est déployée sur plusieurs environnements, il faut choisir l'environnement cible du proxy.

Par défaut, l'adresse d'accès du proxy utilise l'adresse d'accès de l'application Worker, correspondant à la variable d'environnement ENVIRONMENT_URL. Assurez-vous que cette adresse est accessible dans l'environnement réseau où se trouve l'application d'entrée. Si vous devez utiliser une adresse d'accès proxy différente, vous pouvez la surcharger via la variable d'environnement ENVIRONMENT_PROXY_URL.