Héberger un StarterKit (IIS)
Contexte
Les sites StarterKit v2 et v3 (Umbraco, .NET Framework 4.8) sont hébergés directement sur IIS, sur le serveur Windows. Chaque client a son propre site IIS et son propre pool applicatif ; le code compilé et les données vivent dans une arborescence dédiée sous E:\.
Pourquoi plus de Docker
L'approche précédente faisait tourner un IIS embarqué dans une image Docker Windows, une par client. C'était coûteux : chaque conteneur embarquait son propre IIS, ce qui consommait énormément de RAM et imposait des serveurs dédiés. En hébergeant les sites directement sur l'IIS de la machine, on les fait cohabiter sur un seul serveur, sans la surcharge des conteneurs Windows.
Structure des fichiers
Sur le serveur Windows, voici la structure pour un client :
E:\<customer>\
├── website\
├── Media\
├── Customer\
└── App_Data\Description
website: site Umbraco compiléMedia: médias / fichiers uploadésCustomer: données spécifiques au client (documents, etc.)App_Data: logs, cache Umbraco, etc.
<customer> correspond au skin du client : le même identifiant que dans le pipeline et dans la convention de nommage.
Comment un site est servi
- Site IIS et pool applicatif dédiés par client, nommés
umb_<customer>_<env>. - Le pool pointe sur
E:\<customer>\website, qui contient le site Umbraco compilé. - Les dossiers de données persistantes (
Media,Customer,App_Data) sont externalisés à côté duwebsiteet raccordés au site via des virtual directories IIS. Ils restent ainsi hors du dossier de build et ne sont jamais écrasés par un déploiement.
Mettre en place un nouveau site
La création d'un site (site IIS, pool applicatif, virtual directories, base de données, DNS, certificat SSL) est une opération à part entière, décrite pas à pas dans Mise en place d'un site.
Déployer et mettre à jour un site
Les mises à jour ne se font ni à la main ni par FTP : un pipeline GitLab compile le site pour le skin demandé et l'installe sur le serveur via un runner posé sur la machine IIS. La procédure complète (build, déploiement manuel par SKIN, dossiers protégés, rollback) est dans StarterKit v2 et v3 : mettre à jour un site.
Contributors
Clément Favre