Aller au contenu

Configurer S3

Raccordez SmartAGT à un bucket S3 privé. S3 est requis en conteneurs et peut être retenu sur VM, selon le mode de stockage.

Raccordez SmartAGT à un bucket S3 privé. En cluster, S3 est requis : tous les nœuds Backend partagent le même bucket, d'où chacun relit les documents déposés par les autres. Voir le mode de stockage.

À préparer : endpoint HTTPS, bucket privé et clés d’accès, ainsi que la région si votre fournisseur la demande. Le compte S3 doit pouvoir consulter le bucket, lire, écrire et supprimer ses objets.

Procédure

1. Préparer la confiance

Avec une autorité privée, installez sa chaîne de confiance sur chaque hôte Backend avant l’initialisation. En conteneurs, ajoutez-la au magasin de confiance de l’image utilisée.

sudo install -m 644 s3-ca.crt /usr/local/share/ca-certificates/smartagt-s3.crt
sudo update-ca-certificates

Dans PowerShell administrateur :

Import-Certificate -FilePath '.\s3-ca.crt' -CertStoreLocation Cert:\LocalMachine\Root

2. Raccorder le bucket

Les clés d'accès S3 sont des secrets : elles ne figurent jamais dans le YAML. Comme le mot de passe PostgreSQL et la KEK, elles passent par l'environnement.

  1. Dans le YAML Backend livré, renseignez le bloc suivant avec les paramètres du bucket, sans les clés :

    smartagt:
      mediastore:
        backend: s3
        s3:
          endpoint_url: "https://storage.example.org"
          bucket: "smartagt-documents"
          region: "eu-west-1"
    
  2. À l'initialisation, ajoutez les clés à la session avant de lancer init :

    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_MEDIASTORE_S3_ACCESS__KEY SMARTAGT_MEDIASTORE_S3_SECRET__KEY
    

    Ajoutez aussi SMARTAGT_MEDIASTORE_S3_ACCESS__KEY,SMARTAGT_MEDIASTORE_S3_SECRET__KEY à la liste --preserve-env de la commande init.

    $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
    
  3. À la création des services, ajoutez les mêmes clés à leur environnement :

    Dans /etc/smartagt/backend.env, à la suite du mot de passe et de la KEK :

    SMARTAGT_MEDIASTORE_S3_ACCESS__KEY=<clé d'accès S3>
    SMARTAGT_MEDIASTORE_S3_SECRET__KEY=<secret S3>
    

    Avant la boucle de création, lisez les clés :

    $s3Key = [Net.NetworkCredential]::new('', (Read-Host "Clé d'accès S3" -AsSecureString)).Password
    $s3Secret = [Net.NetworkCredential]::new('', (Read-Host 'Secret S3' -AsSecureString)).Password
    

    Puis ajoutez-les à la valeur Environment de chaque service :

    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"
    

    Avant la boucle de création, lisez les clés :

    $s3Key = [Net.NetworkCredential]::new('', (Read-Host "Clé d'accès S3" -AsSecureString)).Password
    $s3Secret = [Net.NetworkCredential]::new('', (Read-Host 'Secret S3' -AsSecureString)).Password
    

    Puis ajoutez-les à l'environnement de chaque service :

    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"
    

En conteneurs, injectez les deux variables depuis le gestionnaire de secrets de votre infrastructure.

Résultat attendu : l'initialisation et les services démarrent sans erreur de raccordement S3.

Le raccordement se déclare à l'installation du Backend, à l'identique sur tous les nœuds : Installer le Backend.

  1. Dans le YAML commun des nœuds Backend, renseignez le bloc suivant, sans les clés d'accès :

    smartagt:
      mediastore:
        backend: s3
        s3:
          endpoint_url: "https://storage.example.org"
          bucket: "smartagt-documents"
          region: "eu-west-1"
    
  2. Donnez les clés par l'environnement, dans la session d'init puis dans celui des services de chaque nœud : SMARTAGT_MEDIASTORE_S3_ACCESS__KEY pour la clé d'accès, SMARTAGT_MEDIASTORE_S3_SECRET__KEY pour le secret.

Résultat attendu : sur chaque nœud, les services démarrent sans erreur de raccordement S3.