Proc#167 - Procédure de mise en ligne d'une version du client « lourd »

La mise en ligne d'une version consiste à mettre à disposition du public le fichier de mise à jour et le programme d'installation, et à informer les utilisateurs des changements réalisés.

Les règles de numérotation, de branches et de tags sont définies dans Proc#145 - Procédure de Gestion des Versions.

Passer les tests prévus pour le niveau de la version (Majeure, Mineure ou Release), selon Proc#168 - Chaîne de qualification et de livraison. Ne pas poursuivre tant que les tests ne sont pas passés.

La liste des changements est extraite de l'historique Git du dépôt du client lourd.

1. Retrouver le tag de la dernière version publiée : git tag –sort=-creatordate
2. Extraire les messages des commits depuis ce tag : git log <tag de la dernière version publiée>..HEAD –no-merges –pretty=format:“%s”
3. Faire le ménage : ne garder que ce qui concerne l'utilisateur, regrouper par thème, reformuler si besoin.

Cette liste sert au courriel d'information de l'étape 4.

Un seul fichier est diffusé : l'exécutable de la version courante.

1. Lancer Delphi dans sa version courante et ouvrir le projet D:\dev\logeas\src\LoGeAs WEB\LOGEAS.dproj.
2. Ouvrir les options du projet pour vérifier le numéro de version, et l'incrémenter si besoin selon Proc#145.
3. Construire en version RELEASE, puis quitter Delphi (Release\Alpha s'il s'agit d'une alpha).
4. Se rendre dans le dossier où le fichier .exe a été créé et vérifier dans ses propriétés que le numéro de version est bon et que l'icône est présente.
5. Ouvrir une invite de commande dans ce dossier (Maj + clic droit) et taper .\signer.bat “MotDePasse”, en remplaçant MotDePasse par le mot de passe du certificat (cf. Dashlane : codesign.p12). ATTENTION : le mot de passe est entre guillemets.
   En cas d'erreur « fichier introuvable », vérifier que signtool est installé sur le poste : voir le détail dans cette fiche.
6. Vérifier dans les propriétés du fichier .exe que l'onglet « Signatures numériques » contenant le certificat a bien été ajouté.
7. Enregistrer la version dans le dépôt Git : commit du changement de numéro de version, tag sur ce commit, puis push du commit et du tag, selon la section « Gestion des tags Git » de Proc#145.

On utilise les logiciels :

• 7-Zip
• 7-Zip SFX Maker (le fonctionnement semble meilleur si l'outil est installé dans le dossier de la release)

1. Faire un clic droit sur le fichier généré aux étapes précédentes, puis « 7-Zip\Ajouter à l'archive ».
   
2. Bien vérifier le paramétrage, en particulier :
   • que le niveau de compression est « Ultra » (diminution du temps de chargement) ;
   • que la méthode de compression est LZMA et non LZMA2 (LZMA2 est incompatible avec l'auto-extraction).
3. Créer le fichier logeas.7z.

1. Aller dans le sous-dossier « 7-Zip SFX Maker ».
2. Lancer « 7-ZIP SFX Maker.exe ».
3. « Charger les paramètres » : le fichier est dans le dossier de la release, « Fichier config logeas web 7-Zip SFX Maker.xml ».

<?xml version="1.0"?>
<Settings>
  <General>
    <ExtractMode Path="C:\Program Files (x86)\Logeas Informatique\LoGeAs V9 WEB" AllowEdit="True">Custom</ExtractMode>
    <HideProgress>False</HideProgress>
    <ProgressDisableCancel>False</ProgressDisableCancel>
    <SelfDelete>False</SelfDelete>
    <CompressStub>False</CompressStub>
    <XPStyles>False</XPStyles>
    <HideTitleIcon>False</HideTitleIcon>
    <PromptShowSFXIcon>False</PromptShowSFXIcon>
    <Overwrite>All</Overwrite>
    <MessageBegin Show="False">Démarrer l'extraction</MessageBegin>
    <MessageCancel Show="True">Voulez-vous vraiment annuler ?</MessageCancel>
    <MessageFinish Show="False">Les fichiers ont été extraits avec succès</MessageFinish>
    <TitleText>Installation LoGeAs</TitleText>
    <ExtractPathText>Sélectionnez le dossier d'installation</ExtractPathText>
    <ExtractCancelText>Interrompre</ExtractCancelText>
    <ExtractDialogText />
    <ExtractTitleText>Extraction</ExtractTitleText>
    <ExtractShowIcon>True</ExtractShowIcon>
    <ProgressPercent>0</ProgressPercent>
    <ProgressShowIcon>False</ProgressShowIcon>
    <Icon />
  </General>
  <Tasks>
    <Item Enabled="True">Shortcut="Du,{%%T\\LoGeAs.exe},{},{},{},{},{},{},{}"</Item>
    <Item Enabled="True">Shortcut="Su,{%%T\\Logeas.exe},{},{},{},{},{},{},{}"</Item>
    <Item Enabled="True">RunProgram="nowait:\"%%T\\Logeas.exe\""</Item>
  </Tasks>
  <VersionString>
    <Item Name="Comments" Value="" Enabled="True" />
    <Item Name="CompanyName" Value="Oleg N. Scherbakov" Enabled="True" />
    <Item Name="FileDescription" Value="7z Setup SFX" Enabled="True" />
    <Item Name="FileVersion" Value="1, 2, 0, 715" Enabled="True" />
    <Item Name="InternalName" Value="7zSfxNew" Enabled="True" />
    <Item Name="LegalCopyright" Value="Copyright © 2005-2007 Oleg N. Scherbakov" Enabled="True" />
    <Item Name="LegalTrademarks" Value="" Enabled="True" />
    <Item Name="OriginalFilename" Value="7zSfxNew.exe" Enabled="True" />
    <Item Name="PrivateBuild" Value="July 14, 2007" Enabled="True" />
    <Item Name="ProductName" Value="7ZSfxNew" Enabled="True" />
    <Item Name="ProductVersion" Value="1, 2, 0, 715" Enabled="True" />
    <Item Name="SpecialBuild" Value="" Enabled="True" />
  </VersionString>
</Settings>

1. Par le bouton « + », ajouter le fichier logeas.7z créé à l'étape précédente.
2. Puis « Créer l'auto-extractible SFX ».

Le fichier créé s'appelle LoGeAs.sfx.exe : c'est lui qui est diffusé.

Envoyer la veille un courriel à tous les utilisateurs de LoGeAs Web (liste obtenue par requête SQL), indiquant :

• les modifications faites (liste préparée à l'étape 2) ;
• la date et l'heure de coupure du serveur.

À partir du logiciel, utiliser la fonction interne (mode développeur) de publication sur le wiki : « Édition Configuration > Mettre à jour wiki.logeas.fr ».

Comment déployer ou mettre à jour le serveur PGI « -INST-1-Procédure de MAJ du serveur PGI »