Aller au contenu

Première installation de test ​

Cette procédure installe Save2ERP sur un poste Windows, avec Docker, pour un premier test en local (https://localhost:5000). Elle prend une trentaine de minutes.

Pour un test uniquement

Le certificat créé ici n'est reconnu que par ce poste. Pour un serveur partagé, voir Installer en production.

Avant de commencer ​

  • Docker Desktop et Node.js (pour la commande npx de l'étape 2) installés sur le poste.
  • Les fichiers remis par Swiss Computing : docker-compose.yml, license.lic, .env (ou le modèle .env.example, à compléter, voir Configurer le serveur) et le manifeste de test.
  • L'accès à l'image Docker : soit un jeton d'accès au registre d'images, soit le fichier de l'image (save2erp-<version>.tar.gz).

Toutes les commandes se lancent dans PowerShell, depuis le dossier d'installation.

1. Préparer le dossier ​

Créez un dossier, par exemple C:\save2erp, et copiez-y docker-compose.yml, license.lic et .env. Puis :

powershell
cd C:\save2erp
dir -Force

La commande doit lister les trois fichiers (-Force affiche aussi .env).

2. Créer le certificat HTTPS ​

Word n'accepte qu'une adresse HTTPS avec un certificat reconnu par Windows, même sur localhost. L'outil de Microsoft pour les compléments Office crée ce certificat et installe son autorité dans Windows :

powershell
npx office-addin-dev-certs install --days 365

Si npx demande d'installer le paquet, répondez y. Windows demande ensuite d'installer l'autorité « Developer CA for Microsoft Office Add-ins » : répondez Oui.

3. Copier le certificat dans le dossier ​

powershell
New-Item -ItemType Directory -Force dev\certificates
Copy-Item $env:USERPROFILE\.office-addin-dev-certs\localhost.* dev\certificates\
dir dev\certificates

Le dossier dev\certificates doit contenir localhost.crt et localhost.key.

4. Déclarer le certificat dans docker-compose.yml ​

Ouvrez docker-compose.yml et ajoutez cette ligne dans la liste volumes: du service save2erp, avec la même indentation que les lignes voisines :

yaml
      - ./dev/certificates:/app/dev/certificates:ro

5. Récupérer l'image ​

Avec un jeton d'accès au registre :

powershell
docker login ghcr.io -u <utilisateur remis par Swiss Computing>

Au message Password:, collez le jeton (rien ne s'affiche pendant la saisie), puis Entrée. Docker répond Login Succeeded.

Avec le fichier de l'image :

powershell
docker load -i save2erp-<version>.tar.gz

6. Démarrer Save2ERP ​

powershell
docker compose up -d

7. Vérifier les logs ​

powershell
docker compose logs -f

Les logs doivent indiquer, entre autres :

  • Licence : … avec le nom du client, le nombre d'utilisateurs et la date de fin ;
  • une ligne par système déclaré dans le .env, avec son environnement ;
  • Certificat HTTPS : …, valable jusqu'au … ;
  • Server HTTPS started on port 5000.

Quittez l'affichage avec Ctrl+C : le conteneur continue de tourner. En cas d'erreur « Fichier du certificat HTTPS illisible », vérifiez les étapes 3 et 4, puis relancez docker compose up -d.

Ouvrez dans Edge ou Chrome la page de diagnostic https://localhost:5000/test. Elle doit s'ouvrir sans avertissement de certificat. Vous pouvez y tester la connexion au système cible (voir Diagnostiquer un problème).

9. Ajouter le complément à Word ​

Pour un test sur un seul poste, Word peut charger le complément depuis un dossier partagé contenant le manifeste :

  1. Déposez le manifeste dans un dossier partagé du réseau.
  2. Dans Word : Fichier › Options › Centre de gestion de la confidentialité › Paramètres du Centre de gestion de la confidentialité › Catalogues de compléments approuvés.
  3. Saisissez le chemin réseau du dossier dans « URL du catalogue », cliquez sur Ajouter un catalogue, cochez Afficher dans le menu, puis OK.
  4. Redémarrez Word, puis Compléments › Plus de compléments › Dossier partagé › Save2ERP › Ajouter.

Le bouton « Sauvegarder dans SAP » apparaît dans le ruban. Pour tous les utilisateurs, déployez plutôt le complément depuis Microsoft 365 (voir Déployer dans Microsoft 365).

Commandes utiles ​

ActionCommande
Démarrerdocker compose up -d
Arrêterdocker compose down
Consulter les logsdocker compose logs -f
Modifier la configurationmodifier .env, puis docker compose restart
Renouveler la licenceremplacer license.lic, puis docker compose restart

Remettre le poste à zéro ​

powershell
docker compose down -v
docker rmi ghcr.io/swiss-computing/save2erp:<version>
docker logout ghcr.io
Remove-Item -Recurse -Force dev\certificates
npx office-addin-dev-certs uninstall

down -v supprime aussi les volumes : le registre des utilisateurs de la licence et les logs. La dernière commande retire l'autorité de certification du poste.