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.
-
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" -
À 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__KEYAjoutez aussi
SMARTAGT_MEDIASTORE_S3_ACCESS__KEY,SMARTAGT_MEDIASTORE_S3_SECRET__KEYà la liste--preserve-envde la commandeinit.$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 -
À 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)).PasswordPuis ajoutez-les à la valeur
Environmentde 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)).PasswordPuis 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.
-
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" -
Donnez les clés par l'environnement, dans la session d'
initpuis dans celui des services de chaque nœud :SMARTAGT_MEDIASTORE_S3_ACCESS__KEYpour la clé d'accès,SMARTAGT_MEDIASTORE_S3_SECRET__KEYpour le secret.
Résultat attendu : sur chaque nœud, les services démarrent sans erreur de raccordement S3.