Aller au contenu

Installer le Backend

Cette procédure installe le Backend en quatre étapes.

  1. Package et YAMLDépôt et configuration
  2. KEKClé de chiffrement de clés
  3. InitialisationSchéma et compte admin
  4. ServicesPlatform, workers et AI Gateway

Prérequis

  • Système conforme aux prérequis, sur chaque nœud.
  • Bases créées, PostgreSQL joignable par son adresse virtuelle : Préparer les bases.
  • Stockage S3 prêt : Configurer S3.
  • Load balancer TCP (L4) du lien interne 8010 devant les nœuds Platform, par exemple api-internal.example.test.
  • Package Backend copié sur chaque nœud.

Procédure

1. Déposer le package et créer la configuration

sudo mkdir -p /app/config/backend
sudo tar -xzf <package Backend> -C /app
sudoedit /app/config/backend/smartagt-backend-core.yaml
New-Item -ItemType Directory -Force C:\app\config\backend | Out-Null
Expand-Archive <package Backend> C:\app\smartagt-backend-core
notepad C:\app\config\backend\smartagt-backend-core.yaml

Donnez au fichier smartagt-backend-core.yaml le contenu de votre scénario :

smartagt:
  core:
    data_dir: /var/lib/smartagt/backend
    log_dir: /var/log/smartagt/backend
    database:
      host: localhost
      port: 5432
      name: smartagt
      user: smartagt
smartagt:
  core:
    data_dir: C:/app/data/backend
    log_dir: C:/app/logs/backend
    database:
      host: localhost
      port: 5432
      name: smartagt
      user: smartagt

Dans cette configuration de base, SmartAGT s'exécute avec :

  • PostgreSQL sur le même serveur, joint par localhost, chiffré si le serveur le propose, sans vérification du certificat ;
  • l'API Publique en boucle locale (127.0.0.1:8000), suffisante pour le Frontend installé sur ce serveur ;
  • la Gateway, si vous la démarrez, sur le port 8001 de toutes les interfaces ;
  • des certificats autosignés, générés par SmartAGT, pour l'API Publique et la Gateway.
smartagt:
  core:
    data_dir: /var/lib/smartagt/backend
    log_dir: /var/log/smartagt/backend
    database:
      host: postgres.example.test                               # nom porté par le certificat du serveur
      port: 5432
      name: smartagt
      user: smartagt
      sslmode: verify-full                                      # chiffrement imposé, nom du serveur vérifié
      sslrootcert: /app/cert/postgresql-ca.crt                  # autorité du certificat PostgreSQL, facultative si elle est dans le magasin du système
  http:
    public:
      host: <adresse IP du serveur>                             # API Publique exposée aux autres hôtes
      certfile: /app/config/backend/tls/server.crt              # certificat de l'API Publique
      keyfile: /app/config/backend/tls/server.key               # clé privée de ce certificat
  gateway:
    server:
      certfile: /app/config/backend/tls/gateway.crt             # certificat de la Gateway
      keyfile: /app/config/backend/tls/gateway.key              # clé privée de ce certificat
smartagt:
  core:
    data_dir: C:/app/data/backend
    log_dir: C:/app/logs/backend
    database:
      host: postgres.example.test                                 # nom porté par le certificat du serveur
      port: 5432
      name: smartagt
      user: smartagt
      sslmode: verify-full                                        # chiffrement imposé, nom du serveur vérifié
      sslrootcert: C:/app/cert/postgresql-ca.crt                  # autorité du certificat PostgreSQL, facultative si elle est dans le magasin du système
  http:
    public:
      host: <adresse IP du serveur>                               # API Publique exposée aux autres hôtes
      certfile: C:/app/config/backend/tls/server.crt              # certificat de l'API Publique
      keyfile: C:/app/config/backend/tls/server.key               # clé privée de ce certificat
  gateway:
    server:
      certfile: C:/app/config/backend/tls/gateway.crt             # certificat de la Gateway
      keyfile: C:/app/config/backend/tls/gateway.key              # clé privée de ce certificat

Pour cette configuration :

  • déposez les certificats de l'API Publique et de la Gateway : Installer vos certificats ;
  • placez l'autorité de PostgreSQL et préparez le serveur : PostgreSQL SSL ;
  • ouvrez les ports 8000 et 8001 au pare-feu pour les clients d'autres hôtes.

Résultat attendu : le package est extrait et smartagt-backend-core.yaml est en place.

Sur chaque nœud Backend :

sudo mkdir -p /app/config/backend
sudo tar -xzf <package Backend> -C /app
sudoedit /app/config/backend/smartagt-backend-core.yaml
New-Item -ItemType Directory -Force C:\app\config\backend | Out-Null
Expand-Archive <package Backend> C:\app\smartagt-backend-core
notepad C:\app\config\backend\smartagt-backend-core.yaml

Donnez au fichier smartagt-backend-core.yaml le même contenu sur tous les nœuds, seule l'adresse de l'API Publique change :

smartagt:
  core:
    data_dir: /var/lib/smartagt/backend
    log_dir: /var/log/smartagt/backend
    database:
      host: postgres.example.test                   # adresse virtuelle de PostgreSQL
      port: 5432
      name: smartagt
      user: smartagt
  deployment:
    nodes:                                          # identique sur tous les nœuds
      - node_id: platform-1
        address: platform-1.example.test
        components: [platform, scheduler, gateway]
      - node_id: platform-2
        address: platform-2.example.test
        components: [platform, scheduler, gateway]
      - node_id: worker-1
        address: worker-1.example.test
        components: [rag-ingestor, rag-embed]
  mediastore:
    backend: s3
    s3:
      endpoint_url: https://s3.example.test
      bucket: smartagt-documents
      region: eu-west-1
  http:
    public:
      host: <adresse IP de ce nœud>                 # API Publique de ce nœud
    internal:
      url: https://api-internal.example.test:8010   # load balancer du lien interne
smartagt:
  core:
    data_dir: C:/app/data/backend
    log_dir: C:/app/logs/backend
    database:
      host: postgres.example.test                   # adresse virtuelle de PostgreSQL
      port: 5432
      name: smartagt
      user: smartagt
  deployment:
    nodes:                                          # identique sur tous les nœuds
      - node_id: platform-1
        address: platform-1.example.test
        components: [platform, scheduler, gateway]
      - node_id: platform-2
        address: platform-2.example.test
        components: [platform, scheduler, gateway]
      - node_id: worker-1
        address: worker-1.example.test
        components: [rag-ingestor, rag-embed]
  mediastore:
    backend: s3
    s3:
      endpoint_url: https://s3.example.test
      bucket: smartagt-documents
      region: eu-west-1
  http:
    public:
      host: <adresse IP de ce nœud>                 # API Publique de ce nœud
    internal:
      url: https://api-internal.example.test:8010   # load balancer du lien interne

Dans cette configuration :

  • deployment.nodes déclare chaque nœud et ses rôles : platform, rag-ingestor, rag-embed, scheduler, gateway
  • les clés d'accès S3 passent par l'environnement, aux étapes 3 et 4
  • les ports 8000 et 8001 s'ouvrent aux clients d'autres hôtes, le port 8010 au seul load balancer du lien interne

Résultat attendu : sur chaque nœud, le package est extrait et smartagt-backend-core.yaml est en place.

2. Générer la clé de chiffrement de clés (KEK)

Conservez la KEK dans votre coffre : sans elle, les secrets stockés en base sont illisibles.

sudo /app/smartagt-backend-core/run.bin generate-kek

Une fois la KEK enregistrée dans le coffre, effacez l'écran avec clear.

C:\app\smartagt-backend-core\run.exe generate-kek

Une fois la KEK enregistrée dans le coffre, effacez l'écran avec Clear-Host.

Générez la KEK une seule fois, sur un nœud. Conservez-la dans votre coffre : tous les nœuds Backend la reprennent.

sudo /app/smartagt-backend-core/run.bin generate-kek

Une fois la KEK enregistrée dans le coffre, effacez l'écran avec clear.

C:\app\smartagt-backend-core\run.exe generate-kek

Une fois la KEK enregistrée dans le coffre, effacez l'écran avec Clear-Host.

3. Initialiser

Cette opération prépare le Backend : elle crée les tables, initialise le chiffrement et le stockage, puis crée le compte admin avec un mot de passe à usage unique.

read -rsp 'Mot de passe du rôle smartagt : ' SMARTAGT_CORE_DATABASE_PASSWORD; echo
read -rsp 'KEK : ' SMARTAGT_KEK; echo
export SMARTAGT_CORE_DATABASE_PASSWORD SMARTAGT_KEK
cd /app/smartagt-backend-core
sudo --preserve-env=SMARTAGT_CORE_DATABASE_PASSWORD,SMARTAGT_KEK ./run.bin init --config /app/config/backend/smartagt-backend-core.yaml
$env:SMARTAGT_CORE_DATABASE_PASSWORD = [Net.NetworkCredential]::new('', (Read-Host 'Mot de passe du rôle smartagt' -AsSecureString)).Password
$env:SMARTAGT_KEK = [Net.NetworkCredential]::new('', (Read-Host 'KEK' -AsSecureString)).Password
Set-Location C:\app\smartagt-backend-core
.\run.exe init --config C:\app\config\backend\smartagt-backend-core.yaml

Résultat attendu :

  • initialisation exécutée sans erreur (code 0) ;
  • mot de passe à usage unique du compte admin récupéré, pour la première connexion.

Sur le premier nœud Platform seulement. Cette opération prépare le Backend : elle crée les tables, initialise le chiffrement et le stockage S3, puis crée le compte admin avec un mot de passe à usage unique. La dernière commande produit le secret de déploiement, par lequel les nœuds Frontend, situés sur d'autres serveurs, se rattachent à l'API.

read -rsp 'Mot de passe du rôle smartagt : ' SMARTAGT_CORE_DATABASE_PASSWORD; echo
read -rsp 'KEK : ' SMARTAGT_KEK; echo
read -rsp "Clé d'accès S3 : " SMARTAGT_MEDIASTORE_S3_ACCESS__KEY; echo
read -rsp 'Secret S3 : ' SMARTAGT_MEDIASTORE_S3_SECRET__KEY; echo
export SMARTAGT_CORE_DATABASE_PASSWORD SMARTAGT_KEK SMARTAGT_MEDIASTORE_S3_ACCESS__KEY SMARTAGT_MEDIASTORE_S3_SECRET__KEY
export SMARTAGT_CLUSTER_ENABLED=true SMARTAGT_NODE_ID=platform-1
cd /app/smartagt-backend-core
sudo --preserve-env=SMARTAGT_CORE_DATABASE_PASSWORD,SMARTAGT_KEK,SMARTAGT_MEDIASTORE_S3_ACCESS__KEY,SMARTAGT_MEDIASTORE_S3_SECRET__KEY,SMARTAGT_CLUSTER_ENABLED,SMARTAGT_NODE_ID ./run.bin init --config /app/config/backend/smartagt-backend-core.yaml
sudo --preserve-env=SMARTAGT_CORE_DATABASE_PASSWORD,SMARTAGT_KEK,SMARTAGT_MEDIASTORE_S3_ACCESS__KEY,SMARTAGT_MEDIASTORE_S3_SECRET__KEY,SMARTAGT_CLUSTER_ENABLED,SMARTAGT_NODE_ID ./run.bin pki generate-join-secret --config /app/config/backend/smartagt-backend-core.yaml
$env:SMARTAGT_CORE_DATABASE_PASSWORD = [Net.NetworkCredential]::new('', (Read-Host 'Mot de passe du rôle smartagt' -AsSecureString)).Password
$env:SMARTAGT_KEK = [Net.NetworkCredential]::new('', (Read-Host 'KEK' -AsSecureString)).Password
$env:SMARTAGT_MEDIASTORE_S3_ACCESS__KEY = [Net.NetworkCredential]::new('', (Read-Host "Clé d'accès S3" -AsSecureString)).Password
$env:SMARTAGT_MEDIASTORE_S3_SECRET__KEY = [Net.NetworkCredential]::new('', (Read-Host 'Secret S3' -AsSecureString)).Password
$env:SMARTAGT_CLUSTER_ENABLED = 'true'
$env:SMARTAGT_NODE_ID = 'platform-1'
Set-Location C:\app\smartagt-backend-core
.\run.exe init --config C:\app\config\backend\smartagt-backend-core.yaml
.\run.exe pki generate-join-secret --config C:\app\config\backend\smartagt-backend-core.yaml

Résultat attendu :

  • initialisation exécutée sans erreur (code 0)
  • mot de passe à usage unique du compte admin récupéré, pour la première connexion
  • valeur join_secret de la ligne JSON affichée conservée dans le coffre, avec la KEK

Les autres nœuds ne lancent pas init : ils rejoignent l'installation au démarrage de leurs services.

4. Créer et démarrer les services

Platform, les trois workers et l'AI Gateway tournent comme services et démarrent avec le serveur.

Créez le compte du service et le fichier de ses secrets :

sudo useradd --system --no-create-home --shell /usr/sbin/nologin svc-smartagt-backend
sudo install -d /etc/smartagt
sudo install -m 600 /dev/null /etc/smartagt/backend.env
sudoedit /etc/smartagt/backend.env
SMARTAGT_CORE_DATABASE_PASSWORD=<mot de passe du rôle smartagt>
SMARTAGT_KEK=<KEK>

Créez les cinq unités, une par service :

/etc/systemd/system/SmartAGT-Platform-Service.service

[Unit]
Description=SmartAGT Platform
Wants=network-online.target
After=network-online.target

[Service]
User=svc-smartagt-backend
WorkingDirectory=/app/smartagt-backend-core
EnvironmentFile=/etc/smartagt/backend.env
ExecStart=/app/smartagt-backend-core/run.bin run --config /app/config/backend/smartagt-backend-core.yaml
StateDirectory=smartagt/backend
LogsDirectory=smartagt/backend
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target

/etc/systemd/system/smartagt-rag-ingestor-worker.service

[Unit]
Description=SmartAGT RAG-Ingestor Worker
Wants=network-online.target
After=network-online.target

[Service]
User=svc-smartagt-backend
WorkingDirectory=/app/smartagt-backend-core
EnvironmentFile=/etc/smartagt/backend.env
ExecStartPre=/app/smartagt-backend-core/run.bin schema-wait --role rag-ingestor --timeout 300 --config /app/config/backend/smartagt-backend-core.yaml
ExecStart=/app/smartagt-backend-core/run.bin worker --role rag-ingestor --config /app/config/backend/smartagt-backend-core.yaml
StateDirectory=smartagt/backend
LogsDirectory=smartagt/backend
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target

/etc/systemd/system/smartagt-rag-embed-worker.service

[Unit]
Description=SmartAGT RAG-Embed Worker
Wants=network-online.target
After=network-online.target

[Service]
User=svc-smartagt-backend
WorkingDirectory=/app/smartagt-backend-core
EnvironmentFile=/etc/smartagt/backend.env
ExecStartPre=/app/smartagt-backend-core/run.bin schema-wait --role rag-embed --timeout 300 --config /app/config/backend/smartagt-backend-core.yaml
ExecStart=/app/smartagt-backend-core/run.bin worker --role rag-embed --config /app/config/backend/smartagt-backend-core.yaml
StateDirectory=smartagt/backend
LogsDirectory=smartagt/backend
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target

/etc/systemd/system/smartagt-scheduler-worker.service

[Unit]
Description=SmartAGT Scheduler Worker
Wants=network-online.target
After=network-online.target

[Service]
User=svc-smartagt-backend
WorkingDirectory=/app/smartagt-backend-core
EnvironmentFile=/etc/smartagt/backend.env
ExecStartPre=/app/smartagt-backend-core/run.bin schema-wait --role scheduler --timeout 300 --config /app/config/backend/smartagt-backend-core.yaml
ExecStart=/app/smartagt-backend-core/run.bin worker --role scheduler --config /app/config/backend/smartagt-backend-core.yaml
StateDirectory=smartagt/backend
LogsDirectory=smartagt/backend
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target

/etc/systemd/system/SmartAGT-AI-Gateway-Service.service

[Unit]
Description=SmartAGT AI Gateway
Wants=network-online.target
After=network-online.target

[Service]
User=svc-smartagt-backend
WorkingDirectory=/app/smartagt-backend-core
EnvironmentFile=/etc/smartagt/backend.env
ExecStart=/app/smartagt-backend-core/run.bin gateway --config /app/config/backend/smartagt-backend-core.yaml
StateDirectory=smartagt/backend
LogsDirectory=smartagt/backend
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target

Une fois les cinq unités créées, lancez les services :

sudo systemctl daemon-reload
sudo systemctl enable --now SmartAGT-Platform-Service smartagt-rag-ingestor-worker smartagt-rag-embed-worker smartagt-scheduler-worker SmartAGT-AI-Gateway-Service

Les services se créent avec les commandes de Windows.

$password = [Net.NetworkCredential]::new('', (Read-Host 'Mot de passe du rôle smartagt' -AsSecureString)).Password
$kek = [Net.NetworkCredential]::new('', (Read-Host 'KEK' -AsSecureString)).Password
$config = 'C:\app\config\backend\smartagt-backend-core.yaml'
$services = @(
    @{ Name = 'SmartAGT-Platform-Service';    Display = 'SmartAGT Platform Service';    Arguments = "run --config $config"
       Description = 'Plateforme SmartAGT.' }
    @{ Name = 'smartagt-rag-ingestor-worker'; Display = 'SmartAGT RAG-Ingestor Worker'; Arguments = "worker --role rag-ingestor --config $config"
       Description = 'Extraction et découpage des documents déposés dans SmartAGT.' }
    @{ Name = 'smartagt-rag-embed-worker';    Display = 'SmartAGT RAG-Embed Worker';    Arguments = "worker --role rag-embed --config $config"
       Description = 'Calcul des vecteurs des documents SmartAGT.' }
    @{ Name = 'smartagt-scheduler-worker';    Display = 'SmartAGT Scheduler Worker';    Arguments = "worker --role scheduler --config $config"
       Description = 'Tâches planifiées de SmartAGT : maintenances, annuaire, courriels.' }
    @{ Name = 'SmartAGT-AI-Gateway-Service';  Display = 'SmartAGT AI Gateway Service';  Arguments = "gateway --config $config"
       Description = 'Accès des outils raccordés aux modèles de SmartAGT.' }
)
foreach ($service in $services) {
    New-Service -Name $service.Name -DisplayName $service.Display -Description $service.Description -BinaryPathName "`"C:\app\smartagt-backend-core\run.exe`" $($service.Arguments)" -StartupType Automatic | Out-Null
    Set-ItemProperty "HKLM:\SYSTEM\CurrentControlSet\Services\$($service.Name)" -Name Environment -Type MultiString -Value "SMARTAGT_CORE_DATABASE_PASSWORD=$password", "SMARTAGT_KEK=$kek"
    sc.exe failure $service.Name reset= 86400 actions= restart/10000 | Out-Null
    sc.exe failureflag $service.Name 1 | Out-Null
    Start-Service $service.Name
}

Fermez ensuite la console.

Mode alternatif : NSSM héberge run.exe comme service. Installez nssm.exe 64 bits dans le PATH.

$password = [Net.NetworkCredential]::new('', (Read-Host 'Mot de passe du rôle smartagt' -AsSecureString)).Password
$kek = [Net.NetworkCredential]::new('', (Read-Host 'KEK' -AsSecureString)).Password
$config = 'C:\app\config\backend\smartagt-backend-core.yaml'
$services = @(
    @{ Name = 'SmartAGT-Platform-Service';    Display = 'SmartAGT Platform Service';    Arguments = "run --config $config"
       Description = 'Plateforme SmartAGT.' }
    @{ Name = 'smartagt-rag-ingestor-worker'; Display = 'SmartAGT RAG-Ingestor Worker'; Arguments = "worker --role rag-ingestor --config $config"
       Description = 'Extraction et découpage des documents déposés dans SmartAGT.' }
    @{ Name = 'smartagt-rag-embed-worker';    Display = 'SmartAGT RAG-Embed Worker';    Arguments = "worker --role rag-embed --config $config"
       Description = 'Calcul des vecteurs des documents SmartAGT.' }
    @{ Name = 'smartagt-scheduler-worker';    Display = 'SmartAGT Scheduler Worker';    Arguments = "worker --role scheduler --config $config"
       Description = 'Tâches planifiées de SmartAGT : maintenances, annuaire, courriels.' }
    @{ Name = 'SmartAGT-AI-Gateway-Service';  Display = 'SmartAGT AI Gateway Service';  Arguments = "gateway --config $config"
       Description = 'Accès des outils raccordés aux modèles de SmartAGT.' }
)
foreach ($service in $services) {
    nssm install $service.Name C:\app\smartagt-backend-core\run.exe
    nssm set $service.Name DisplayName $service.Display
    nssm set $service.Name Description $service.Description
    nssm set $service.Name AppParameters $service.Arguments
    nssm set $service.Name AppDirectory C:\app\smartagt-backend-core
    nssm set $service.Name AppEnvironmentExtra "SMARTAGT_CORE_DATABASE_PASSWORD=$password" "SMARTAGT_KEK=$kek"
    nssm start $service.Name
}

Fermez ensuite la console.

Résultat attendu : curl -k https://localhost:8000/api/v1/core/security/jwt/public-key (curl.exe sous Windows) affiche la clé publique de l'API.

Sur chaque nœud, créez les services des rôles que lui attribue deployment.nodes :

Rôle dans components Service
platform SmartAGT-Platform-Service
rag-ingestor smartagt-rag-ingestor-worker
rag-embed smartagt-rag-embed-worker
scheduler smartagt-scheduler-worker
gateway SmartAGT-AI-Gateway-Service

Créez le compte du service et le fichier de ses secrets :

sudo useradd --system --no-create-home --shell /usr/sbin/nologin svc-smartagt-backend
sudo install -d /etc/smartagt
sudo install -m 600 /dev/null /etc/smartagt/backend.env
sudoedit /etc/smartagt/backend.env
SMARTAGT_CORE_DATABASE_PASSWORD=<mot de passe du rôle smartagt>
SMARTAGT_KEK=<KEK du coffre>
SMARTAGT_MEDIASTORE_S3_ACCESS__KEY=<clé d'accès S3>
SMARTAGT_MEDIASTORE_S3_SECRET__KEY=<secret S3>
SMARTAGT_CLUSTER_ENABLED=true
SMARTAGT_NODE_ID=<node_id de ce nœud>
SMARTAGT_INTERNAL_JOIN_SECRET=<secret de déploiement du coffre>

Créez les unités des rôles de ce nœud :

/etc/systemd/system/SmartAGT-Platform-Service.service

[Unit]
Description=SmartAGT Platform
Wants=network-online.target
After=network-online.target

[Service]
User=svc-smartagt-backend
WorkingDirectory=/app/smartagt-backend-core
EnvironmentFile=/etc/smartagt/backend.env
ExecStart=/app/smartagt-backend-core/run.bin run --config /app/config/backend/smartagt-backend-core.yaml
StateDirectory=smartagt/backend
LogsDirectory=smartagt/backend
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target

/etc/systemd/system/smartagt-rag-ingestor-worker.service

[Unit]
Description=SmartAGT RAG-Ingestor Worker
Wants=network-online.target
After=network-online.target

[Service]
User=svc-smartagt-backend
WorkingDirectory=/app/smartagt-backend-core
EnvironmentFile=/etc/smartagt/backend.env
ExecStartPre=/app/smartagt-backend-core/run.bin schema-wait --role rag-ingestor --timeout 300 --config /app/config/backend/smartagt-backend-core.yaml
ExecStart=/app/smartagt-backend-core/run.bin worker --role rag-ingestor --config /app/config/backend/smartagt-backend-core.yaml
StateDirectory=smartagt/backend
LogsDirectory=smartagt/backend
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target

/etc/systemd/system/smartagt-rag-embed-worker.service

[Unit]
Description=SmartAGT RAG-Embed Worker
Wants=network-online.target
After=network-online.target

[Service]
User=svc-smartagt-backend
WorkingDirectory=/app/smartagt-backend-core
EnvironmentFile=/etc/smartagt/backend.env
ExecStartPre=/app/smartagt-backend-core/run.bin schema-wait --role rag-embed --timeout 300 --config /app/config/backend/smartagt-backend-core.yaml
ExecStart=/app/smartagt-backend-core/run.bin worker --role rag-embed --config /app/config/backend/smartagt-backend-core.yaml
StateDirectory=smartagt/backend
LogsDirectory=smartagt/backend
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target

/etc/systemd/system/smartagt-scheduler-worker.service

[Unit]
Description=SmartAGT Scheduler Worker
Wants=network-online.target
After=network-online.target

[Service]
User=svc-smartagt-backend
WorkingDirectory=/app/smartagt-backend-core
EnvironmentFile=/etc/smartagt/backend.env
ExecStartPre=/app/smartagt-backend-core/run.bin schema-wait --role scheduler --timeout 300 --config /app/config/backend/smartagt-backend-core.yaml
ExecStart=/app/smartagt-backend-core/run.bin worker --role scheduler --config /app/config/backend/smartagt-backend-core.yaml
StateDirectory=smartagt/backend
LogsDirectory=smartagt/backend
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target

/etc/systemd/system/SmartAGT-AI-Gateway-Service.service

[Unit]
Description=SmartAGT AI Gateway
Wants=network-online.target
After=network-online.target

[Service]
User=svc-smartagt-backend
WorkingDirectory=/app/smartagt-backend-core
EnvironmentFile=/etc/smartagt/backend.env
ExecStart=/app/smartagt-backend-core/run.bin gateway --config /app/config/backend/smartagt-backend-core.yaml
StateDirectory=smartagt/backend
LogsDirectory=smartagt/backend
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target

Une fois les unités créées, lancez les services de ce nœud :

sudo systemctl daemon-reload
sudo systemctl enable --now <services de ce nœud>

Les services se créent avec les commandes de Windows.

$password = [Net.NetworkCredential]::new('', (Read-Host 'Mot de passe du rôle smartagt' -AsSecureString)).Password
$kek = [Net.NetworkCredential]::new('', (Read-Host 'KEK' -AsSecureString)).Password
$s3Key = [Net.NetworkCredential]::new('', (Read-Host "Clé d'accès S3" -AsSecureString)).Password
$s3Secret = [Net.NetworkCredential]::new('', (Read-Host 'Secret S3' -AsSecureString)).Password
$joinSecret = [Net.NetworkCredential]::new('', (Read-Host 'Secret de déploiement' -AsSecureString)).Password
$nodeId = '<node_id de ce nœud>'
$config = 'C:\app\config\backend\smartagt-backend-core.yaml'
# Gardez dans cette liste les seuls services des rôles de ce nœud.
$services = @(
    @{ Name = 'SmartAGT-Platform-Service';    Display = 'SmartAGT Platform Service';    Arguments = "run --config $config"
       Description = 'Plateforme SmartAGT.' }
    @{ Name = 'smartagt-rag-ingestor-worker'; Display = 'SmartAGT RAG-Ingestor Worker'; Arguments = "worker --role rag-ingestor --config $config"
       Description = 'Extraction et découpage des documents déposés dans SmartAGT.' }
    @{ Name = 'smartagt-rag-embed-worker';    Display = 'SmartAGT RAG-Embed Worker';    Arguments = "worker --role rag-embed --config $config"
       Description = 'Calcul des vecteurs des documents SmartAGT.' }
    @{ Name = 'smartagt-scheduler-worker';    Display = 'SmartAGT Scheduler Worker';    Arguments = "worker --role scheduler --config $config"
       Description = 'Tâches planifiées de SmartAGT : maintenances, annuaire, courriels.' }
    @{ Name = 'SmartAGT-AI-Gateway-Service';  Display = 'SmartAGT AI Gateway Service';  Arguments = "gateway --config $config"
       Description = 'Accès des outils raccordés aux modèles de SmartAGT.' }
)
foreach ($service in $services) {
    New-Service -Name $service.Name -DisplayName $service.Display -Description $service.Description -BinaryPathName "`"C:\app\smartagt-backend-core\run.exe`" $($service.Arguments)" -StartupType Automatic | Out-Null
    Set-ItemProperty "HKLM:\SYSTEM\CurrentControlSet\Services\$($service.Name)" -Name Environment -Type MultiString -Value "SMARTAGT_CORE_DATABASE_PASSWORD=$password", "SMARTAGT_KEK=$kek", "SMARTAGT_MEDIASTORE_S3_ACCESS__KEY=$s3Key", "SMARTAGT_MEDIASTORE_S3_SECRET__KEY=$s3Secret", 'SMARTAGT_CLUSTER_ENABLED=true', "SMARTAGT_NODE_ID=$nodeId", "SMARTAGT_INTERNAL_JOIN_SECRET=$joinSecret"
    sc.exe failure $service.Name reset= 86400 actions= restart/10000 | Out-Null
    sc.exe failureflag $service.Name 1 | Out-Null
    Start-Service $service.Name
}

Fermez ensuite la console.

Mode alternatif : NSSM héberge run.exe comme service. Installez nssm.exe 64 bits dans le PATH.

$password = [Net.NetworkCredential]::new('', (Read-Host 'Mot de passe du rôle smartagt' -AsSecureString)).Password
$kek = [Net.NetworkCredential]::new('', (Read-Host 'KEK' -AsSecureString)).Password
$s3Key = [Net.NetworkCredential]::new('', (Read-Host "Clé d'accès S3" -AsSecureString)).Password
$s3Secret = [Net.NetworkCredential]::new('', (Read-Host 'Secret S3' -AsSecureString)).Password
$joinSecret = [Net.NetworkCredential]::new('', (Read-Host 'Secret de déploiement' -AsSecureString)).Password
$nodeId = '<node_id de ce nœud>'
$config = 'C:\app\config\backend\smartagt-backend-core.yaml'
# Gardez dans cette liste les seuls services des rôles de ce nœud.
$services = @(
    @{ Name = 'SmartAGT-Platform-Service';    Display = 'SmartAGT Platform Service';    Arguments = "run --config $config"
       Description = 'Plateforme SmartAGT.' }
    @{ Name = 'smartagt-rag-ingestor-worker'; Display = 'SmartAGT RAG-Ingestor Worker'; Arguments = "worker --role rag-ingestor --config $config"
       Description = 'Extraction et découpage des documents déposés dans SmartAGT.' }
    @{ Name = 'smartagt-rag-embed-worker';    Display = 'SmartAGT RAG-Embed Worker';    Arguments = "worker --role rag-embed --config $config"
       Description = 'Calcul des vecteurs des documents SmartAGT.' }
    @{ Name = 'smartagt-scheduler-worker';    Display = 'SmartAGT Scheduler Worker';    Arguments = "worker --role scheduler --config $config"
       Description = 'Tâches planifiées de SmartAGT : maintenances, annuaire, courriels.' }
    @{ Name = 'SmartAGT-AI-Gateway-Service';  Display = 'SmartAGT AI Gateway Service';  Arguments = "gateway --config $config"
       Description = 'Accès des outils raccordés aux modèles de SmartAGT.' }
)
foreach ($service in $services) {
    nssm install $service.Name C:\app\smartagt-backend-core\run.exe
    nssm set $service.Name DisplayName $service.Display
    nssm set $service.Name Description $service.Description
    nssm set $service.Name AppParameters $service.Arguments
    nssm set $service.Name AppDirectory C:\app\smartagt-backend-core
    nssm set $service.Name AppEnvironmentExtra "SMARTAGT_CORE_DATABASE_PASSWORD=$password" "SMARTAGT_KEK=$kek" "SMARTAGT_MEDIASTORE_S3_ACCESS__KEY=$s3Key" "SMARTAGT_MEDIASTORE_S3_SECRET__KEY=$s3Secret" 'SMARTAGT_CLUSTER_ENABLED=true' "SMARTAGT_NODE_ID=$nodeId" "SMARTAGT_INTERNAL_JOIN_SECRET=$joinSecret"
    nssm start $service.Name
}

Fermez ensuite la console.

Résultat attendu : sur chaque nœud Platform, curl -k https://<adresse IP du nœud>:8000/api/v1/core/security/jwt/public-key (curl.exe sous Windows) affiche la clé publique de l'API.

Cas particuliers

Hôte worker supplémentaire

Un hôte worker supplémentaire utilise le même package, les mêmes bases et la KEK du Backend existant. Reprenez la configuration en adaptant les chemins et les adresses à ce nœud. Si S3 est retenu, tous les rôles utilisent le même bucket et les mêmes paramètres de raccordement.

Sautez les étapes 2 et 3 : la KEK vient de votre coffre et la base est déjà initialisée. À l'étape 4, créez seulement les services des workers prévus sur ce nœud.

Installation répartie

Déclarez la topologie dans le YAML commun. Chaque nœud reçoit son identifiant dans SMARTAGT_NODE_ID, à ajouter à la session avant init et à l'environnement de ses services.

Frontend sur un autre serveur

Renseignez http.internal.url avec un nom ou une adresse joignable depuis ce serveur, identique dans le YAML de chaque nœud API. Elle désigne un nœud API ou un load balancer : sur ce lien, il fait un simple passage TCP (L4) et ne termine pas le TLS. La première API démarrée enregistre cette URL. Pour la changer ensuite, exécutez run.bin pki internal-url set <url>, reportez la nouvelle valeur dans le YAML de chaque nœud API, puis redémarrez chacun d'eux : un nœud dont la valeur diffère ferme son écoute Interne. Le Frontend service retrouve seul la nouvelle URL par son adresse de rattachement, dans les cinq minutes, tant que l'écoute Public reste joignable.

Le secret de déploiement et la suite du rattachement sont décrits dans Installer le Frontend.

Stockage S3

Appliquez Configurer S3, puis reportez les six paramètres indiqués dans le YAML avant l’initialisation. API et workers lisent le même raccordement.

Changer l'URL interne

La première API démarrée enregistre http.internal.url. Pour la changer ensuite, exécutez run.bin pki internal-url set <url>, reportez la nouvelle valeur dans le YAML de chaque nœud Platform, puis redémarrez chacun d'eux. Un nœud dont la valeur diffère ferme son écoute Interne. Le Frontend retrouve seul la nouvelle URL dans les cinq minutes.

Ajouter un nœud Backend

Déclarez le nouveau nœud dans deployment.nodes, dans le YAML de tous les nœuds : les nœuds en service le relisent à leur prochain redémarrage. Sur le nouveau nœud, appliquez l'étape 1 avec ce YAML commun. Sautez les étapes 2 et 3 : la KEK et le secret de déploiement viennent du coffre, la base est déjà initialisée. À l'étape 4, créez les services de ses rôles.