Aller au contenu principal

Publication dans IIS

Ce guide permet de configurer un serveur Windows en vue de l'installation d'une application Lagoon dans IIS. Les copies d'écran de l'ancienne documentation ont été volontairement retirées.

Pré-requis​

Configuration matérielle recommandée​

  • Processeur : minimum 4 cœurs, recommandé 8 cœurs ou plus.
  • Mémoire RAM : minimum 8 Go, recommandé 16 Go ou plus.
  • Espace disque : au moins 100 Go d'espace libre.

Logiciels requis​

  • Système d'exploitation : Windows Server 2016 ou version ultérieure.
  • IIS : version 10 ou ultérieure, avec le rôle Serveur Web installé.
  • .NET Core Hosting Bundle : contient le runtime .NET Core, la bibliothèque .NET Core et le module ASP.NET Core.

Considérations supplémentaires​

  • La mémoire requise dépend du nombre d'utilisateurs simultanés et de la complexité de l'application.
  • Il est recommandé d'activer WebSockets dans IIS pour de meilleures performances.
  • Un certificat SSL valide est nécessaire pour le protocole HTTPS.
Note

Ces recommandations sont générales et peuvent varier selon la complexité et l'utilisation spécifique de l'application Blazor WebAssembly hébergée. Il est recommandé de surveiller les performances en environnement de développement pour mieux estimer les besoins en production.

Configuration du serveur​

Installation de IIS​

Exécuter la commande PowerShell suivante en tant qu'administrateur pour installer IIS et les rôles nécessaires :

Install-WindowsFeature -name Web-Server,Web-WebSockets -IncludeManagementTools

Installation du runtime .NET​

iisreset

Configuration de IIS​

Création du dossier physique pour l'application​

  • Copier les fichiers du dossier livré qui contient le site dans un dossier sur le serveur d'application, par exemple C:\inetpub\myapproot.
  • Donner le droit de lecture/exécution au groupe IIS_IUSRS sur le dossier créé.

Création du pool d'application​

Depuis le gestionnaire IIS :

  • Cliquer sur Pools d'applications dans le volet de gauche.
  • Cliquer sur Ajouter un pool d'applications dans le volet de droite.
  • Créer un pool d'application en choisissant Aucun code managé dans la version de CLR .NET.
  • Sélectionner le pool nouvellement créé puis cliquer sur Paramètres avancés dans le volet de droite.
  • Mettre l'option Charger le profil utilisateur à Vrai.
Attention

Si le profil utilisateur n'est pas chargé, le certificat ne pourra pas être chargé et l'application pourra retourner une erreur de type The antiforgery token could not be decrypted., The system cannot find the file specified. ou System.Security.Cryptography.CryptographicException: Access is denied.

  • Optionnellement, dans le cas d'une authentification Windows à SQL Server, changer l'identité sous laquelle est exécuté le pool d'application.
  • Optionnellement, mettre la valeur AlwaysRunning au paramètre Mode de démarrage pour éviter un temps d'attente lors du premier accès à l'application après un redémarrage d'IIS.

Création de l'application dans IIS​

Créer un nouveau site, ou une nouvelle application sous un site existant, en sélectionnant le pool d'applications précédemment créé.

Activer HTTPS, optionnel​

  • Faire un clic droit sur le nouveau site et choisir Modifier les liaisons....
  • Ajouter une liaison de site de type HTTPS.

Préchargement, optionnel​

  • Faire un clic droit sur la nouvelle application créée, ou le nouveau site créé.
  • Choisir Gérer une application ou Gérer le site web, puis Paramètres avancés.
  • Mettre l'option Préchargement activé à true.
Remarque

Le préchargement est à utiliser avec le paramètre AlwaysRunning du pool d'applications pour une pré-initialisation complète de l'application.

Configuration de l'application​

appsettings.json​

Modifier le fichier appsettings.json avec un éditeur de texte :

  • PublicUrl : URL publique de la racine de l'application, c'est-à-dire celle utilisée par les utilisateurs finaux.
  • Emplacement du journal de trace.
  • Chaînes de connexion aux bases de données.
  • Serveur SMTP.
  • Autres paramètres propres à l'application.
Attention

Le caractère \ doit être doublé dans ce fichier de configuration. Exemple : C:\\Temp\\MonApp\\Log.

Web.config​

Le fichier Web.config n'a normalement pas besoin d'être modifié pour configurer l'application.