Créer des paquets WAPT¶
Pour plus d’informations sur la structure du packaging, veuillez vous référer à <wapt-package-structure>
Créer son environment de développement de paquets WAPT¶
Pré-requis¶
Attention
Il est impératif d’être en possession d’un compte Administrateur Local de la machine pour cette opération.
Nous vous conseillons de créer / éditer vos paquets dans un environment maîtrisé, sain et jetable.
L’utilisation d’une machine virtuelle autonome (type Virtualbox ou équivalent) est vivement recommandée.
Importer le paquet tis-pyscripter dans votre dépôt local et l’installer sur votre machine de développement.
Préconisations concernant l’environment de test¶
La méthode préconisée pour tester correctement vos paquets est d’utiliser un échantillon de machines représentatif de votre parc. Donc plus votre parc est hétérogène, plus votre échantillon devra être large.
Cette démarche vise à confronter le paquet WAPT à une multitude de plateformes et d’environments afin qu’il devienne le plus abouti possible en régime de test, avant d’être basculé en production.
Démarche de test¶
Systèmes d’exploitation et architectures¶
Windows XP ;
Windows 7 ;
Windows 10 ;
Windows Server 2008 R2 ;
Windows Server 2012 ;
x86 ;
x64 ;
Machine physique et virtuelle ;
ordinateurs portables;
Indication
On testera si possible les versions RC / Beta des OS si elles sont disponibles (exemple : Windows 10 Creators Update).
L’état des mises à jour Windows¶
Un poste Microsoft Windows sans aucune mise à jour Windows Update : l’objectif est de détecter les mises à jour indispensables au bon fonctionnement du logiciel et adapter le paquet en conséquence ;
Un poste Microsoft Windows à jour avec les toutes dernières MàJ Windows Update : l’objectif est de détecter les mise à jour en conflit avec le logiciel et d’adapter le paquet en conséquence ;
Etat des installations des logiciels¶
Un poste avec peu de logiciels déjà installés : l’objectif est de détecter une dépendance possible à Java ou autre framework applicatif ;
Les postes avec beaucoup de logiciels déjà installés : l’objectif est de détecter un conflit avec une application existante;
Installer les anciennes versions du logiciel : il est possible que l’installeur ne supporte pas l’écrasement d’une installation précédente, dans ce cas il faudra prévoir la désinstallation des anciennes versions avant d’installer la nouvelle version ;
Les principes de création d’un paquet WAPT à partir d’un modèle depuis la console¶
Indication
Pour créer des paquets à partir de la console, il faut d’abord avoir installé l’environnement de développement WAPT tis-pyscripter.
Créer un paquet WAPT depuis la console¶
Dans cet exemple, l’installeur de 7zip est utilisé au format MSI.
Créer le modèle de paquet depuis l’installeur.
Dans la console WAPT, cliquer sur
:Sélectionner l’installeur MSI téléchargé et renseigner les différentes informations demandées. Veillez bien à ce que le nom du paquet ne contienne pas de numéro de version.
Deux solutions sont proposées:
Cliquer sur Créer et éditer (recommandée) pour lancer la personnalisation du paquet et l’adapter aux besoin spécifique de votre Organisation.
Cliquer sur Créer et Téléverser pour lancer la création et le chargement direct du paquet sur le serveur WAPT (non recommandé).
Attention
Le bouton Build and upload envoi directement le paquet dans le dépôt privé sans tester l’installation.
Cette méthode fonctionne assez bien avec les MSI car leur installation est standard.
Cependant la deuxième méthode qui consiste à tester localement le paquet d’abord puis à l’uploader est la méthode recommandée.
Personnaliser le paquet avant de le téléverser dans votre dépôt¶
La méthode conseillée avant l”upload d’un paquet est de personnaliser son comportement en l’éditant avec PyScripter.
Lors de la création du modèle de paquet, cliquer sur OK.
L’IDE PyScripter se lance et permet d’éditer les fichiers du paquet.
Présentation de PyScripter¶
L’explorateur de projets PyScripter¶
L’explorateur de projets PyScripter liste les différents fichiers dont vous pouvez avoir besoin, notamment le fichier control
et le fichier setup.py
.
Run Configurations¶
Les options de Run dans l’explorateur de projets de PyScripter vont vous permettre de lancer des actions de votre paquet en cours d’édition.
Zone d’édition¶
La Zone d’édition de PyScripter permet d’éditer le fichier setup.py
ainsi que le fichier control
.
Console Python¶
C’est la console python visible dans PyScripter, elle va vous permettre d’afficher la sortie python lorsque vous exécuterez des commandes run.
Vous pouvez également l’utiliser pour tester / déboguer des portions de votre script setup.py
.
Pour en savoir plus sur la composition d’un paquet wapt, visitez la documentation sur la structure d’un paquet WAPT.
Tester localement l’installation du paquet WAPT¶
Vous pouvez ensuite tester le lancement d’une installation sur votre station de développement.
La Console PyScripter vous permet de vérifier si l’installation s’est bien déroulée.
Tester localement la désinstallation du paquet WAPT¶
Vous pouvez ensuite tester le lancement d’une installation sur votre station de développement.
La Console PyScripter vous permet de vérifier si l’installation s’est bien déroulée.
Packager des .msi (exemple)¶
Pour cet exemple, nous prendrons tightvnc.
Vous pouvez le télécharger ici : https://www.tightvnc.com/download.php
Maintenant, vous pouvez générer votre modèle de paquet, veuillez vous référer à la documentation pour la création de paquets à partir de la console WAPT.
Editer le fichier control
(architecture
, impacted_process
, target_os
, description
, maintainer
…), veuillez vous référer à la structure du fichier documentation du fichier control.
Votre pyscripter s’ouvre, allez dans votre setup.py
# -*- coding: utf-8 -*-
from setuphelpers import *
uninstallkey = []
def install():
print('installing tis-tightvnc')
install_msi_if_needed('tightvnc-2.8.5-setup-64bit.msi')
La fonction testera également si une version du logiciel est déjà installée sur la machine avec la clé de désinstallation.
Si présence il y a, l’installation sera enclenchée uniquement si la version actuellement installée est plus ancienne.
Après installation, la fonction testera finalement la présence de la clé de déinstallation et sa version pour vérifier que tout s’est bien passé.
Options (Option par défaut) |
Description |
---|---|
|
version minimale au dessus de laquelle il mettra à jour. |
|
liste des programmes à tuer avant de lancer l’installation. |
|
codes de retour autres que 0 ou 3010 acceptés en retour par la fonction. |
|
durée d’attente maximale d’installation (en secondes). |
|
propriétés supplémentaires à passer en argument au MSI pour l’installation. |
|
valeur passée en paramètre pour le contrôle de version au lieu de celle retournée par la fonction installed_softwares |
|
supprimme automatiquement une ancienne version d’un logiciel dont la uninstallkey est identique |
|
force l’installation du logiciel même si une uninstall key avec une version identique est trouvée |
Note
La fonction install_msi_if_needed récupère la clé de désinstallation depuis le MSI, il n’est pas nécessaire de l’écrire dans le fichier setup.py
.
Indication
Vous n’avez pas non plus à remplir le champ killbefore
si la valeur indiquée dans le champ impacted_process
du fichier control
est correcte.
Note
Le setup.py
aurait pu ressembler à cela, mais la méthode est moins élégante car elle fait moins de vérifications :
# -*- coding: utf-8 -*- from setuphelpers import * uninstallkey = ["{8B9896FC-B4F2-44CD-8B6E-78A0B1851B59}"] def install(): print('installing tis-tightvnc') run('msiexec /norestart /q /i "tightvnc-2.8.5-setup-64bit.msi"')
Lancez l’installation et voyez ce qui se passe lorsque le logiciel est déjà installé.
wapt-get -ldebug install C:\waptdev\tis-tightvnc-wapt
Installing WAPT file C:\waptdev\tis-tightvnc-wapt
MSI tightvnc-2.8.5-gpl-setup-64bit.msi already installed. Skipping msiexec
Results:
=== install packages ===
C:\waptdev\tis-tightvnc-wapt | tis-tightvnc (2.8.5.0-1)
Ajouter des propriétés supplémentaires en argument¶
Pour ajouter des propriétés supplémentaires on va les stocker dans un élément dict.
# -*- coding: utf-8 -*-
from setuphelpers import *
uninstallkey = []
properties = {
'SERVER_REGISTER_AS_SERVICE':0,
'SERVER_ADD_FIREWALL_EXCEPTION':0,
}
def install():
print(u'Installation en cours de TightVNC')
install_msi_if_needed('tightvnc-2.8.5-setup-64bit.msi', properties = properties )
Note
Le setup.py
aurait pu ressembler à cela, mais la méthode est moins élégante car elle fait moins de vérifications :
# -*- coding: utf-8 -*- from setuphelpers import * uninstallkey = ["{8B9896FC-B4F2-44CD-8B6E-78A0B1851B59}"] def install(): print('installing tis-tightvnc') run('msiexec /norestart /q /i "tightvnc-2.8.5-setup-64bit.msi" SERVER_REGISTER_AS_SERVICE=0 SERVER_ADD_FIREWALL_EXCEPTION=0')
Vidéo de démonstration¶
Packager des .exe (exemple)¶
Télécharger l’installateur .exe à partir d’une source fiable.
Téléchargez l’installateur au format exe Firefox ESR x64 sur https://download.mozilla.org/?product=firefox-esr-latest-ssl&os=win64
Rechercher la documentation associée pour les flags silencieux:
Sur le site de la Fondation Mozilla .
Autres méthodes pour récupérer le flag silencieux.
Dépôt de paquets WPKG .
Dépôt de paquets Chocolatey <https://chocolatey.org/packages/FirefoxESR>`_ .
Recherche Internet avec le terme Firefox silent install.
Puis générer votre modèle de paquet, veuillez vous référer à la documentation pour la création de paquets à partir de la console WAPT. PyScripter se charge et ouvre le projet de paquet .exe.
Editer le fichier
control
(architecture
,impacted_process
,target_os
,description
,maintainer
…), veuillez vous référer à la structure du fichier documentation du fichier control.Vérifier le contenu du fichier
control
. Mozilla Firefox-ESR ne répond pas aux standards et retourne un numéro de version erroné (il s’agit du numéro de version du logiciel qui créé l’installeur).Fichier
control
d’origine.package : tis-firefox-esr version : 4.42.0.0-0 architecture : all section : base priority : optional maintainer : user description : automatic package for firefox setup 52.6.0esr impacted_process :
Fichier
control
modifié :package : tis-firefox-esr version : 52.6.0-1 architecture : all section : base priority : optional maintainer : Tranquil-IT Systems description : Mozilla Firefox 52.6.0 ESR impacted_process : firefox.exe
Note
Il est à noter qu’une sous-version -1 a été ajoutée au numéro de version du logiciel ; il s’agit de la version de packaging du paquet WAPT.
Il permet au développeur de paquets de publier plusieurs versions de paquets WAPT d’un même logiciel, ce qui est très utile pour un développement très rapide et itératif.
Utiliser install_exe_if_needed
La fonction est sensiblement la même que celle utilisée pour les installeurs .msi, avec quelques différences :
La fonction nécessite l’ajout des flags silencieux en paramètre.
La fonction nécessite l’ajout de la clé de désinstallation en paramètre.
# -*- coding: utf-8 -*-
from setuphelpers import *
uninstallkey = []
def install():
print('installing tis-firefox-esr')
install_exe_if_needed("Firefox Setup 45.5.0esr.exe",silentflags="-ms",key='',min_version="4.42.0.0")
Options (Option par défaut) |
Description |
---|---|
|
Paramètres silencieux à passer en argument à l’installeur. |
|
Clé de désinstallation du programme. |
|
version minimale au dessus de laquelle il mettra à jour. |
|
liste des programmes à tuer avant de lancer l’installation. |
|
codes de retour autres que 0 ou 3010 acceptés en retour par la fonction. |
|
durée d’attente maximale d’installation (en secondes). |
|
valeur passée en paramètre pour le contrôle de version au lieu de celle retournée par la fonction installed_softwares |
|
supprimme automatiquement une ancienne version d’un logiciel dont la uninstallkey est identique |
|
force l’installation du logiciel même si une uninstall key avec une version identique est trouvée |
Le paquet aura alors ce comportement :
Le logiciel Firefox s’installera uniquement si le logiciel n’est pas installé et si la version est strictement inférieure à 45.5.0, sauf si l’option
--force
est indiquée lors de l’installation du paquet.A l’installation, les processus firefox.exe en cours d’exécution seront tués (avec la valeur indiquée dans
impacted_process
du fichiercontrol
).La fonction ajoutera elle-même la clé de désinstallation, donc laisser l’argument uninstallkey vide.
A la fin de l’installation, la fonction ira vérifier si l”uninstallkey est bien présente sur le poste et si la version est bien égale ou supérieure à 45.5.0, si ce n’est pas le cas, elle basculera le paquet en ERROR.
Trouver la clé de désinstallation¶
Contrairement aux fichiers .msi, la clé pour désinstaller un .exe n’est pas dans les propriétés du fichier.
Vous devez donc d’abord installer le logiciel pour connaître la clé de désinstallation.
Vous devez donc démarrer une fois l’installation à partir de pyscripter avec le run configuration et ensuite install.
Une fois le logiciel installé, allez à la console WAPT, puis trouvez votre machine de développement.
Dans l’onglet inventaire des logiciels, trouvez votre logiciel et copiez la valeur indiquée dans la colonne clé de désinstallation.
Vous devez également vérifier la valeur de la version avec la valeur indiquée dans min_version
dans votre setup.py
.
Modifier votre fichier setup.py
avec les nouveaux paramètres :
# -*- coding: utf-8 -*-
from setuphelpers import *
uninstallkey = []
def install():
print('installing tis-firefox-esr')
install_exe_if_needed("Firefox Setup 45.5.0esr.exe",silentflags="-ms",key='Mozilla Firefox 45.5.0 ESR (x64 fr)',min_version="45.5.0")
Pour tester que votre clé fonctionne correctement, vous devez relancer une installation dans pyscripter.
WAPT ne tentera pas d’installer le logiciel car il est déjà présent, le message suivant devrait donc s’afficher :
>>>
*** Remote Interpreter Reinitialized ***
Command Line : install "c:\waptdev\tis-firefox-esr_x64_PROD_fr-wapt\WAPT\.."
Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
Installing WAPT files c:\waptdev\tis-firefox-esr_x64_PROD_fr-wapt
Exe setup Firefox_Setup_78.7.1esr.exe already installed. Skipping
Results:
=== install packages ===
c:\waptdev\tis-firefox-esr_x64_PROD_fr-wapt | tis-firefox-esr (78.7.1-102)
Vous pouvez maintenant tester la désinstallation :
Vous pouvez maintenant construire et envoyer votre paquet, veuillez vous référer à la documentation pour construire et envoyer des paquets depuis la console WAPT.
Note
Si vous laissez la clé de désinstallation vide, la désinstallation de votre paquet ne fonctionnera pas.
Cas particulier d’un dé-installeur non-silencieux¶
Dans certains cas particuliers, un paquet utilisant install_exe_if_needed remplit la clé de désinstallation, mais la clé de désinstallation pointe vers un désinstalleur non silencieux.
Il nous faut contourner le problème en utilisant une fonction qui va supprimer la clé de désinstallation à la fin de l’installation.
:emphasize-lines: 13
# -*- coding: utf-8 -*-
from setuphelpers import *
uninstallkey = []
def install():
install_exe_if_needed("setup.exe",
silentflags="/s",
key='{D9E87643-0005-447E-9111-78697A9C1595}',
min_version="14.0")
uninstallkey.remove('{D9E87643-0005-447E-9111-78697A9C1595')
def uninstall():
run(r'"C:\Program Files\Kutl\uninstall.exe" /supersilent')
Indication
La fonction de désinstallation peut également être utilisée pour exécuter du code en plus de la désinstallation de logiciels, ex : supprimer un dossier, supprimer un raccourci …
Vidéo de démonstration¶
Packager des paquets linux simples¶
Construire le paquet et l’envoyer au serveur WAPT¶
Une fois que le paquet est prêt, le construire et l’envoyer au serveur WAPT, dans la console WAPT.
Sélectionner le paquet dans le dossier
c:\waptdev
.
Confirmer le paquet sélectionné.
Vous venez de charger votre premier paquet wapt.
Avertissement
Une fois que votre paquet est téléversé, rafraîchissez la liste des paquets en utilisant le bouton Actualiser les paquets disponibles ou en appuyant sur la touche F5 de votre clavier.
Travailler avec des codes de retour non standard¶
Les codes de retour sont utilisés pour indiquer si un logiciel a été correctement installé.
Avec Windows, le code standard de retour pour une installation réussie est [0].
Si vous savez que vos paquets WAPT s’installent correctement, mais que vous obtenez quand même un code de retour différent de [0], alors vous pouvez explicitement dire à WAPT d’ignorer le code d’erreur en utilisant le paramètre accept_returncodes
.
Vous pouvez découvrir comment utiliser le paramètre accept_returncodes
en explorant le code de ce paquet.
# -*- coding: utf-8 -*-
from setuphelpers import *
import re
uninstallkey = []
def is_kb_installed(hotfixid):
installed_update = installed_windows_updates()
if [kb for kb in installed_update if kb['HotFixID' ].upper() == hotfixid.upper()]:
return True
return False
def waiting_for_reboot():
# Query WUAU from the registry
if reg_key_exists(HKEY_LOCAL_MACHINE,r"SOFTWARE\Microsoft\Windows\CurrentVersion\WindowsUpdate\Auto Update\RebootRequired") or \
reg_key_exists(HKEY_LOCAL_MACHINE,r"SOFTWARE\Microsoft\Windows\CurrentVersion\Component Based Servicing\RebootPending") or \
reg_key_exists(HKEY_LOCAL_MACHINE,r'SOFTWARE\Microsoft\Updates\UpdateExeVolatile'):
return True
return False
def install():
kb_files = [
'windows10.0-kb4522355-x64_af588d16a8fbb572b70c3b3bb34edee42d6a460b.msu',
]
with EnsureWUAUServRunning():
for kb_file in kb_files:
kb_guess = re.findall(r'^.*-(KB.*)-',kb_file)
if not kb_guess or not is_kb_installed(kb_guess[0]):
print('Installing {}'.format(kb_file))
run('wusa.exe "{}" /quiet /norestart'.format(kb_file),accept_returncodes=[0,3010,2359302,-2145124329],timeout=3600)
else:
print('{} already installed'.format(kb_file))
if waiting_for_reboot():
print('A reboot is needed!')
Indication
La liste complète des messages d’erreur de l’installeur Windows peut être consultée sur cette page <https://docs.microsoft.com/en-us/windows/win32/msi/windows-installer-error-messages>`_.
Exemples simples de fonctions du setuphelper couramment utilisées¶
Nous présentons ici quelques fonctions implémentées dans Setuphelpers et fréquemment utilisées pour développer des paquets WAPT.
Tests et manipulation de dossiers et fichiers¶
Créer un chemin avec récursion¶
… fabrique la variable pour le chemin C:\Program Files (x86)\Mozilla\Firefox
.
makepath(programfiles,'Mozilla','Firefox')
Indication
Pour plus d’informations ou pour connaître les paramètres complémentaires de la commande, consultez la documentation de référence (en anglais) en visitant :
https://www.wapt.fr/en/api-doc-1.5/source/setuphelpers.html?highlight=makepath#setuphelpers.makepath
Créer et supprimer des raccourcis¶
… crée le répertoire C:\test
.
mkdirs('C:\\test')
Indication
Pour plus d’informations ou pour connaître les paramètres complémentaires de la commande, consultez la documentation de référence (en anglais) en visitant :
https://www.wapt.fr/en/api-doc-1.5/source/setuphelpers.html?highlight=mkdirs#setuphelpers.mkdirs
… détruit le répertoire C:\tmp\target
.
remove_tree(r'C:\tmp\target')
Indication
Pour plus d’informations ou pour connaître les paramètres complémentaires de la commande, consultez la documentation de référence (en anglais) en visitant :
Vérifier si un chemin est un fichier ou un dossier¶
… vérifie que C:\Program Files (x86)\software
est un répertoire.
isdir(makepath(programfiles32,'software')):
print('The directory exists')
Indication
Pour plus d’informations ou pour connaître les paramètres complémentaires de la commande, consultez la documentation de référence (en anglais) en visitant :
https://www.wapt.fr/en/api-doc-1.5/source/setuphelpers.html?highlight=isdir#setuphelpers.isdir
… vérifie que C:\Program Files (x86)\software\file
est un fichier.
isfile(makepath(programfiles32,'software','file')):
print('file exist')
Indication
Pour plus d’informations ou pour connaître les paramètres complémentaires de la commande, consultez la documentation de référence (en anglais) en visitant :
https://www.wapt.fr/en/api-doc-1.5/source/setuphelpers.html?highlight=isfile#setuphelpers.isfile
Vérifier si un répertoire est vide¶
… vérifie que le répertoire C:\Program Files (x86)\software
est vide.
dir_is_empty(makepath(programfiles32,'software')):
print('dir is empty')
Indication
Pour plus d’informations ou pour connaître les paramètres complémentaires de la commande, consultez la documentation de référence (en anglais) en visitant :
Copier un fichier¶
… copie le fichier file.txt
dans le répertoire C:\Program Files (x86)\software
.
filecopyto('file.txt',makepath(programfiles32,'software'))
Indication
Pour plus d’informations ou pour connaître les paramètres complémentaires de la commande, consultez la documentation de référence (en anglais) en visitant :
Copier un dossier¶
… copie le dossier sources
dans le répertoire C:\projet
.
copytree2('sources','C:\\projet')
Indication
Pour plus d’informations ou pour connaître les paramètres complémentaires de la commande, consultez la documentation de référence (en anglais) en visitant :
Récupérer la version d’un fichier¶
La commande get_file_properties …
get_file_properties(makepath(programfiles32,'InfraRecorder','infrarecorder.exe'))['ProductVersion']
Indication
Pour plus d’informations ou pour connaître les paramètres complémentaires de la commande, consultez la documentation de référence (en anglais) en visitant :
Manipulation de clés de registre¶
Vérifier l’existence d’une clé de registre¶
La commande registry_readstring vérifie si la clé de registre {8A69D345-D564-463c-AFF1-A69D9E530F96} existe dans le chemin de registre SOFTWARE\Google\Update\Clients
de HKEY_LOCAL_MACHINE.
if registry_readstring(HKEY_LOCAL_MACHINE, "SOFTWARE\\Google\\Update\\Clients\\{8A69D345-D564-463c-AFF1-A69D9E530F96}", 'pv'):
print('key exist')
Indication
Pour plus d’informations ou pour connaître les paramètres complémentaires de la commande, consultez la documentation de référence (en anglais) en visitant :
Afficher la valeur d’une clé de registre¶
La commande registry_readstring lit la valeur {8A69D345-D564-463c-AFF1-A69D9E530F96} stockée dans le chemin de registre SOFTWARE\Google\Update\Clients
de HKEY_LOCAL_MACHINE.
print(registry_readstring(HKEY_LOCAL_MACHINE, r'SOFTWARE\Google\Update\Clients\{8A69D345-D564-463c-AFF1-A69D9E530F96}', 'pv'))
Indication
Pour plus d’informations ou pour connaître les paramètres complémentaires de la commande, consultez la documentation de référence (en anglais) en visitant :
Modifier la valeur d’une clé de registre¶
La commande registry_setstring modifie la valeur de la clé de registre TOUVersion stockée dans le chemin de registre SOFTWARE\Microsoft\Windows Live
de HKEY_CURRENT_USER.
registry_setstring(HKEY_CURRENT_USER, "SOFTWARE\\Microsoft\\Windows Live\\Common",'TOUVersion','16.0.0.0', type=REG_SZ)
Indication
Pour plus d’informations ou pour connaître les paramètres complémentaires de la commande, consultez la documentation de référence (en anglais) en visitant :
Créer et supprimer des raccourcis¶
Avec WAPT setuphelper, il est possible de créer différents types de raccourcis.
Créer et supprimer des raccourcis¶
créer un raccourci personnalisé sur le bureau de l’utilisateur en cours¶
La commande create_desktop_shortcut crée le raccourci Gestion de la console WAPT dans le répertoire C:\Users\Public
pointant sur C:\Program Files (x86)\wapt\waptconsole.exe
; le raccourci est disponible pour tous les utilisateurs.
create_desktop_shortcut(r'WAPT Console Management',target=r'C:\Program Files (x86)\wapt\waptconsole.exe')
Indication
Pour plus d’informations ou pour connaître les paramètres complémentaires de la commande, consultez la documentation de référence (en anglais) en visitant :
supprimer des raccourcis¶
La commande remove_desktop_shortcut supprime le raccourci WAPT Console Management du dossier C:\Users\Public
; le raccourci est supprimé pour tous les utilisateurs.
remove_desktop_shortcut('WAPT Console Management')
Indication
Pour plus d’informations ou pour connaître les paramètres complémentaires de la commande, consultez la documentation de référence (en anglais) en visitant :
Firefox place un raccourci sur le bureau de tous les utilisateurs, nous allons le supprimer.
Nous utiliserons la fonction remove_desktop_shortcut
:
Modifier le
setup.py
et utiliser la fonction comme ceci.# -*- coding: utf-8 -*- from *SetupHelpers* import * uninstallkey = [] def install(): install_exe_if_needed("Firefox Setup 45.5.0esr.exe",silentflags="-ms",key='Mozilla Firefox 45.5.0 ESR (x64 fr)',min_version="45.5.0") remove_desktop_shortcut('Firefox')
Si vous redémarrez l’installation à partir de pyscripter, vous remarquerez que le raccourci de bureau « all users » a disparu.
Créer un raccourci personnalisé sur le bureau de l’utilisateur en cours¶
créer un raccourci personnalisé sur le bureau de l’utilisateur en cours¶
Indication
Ces fonctions sont utilisées avec le session_setup.
La commande create_user_desktop_shortcut crée le raccourci WAPT Console Management sur le bureau de l’utilisateur en pointant sur C:\Program Files (x86)\wapt\waptconsole.exe
.
create_user_desktop_shortcut(r'WAPT Console Management',target=r'C:\Program Files (x86)\wapt\waptconsole.exe')
Indication
Pour plus d’informations ou pour connaître les paramètres complémentaires de la commande, consultez la documentation de référence (en anglais) en visitant :
supprimer un raccourci personnalisé sur le bureau de l’utilisateur en cours¶
La commande remove_user_desktop_shortcut supprime le raccourci WAPT Console Management du bureau de l’utilisateur connecté.
remove_user_desktop_shortcut('WAPT Console Management')
Indication
Pour plus d’informations ou pour connaître les paramètres complémentaires de la commande, consultez la documentation de référence (en anglais) en visitant :
Environnement Windows / Logiciel / Services¶
Vérifier la version de Windows¶
La commande windows_version vérifie que la version de Windows est strictement inférieure à 6.2.0.
windows_version()<Version('6.2.0'):
Indication
Pour plus d’informations ou pour connaître les paramètres complémentaires de la commande, consultez la documentation de référence (en anglais) en visitant :
Visitez également le site sur les numéros de version de Windows.
Vérifier si l’architecture est en 64bits¶
… vérifie que le processeur de la machine est 64bits.
if iswin64():
print('Pc x64')
else:
print('Pc not x64')
Indication
Pour plus d’informations ou pour connaître les paramètres complémentaires de la commande, consultez la documentation de référence (en anglais) en visitant :
https://www.wapt.fr/en/api-doc-1.5/source/setuphelpers.html?highlight=iswin64#setuphelpers.iswin64
La variable Program Files¶
vim ;
print(programfiles())
vim ;
print(programfiles32())
vim ;
print(programfiles64())
Renvoie les différentes localisations de Program Files
Par exemple, la commande programfiles64 renvoie le répertoire natif de Program Files, par exemple C:\Program Files (x86)
sur l’architecture win64 ou win32 et programfiles() renverra le chemin du répertoire Program Files 32bit, par exemple. Programs Files (x86)
sur une architecture win64, et Programs Files
sur une architecture win32.
La variable AppData¶
user_appdata / user_local_appdata
Indication
Ces fonctions sont utilisées avec le session_setup
… renvoie le profil appdata itinérant de l’utilisateur courant (C:\Users\%username%\AppData\Roaming
).
print(user_appdata())
Indication
Pour plus d’informations ou pour connaître les paramètres complémentaires de la commande, consultez la documentation de référence (en anglais) en visitant :
… renvoie le profil appdata local de l’utilisateur courant (C:\Users\%username%\AppData\Local
).
print(user_local_appdata())
Indication
Pour plus d’informations ou pour connaître les paramètres complémentaires de la commande, consultez la documentation de référence (en anglais) en visitant :
Désactiver temporairement le redirecteur wow3264¶
La commande disable_file_system_redirection …
with disable_file_system_redirection():
filecopyto('file.txt',system32())
Indication
Pour plus d’informations ou pour connaître les paramètres complémentaires de la commande, consultez la documentation de référence (en anglais) en visitant :
Récupérer l’utilisateur courant¶
… affiche l’identifiant de l’utilisateur connecté
print(get_current_user())
Indication
Pour plus d’informations ou pour connaître les paramètres complémentaires de la commande, consultez la documentation de référence (en anglais) en visitant :
Récupérer le nom de l’ordinateur¶
La commande get_computername …
print(get_computername())
Indication
Pour plus d’informations ou pour connaître les paramètres complémentaires de la commande, consultez la documentation de référence (en anglais) en visitant :
Récupérer le nom de domaine¶
… renvoie le nom de la machine avec le domaine.
get_domain_fromregistry()
Indication
Pour plus d’informations ou pour connaître les paramètres complémentaires de la commande, consultez la documentation de référence (en anglais) en visitant :
Les actions sur les logiciels installés¶
Vérifier les logiciels installés¶
… renvoie la liste des logiciels inscrits dans la base de registre machine sous forme de tableau.
installed_softwares('winscp')
[{'install_location': u'C:\\Program Files\\WinSCP\\', 'version': u'5.9.2', 'name': u'WinSCP 5.9.2', 'key': u'winscp3_is1', 'uninstall_string': u'"C:\\Program Files\\WinSCP\\unins000.exe"', 'publisher': u'Martin Prikryl', 'install_date': u'20161102', 'system_component': 0}]
Indication
Pour plus d’informations ou pour connaître les paramètres complémentaires de la commande, consultez la documentation de référence (en anglais) en visitant :
Récupérer la commande de désinstallation avec le registre¶
… renvoie la commande de désinstallation silencieuse.
uninstall_cmd('winscp3_is1')
"C:\Program Files\WinSCP\unins000.exe" /SILENT
Indication
Pour plus d’informations ou pour connaître les paramètres complémentaires de la commande, consultez la documentation de référence (en anglais) en visitant :
Désinstaller des logiciels¶
for soft in installed_softwares('winscp3'):
if Version(soft['version']) < Version('5.0.2'):
run(WAPT.uninstall_cmd(soft['key']))
Pour chaque élément de la liste renvoyée par installed_softwares contenant le mot-clé winscp.
Si la version dans la liste est plus petite que 5.0.2.
Alors lancer la désinstallation avec uninstall_cmd et en indiquant la uninstallkey.
Indication
Pour plus d’informations ou pour connaître les paramètres complémentaires de la commande, consultez la documentation de référence (en anglais) en visitant :
Tuer des tâches¶
La commande killalltasks tue toutes les tâches portant le nom spécifié.
killalltasks('firefox')
Indication
Pour plus d’informations ou pour connaître les paramètres complémentaires de la commande, consultez la documentation de référence (en anglais) en visitant :
Utiliser les champs du fichier control¶
Il est possible d’utiliser les informatoins du fichier control dans le setup.py
Récupérer la version du paquet¶
def setup():
print(control['version'])
… affiche le champ version
du fichier control
du paquet WAPT.
def setup():
print(control['version'].split('-',1)[0])
… affiche le numéro de version du fichier control
sans le numéro de version de packaging WAPT.
Récupérer le nom du logiciel¶
À faire
documentation à venir
Gérer un paquet WAPT avec un autre paquet WAPT¶
Installer un paquet¶
La commande install …
WAPT.install('tis-scratch')
… installe tis-scratch sur la machine.
Supprimer un paquet¶
La commande remove …
WAPT.remove('tis-scratch')
… désinstalle tis-scratch de la machine.
Créer des paquets WAPT¶
La commande forget_packages …
WAPT.forget_packages('tis-scratch')
… informe WAPT de ne plus suivre le paquet tis-scratch ; WAPT ne connaîtra plus l’existence de ce paquet.
Indication
Si vous voulez supprimer tis-scratch, il faudra soit réinstaller le paquet (wapt-get install "tis-scratch"), puis le supprimer (wapt-get remove "tis-scratch"), ou bien le supprimer manuellement à partir du panneau de configuration Windows
.Améliorer mon paquet¶
Copier un fichier¶
Il est possible de configurer Firefox avec un fichier policies.json
. Voir https://github.com/mozilla/policy-templates/blob/master/README.md.
Ce fichier doit être placé dans le dossier distribution
à la racine de Firefox.
Pour vous aider à créer ce fichier policies.json
, vous pouvez utiliser cette extension : https://addons.mozilla.org/fr/firefox/addon/enterprise-policy-generator/.
Lorsque vous avez généré votre fichier policies.json
, placez-le dans c:\waptdev\prefix-firefox-esr-wapt\policies.json
.
Le dossier distribution
à la racine de Firefox peut ne pas exister, nous allons donc tester son existence et le créer avec la commande mkdirs si il n’existe pas :
if not isdir(r'C:\Program Files\Mozilla Firefox\distribution'):
mkdirs(r'C:\Program Files\Mozilla Firefox\distribution')
Important
Si vous avez des backslashes sur votre chemin, vous devez toujours mettre un r devant la chaîne, comme dans l’exemple précédent.
Vous devrez également utiliser la fonction filecopyto
pour copier le fichier policies.json
:
filecopyto('policies.json',r'C:\Program Files\Mozilla Firefox\distribution')
Indication
Il n’est pas nécessaire de mettre le chemin complet du fichier source puisque le fichier policies.json
est à la racine du paquet WAPT, donc nous utilisons le chemin relatif.
Modifier le setup.py
:
# -*- coding: utf-8 -*-
from setuphelpers import *
uninstallkey = []
def install():
install_exe_if_needed("Firefox Setup 45.5.0esr.exe",silentflags="-ms",key='Mozilla Firefox 45.5.0 ESR (x64 fr)',min_version="45.5.0")
remove_desktop_shortcut('Firefox')
if not isdir(r'C:\Program Files\Mozilla Firefox\distribution'):
mkdirs(r'C:\Program Files\Mozilla Firefox\distribution')
filecopyto('policies.json',r'C:\Program Files\Mozilla Firefox\distribution')
Votre paquet est maintenant prêt à appliquer une configuration. Vous pouvez lancer une installation avec pyscripter et valider que le paquet fonctionne selon votre objectif.
Enfin, lancer votre Firefox pour vérifier qu’il fonctionnera pour vos utilisateurs.
Désinstaller des versions non désirées¶
Indication
À chaque étape de ces exemples, vous pouvez lancer une installation pour tester le résultat.
Dans notre cas, nous voulons désinstaller la version non ESR de Firefox.
Nous chercherons les autres logiciels installés sur la machine pour vérifier si une version non-esr de Firefox est installée.
Pour reproduire notre exemple, téléchargez et installez la version grand public ici : https://download.mozilla.org/?product=firefox-latest-ssl&os=win :
Pour rechercher une version non désirée de Firefox, nous utiliserons la fonction
installed_softwares
. Cette fonction renvoie un dictionnaire contenant les propriétés du logiciel:print(installed_softwares('Firefox')) [ { 'install_date': '', 'install_location': 'C:\\Program Files\\Mozilla Firefox', 'key': 'Mozilla Firefox 78.7.1 ESR (x64 fr)', 'name': 'Mozilla Firefox 78.7.1 ESR (x64 fr)', 'publisher': 'Mozilla', 'system_component': 0, 'uninstall_string': '"C:\\Program Files\\Mozilla Firefox\\uninstall\\helper.exe"', 'version': '78.7.1', 'win64': True }, { 'install_date': '', 'install_location': 'C:\Program Files (x86)\\Mozilla Firefox', 'key': 'Mozilla Firefox 79.0 (x86 fr)', 'name': 'Mozilla Firefox 79.0 (x86 fr)', 'publisher': 'Mozilla', 'system_component': 0, 'uninstall_string': '"C:\Program Files (x86)\\Mozilla Firefox\\uninstall\\helper.exe"', 'version': '79.0', 'win64': False } ]
Vérifier le nom de chaque logiciel.
for uninstall in installed_softwares('Mozilla Firefox'): print(uninstall['name'])
Afficher le nom de chaque logiciel trouvé.
for uninstall in installed_softwares('Mozilla Firefox'): if not 'ESR' in uninstall['name'] print(uninstall['name'])
Afficher le nom de chaque logiciel trouvé qui n’inclut pas la chaîne ESR dans son nom et sa clé de désinstallation.
for uninstall in installed_softwares('Mozilla Firefox'): if not 'ESR' in uninstall['name'] print(uninstall['name']) print('Uninstall ' + uninstall['key'])
Nous allons maintenant utiliser une astuce WAPT en utilisant la fonction uninstall_cmd
:
Install cmd accepte une clé de désinstallation comme argument et enverra la commande à exécuter pour lancer la désinstallation silencieuse.
for uninstall in installed_softwares('Mozilla Firefox'): if not 'ESR' in uninstall['name']: print(uninstall['name']) print('Uninstall ' + uninstall['key']) silent_uninstall = uninstall_cmd(uninstall['key']) print('Run ' + silent_uninstall)
Commencer la désinstallation.
for uninstall in installed_softwares('Mozilla Firefox'): if not 'ESR' in uninstall['name']: print(uninstall['name']) print('Uninstall ' + uninstall['key']) silent_uninstall = uninstall_cmd(uninstall['key']) print('Run ' + silent_uninstall) run(silent_uninstall)
Nous pouvons également désinstaller le service de maintenance de mozilla:
for uninstall in installed_softwares('MozillaMaintenanceService'):
run(uninstall_cmd(uninstall['key']))
Enfin, modifier votre
setup.py
:# -*- coding: utf-8 -*- from setuphelpers import * uninstallkey = [] def install(): #Install firefox if necessary install_exe_if_needed("Firefox Setup 45.5.0esr.exe",silentflags="-ms",key='Mozilla Firefox 45.5.0 ESR (x64 fr)',min_version="45.5.0") #Removal of the firefox shortcut on the all user desktop remove_desktop_shortcut('Firefox') #Creation of the distribution folder if it does not exist if not isdir(r'C:\Program Files\Mozilla Firefox\distribution'): mkdirs(r'C:\Program Files\Mozilla Firefox\distribution') #Copy of the policies.json file found at the root of the package in the destination of the distribution folder filecopyto('policies.json',r'C:\Program Files\Mozilla Firefox\distribution') #For each Mozilla Firefox installed for uninstall in installed_softwares('Mozilla Firefox'): #If the software does not have the word ESR in the name if not 'ESR' in uninstall['name']: print(uninstall['name']) print('Uninstall ' + uninstall['key']) #Looking for how we can uninstall it silently silent_uninstall = uninstall_cmd(uninstall['key']) print('Run ' + silent_uninstall) #We launch the previous command. run(silent_uninstall) #Uninstalling mozilla maintenance service for uninstall in installed_softwares('MozillaMaintenanceService'): run(uninstall_cmd(uninstall['key']))
Votre code gère maintenant la désinstallation des versions non désirées de Firefox.
Améliorer setup.py pour utiliser des variables¶
Exemples d’utilisation de variables :
version_firefox = "45.0"
uninstallkey = "Mozilla Firefox " + version_firefox + " ESR (x64 fr)"
print(uninstallkey)
uninstallkey = "Mozilla Firefox %s ESR (x64 fr)" % (version_firefox)
print(uninstallkey)
uninstallkey = "Mozilla Firefox {} ESR (x64 fr)".format(version_firefox)
print(uninstallkey)
uninstallkey = f"Mozilla Firefox {version_firefox} ESR (x64 fr)"
print(uninstallkey)
Important
Le dernier exemple est le meilleur mais cette opération ne fonctionne qu’avec Python3.
Nous pouvons maintenant utiliser des variables dans notre fichier setup.py
:
# -*- coding: utf-8 -*- from setuphelpers import * uninstallkey = [] def install(): version_firefox = "45.5.0" #Install firefox if necessary install_exe_if_needed("Firefox Setup %sesr.exe" % version_firefox,silentflags="-ms",key='Mozilla Firefox %s ESR (x64 fr)' % version_firefox,min_version=version_firefox) #Removal of the firefox shortcut on the all user desktop remove_desktop_shortcut('Firefox') distribution_folder=r'C:\Program Files\Mozilla Firefox\distribution' #Creation of the distribution folder if it does not exist if not isdir(distribution_folder): mkdirs(distribution_folder) ... The rest of the code does not change ...
Indication
Vous pouvez récupérer le numéro de version indiqué dans le fichier control
comme ceci :
version_firefox = control.get_software_version()
Personnaliser le contexte utilisateur¶
Il est parfois nécessaire de personnaliser un programme ou un logiciel en contexte utilisateur pour rendre le logiciel immédiatement exploitable par l’utilisateur dans le contexte spécifique de son entreprise ou du service au sein de son entreprise :
Créer des raccourcis sur le bureau utilisateur avec des arguments spécifiques.
Modifier de clés registres utilisateurs.
Modifier des fichiers, une configuration de navigateur.
Configurer des raccourcis réseaux aux modèles de documents de l’entreprise pour assurer la conformité des documents aux chartes éditoriales en vigueur.
Paramétrer la messagerie instantannée ou le mail de l’utilisateur à partir d’un référentiel externe (annuaire, base de données, etc) .
Paramétrer un logiciel bureautique ou métier à partir d’un référentiel externe (annuaire, base de données, etc).
La fonction session_setup bénéficie de toute la puissance et de l’étendue des librairies python pour atteindre un niveau d’automatisation élevé.
Les principes du session_setup¶
La fonction WAPT : command:session_setup est exécutée pour chaque utilisateur utilisant cette commande:
C:\Program Files (x86)\wapt\wapt-get.exe session-setup ALL
L’appel à cette fonction permet d’exécuter la partie session_setup de chaque paquet WAPT logiciel installé sur la machine.
WAPT enregistre en base locale les instructions de tous les paquets dans le fichier C:\Program Files (x86)\wapt\waptdb.sqlite
.
Attention
Le session_setup de chaque paquet n’est exécuté qu”une seule fois par paquet ou version de paquet et par profil utilisateur.
L’agent WAPT stocke dans la base de données locale %appdata%\wapt\waptsession.sqlite
les instances de session_setup qui ont déjà été jouées.
Exemple de sortie de la commande wapt-get session-setup ALL
:
Note
le session_setup
de l’utilisateur connecté, avait déjà été exécuté.
wapt-get session-setup ALL
Configuring tis-7zip ... No session-setup. Done
Configuring tis-ccleaner ... Already installed. Done
Configuring tis-vlc ... No session-setup. Done
Configuring tis-tightvnc ... No session-setup. Done
Configuring tis-paint.net ... No session-setup. Done
Configuring wsuser01.mydomain.lan ... No session-setup. Done
Utiliser le session-setup¶
Les scripts session_setup
sont situés dans la section def session_setup() du fichier setup.py
:
Exemple :
def session_setup():
registry_setstring(HKEY_CURRENT_USER, "SOFTWARE\\Microsoft\\Windows Live\\Common",'TOUVersion','16.0.0.0', type=REG_SZ)
Attention
Avec session_setup, il n’est pas possible de faire appel à des fichiers contenus dans le paquet.
Pour appeler des fichiers externes lors de la désinstallation, copier et coller les fichiers nécessaires dans un dossier externe pendant le processus d’installation du paquet (exemple : c:cachefile
).
Exemple : Créer un raccourci personnalisé sur le bureau¶
Une des possibilités offertes par Setuphelpers est la création de raccourcis individuels sur le bureau utilisateur, à la différence du bureau « Public » commun à tous les utilisateurs.
Nous utiliserons pour ça la fonction create_user_desktop_shortcut()
pour créer un raccourci contenant le nom de l’utilisateur et qui passera en argument à Firefox le site https://tranquil.it par exemple.
# -*- coding: utf-8 -*-
from setuphelpers import *
uninstallkey = []
def install():
install_exe_if_needed("Firefox Setup 45.5.0esr.exe",silentflags="-ms",key='Mozilla Firefox 45.4.0 ESR (x64 fr)',min_version="45.5.0")
def session_setup():
create_user_desktop_shortcut("Mozilla Firefox de %s" % get_current_user(),r'C:\Program Files\Mozilla Firefox\firefox.exe',arguments="-url https://tranquil.it")
Maintenant, lancer le
session-setup
directement à partir de pyscripter.Enfin, vérifier que l’icône est bien présente sur le bureau.
Utiliser les fonctions d’audit pour la conformité¶
Note
Cette fonctionnalité est disponible dans la version Entreprise.
L’audit permet d’effectuer des vérifications régulières sur les configurations des postes et de centraliser le résultat des vérifications dans la console WAPT. Ceci permet de vérifier que votre parc est conforme à votre référentiel sur la durée.
Vous pouvez par exemple :
Vérifier régulièrement la liste des administrateurs locaux des postes.
Vérifier régulièrement la bonne configuration d’un logiciel critique.
Vérifier régulièrement la présence de la bonne version d’un logiciel.
Vérifier régulièrement les configurations de sécurité d’un poste.
La fonction audit bénéficie de toute la puissance et de l’étendue des librairies python pour atteindre une précision d’audit élevée.
Principe de fonctionnement¶
Les tâches d”audit s’exécutent après un upgrade puis à intervalle régulier défini par la valeur de audit_schedule
.
Pour executer manuellement un audit vous pouvez également exécuter la commande :
wapt-get audit
Note
Par défaut, la fonction audit
ne sera pas lancée si l’audit n’est pas nécessaire.
Pour forcer l’exécution vous pouvez exécuter la commande :
wapt-get audit -f
On définit la partie audit dans le fichier setup.py
du paquet dans une fonction def audit() :
Dans cet exemple, nous améliorons le paquet firefox précédemment étudié dans cette documentation.
Ajouter la fonction
audit
dans le fichiersetup.py
.def audit(): if isfile(r'C:\Program Files\Mozilla Firefox\distribution\policies.json'): print('File policies.json found') return "OK" else: print('File policies.json not found') return "ERROR"
Lancer l’audit à partir de pyscripter.
Tester avec le fichier puis supprimer le fichier
C:\Program Files\Mozilla Firefox\distribution\policies.json
et tester à nouveau avec pyscripter.
Vous pouvez voir directement l’état de l’audit dans la console (Cliquez sur le paquet puis sur la colonne audit) :
L’audit restitue une des 3 valeurs suivantes :
OK ;
WARNING ;
ERREUR.
Attention
Avec audit, il n’est pas possible de faire appel à des fichiers contenus dans le paquet.
Pour utiliser des fichiers lors de l’audit il faut d’abord les copier dans un répertoire temporaire de la machine lors de l’installation du paquet.
Planifier un audit¶
Les tâches d”audit s’exécutent après un upgrade puis à intervalle régulier défini par la valeur de audit_schedule
.
La valeur est contenue dans le fichier control
du paquet WAPT.
Par défault si audit_schedule est vide alors il faudra effectuer l’audit manuellement ou à partir de la console WAPT.
Sinon la valeur peut être indiquée de plusieurs manières :
Un entier (en minutes).
Un entier suivi d’une lettre (m = minutes , h = heure , d = jour , w = semaine).
Comportement par défaut de la fonction d’audit¶
Par défault, si aucun audit n’est déclaré, l’agent WAPT vérifiera la présence des Uninstallkey dans le paquet WAPT.
De cette manière WAPT vérifie que le logiciel est toujours présent.
Automatiser la mise à jour d’un paquet logiciel¶
Note
Cette partie de la documentation est déconseillée aux utilisateurs qui débutent avec WAPT.
Les fonctions update_package sont très pratiques, elles permettent de gagner du temps lorsque qu’il faut mettre à jour un paquet avec la version la plus récente d’un logiciel.
Principe de fonctionnement¶
La fonction update_package paquet ira :
Récupérer la dernière version du logiciel en ligne.
Télécharger la dernière version du binaire.
Supprimer les anciennes version des binaires.
Mettre à jour le numéro de version dans le fichier
control
.
Si votre fonction install se base sur la version du fichier control
pour l’installation, alors vous n’avez pas besoin de modifier votre setup.py
.
Il vous reste maintenant à tester l’installation avant de lancer un build-upload.
Exemple¶
Voici l”update_package de firefox-esr comme exemple :
def update_package():
import re,requests,glob
#Retrieving the last file name
url = requests.head('https://download.mozilla.org/?product=firefox-esr-latest&os=win64',proxies={}).headers['Location']
filename = url.rsplit('/',1)[1].replace('%20',' ')
#download of it if is not in the package
if not isfile(filename):
print('Downloading %s from %s'%(filename,url))
wget(url,filename)
#removing old exe with wrong name
for fn in glob.glob('*.exe'):
if fn != filename:
remove_file(fn)
# updates control version from filename, increment package version.
control.version = '%s-0'%(re.findall('Firefox Setup (.*)esr\.exe',filename)[0])
control.save_control_to_wapt()
Vous pouvez lancer le update_package dans PyScripter :
Vous trouverez de nombreux exemples d”update_package qui vous inspireront dans les paquets du store de Tranquil IT.
Exemple: déployer un logiciel portable avec WAPT¶
Un bon exemple de paquet applicatif WAPT est celui d’un logiciel dit portable. Pour cela, il faudra :
Créer le répertoire d’installation dans
C:\Program Files (x86)
.Copier l’application dans le dossier.
Créer un raccourci sur le bureau de l’utilisateur.
Gérer la désinstallation de l’application portable.
Fermer l’application si elle est en cours d’exécution.
Exemple avec ADWCleaner¶
Tout d’abord, télécharger Adwcleaner : https://downloads.malwarebytes.com/file/adwcleaner.
Vous pouvez générer votre modèle de paquet, veuillez vous référer à la documentation pour la création de paquets à partir de la console WAPT.
Le fichier C:\waptdev\tis-adwcleaner-wapt
est créé.
Vous trouverez ici un exemple de paquet portable qui prend presque toutes les fonctions WAPT d’un setup.py
:
from setuphelpers import *
uninstallkey = []
exe_name = 'AdwCleaner.exe'
path_adw = makepath(programfiles,'AdwCleaner')
path_exe = makepath(path_adw,exe_name)
nameshortcut = 'AdwCleaner'
def install():
mkdirs(path_adw)
filecopyto(exe_name,path_exe)
create_desktop_shortcut(nameshortcut,path_exe)
def uninstall():
remove_tree(path_adw)
remove_desktop_shortcut(nameshortcut,path_exe)
def audit():
if not isfile(path_exe):
print('File not found')
return "OK"
else:
print('File Found')
return "ERROR"
def update_package():
wget('https://downloads.malwarebytes.com/file/AdwCleaner',exe_name)
control.version = get_file_properties(exe_name)['FileVersion'] + '-0'
control.save_control_to_wapt()
Créer des paquets WAPT de mises à jour Windows avec des .msu¶
Indication
Pré-requis : pour construire des paquets WAPT, l’environnement de développement WAPT doit être installé ;
Entre les sorties de Patch Tuesday, Microsoft peut publier des KB supplémentaires ou des mises à jour critiques qui devront être rapidement poussées sur les machines.
À cette fin, WAPT fournit un modèle de paquet pour les fichiers .msu.
Dans cet exemple, nous utilisons la KB4522355 téléchargée du site officiel Microsoft.
télécharger le paquet MSU KB4522355 depuis le Catalogue du site de Microsoft .
Créer un modèle de paquet WAPT à partir du fichier .msu téléchargé. Dans la console WAPT, cliquez sur
.Sélectionner le paquet téléchargé .msu et remplir les champs obligatoires.
cliquer sur Créer et éditer (recommandé) pour lancer la personnalisation du paquet ;
L’IDE du paquet WAPT est lancé en utilisant le code source du modèle prédéfini .msu.
Comme d’habitude avec les paquets WAPT, tester, puis construire, puis signer, puis télécharger et enfin affecter les paquets WAPT souhaités à vos hôtes sélectionnés et c’est fait !
Si le KB est groupé avec le Patch Tuesday suivant, vous pourrez sélectionner les hôtes sur lesquels le paquet a été appliqué et oublier le paquet KB sur les hôtes.
Packager des paquets linux simples¶
Avant de commencer, nous supposons plusieurs conditions :
Vous disposez d’une interface graphique sur votre système Linux que vous utilisez pour développer et tester des paquets.
Vous avez installé le paquet vscode à partir du dépôt de Tranquil IT.
Votre utilisateur s’appelle linuxuser et est membre du groupe sudoers.
Créer un modèle de paquet base depuis votre poste linux¶
Démarrer un utilitaire de ligne de commande.
En tant que linuxuser, créer un modèle de paquet WAPT.
wapt-get make-template <template_name>
Avertissement
Ne pas lancer cette commande en tant que root ou avec sudo.
Lorsque vous créez un modèle, il y aura plusieurs fichiers dans le dossier
.vscode
à l’intérieur de votre dossier de développement de paquets :settings.json
;launch.json
;
Exemple avec TightVNC :
wapt-get make-template "tis-vlc" Using config file: /opt/wapt/wapt-get.ini Template created. You can build the WAPT package by launching /opt/wapt//wapt-get.py build-package /home/linuxuser/waptdev/tis-vlc-wapt You can build and upload the WAPT package by launching /opt/wapt//wapt-get.py build-upload /home/linuxuser/waptdev/tis-vlc-wapt
Indication
Tous les paquets sont stockés dans le répertoire personnel de linuxuser (le home de l’utilisateur acutellement connecté).
VSCode se charge et ouvre le projet de paquet.
Vérifier le contenu du fichier
control
.Vous devez donner une description à votre paquet, et renseigner le target_os et la version de votre paquet.
Indication
os_target
pour unix est linuxAvertissement
Le numéro de
version
dans votre fichiercontrol
doit commencer à 0, et non le numéro de version du logiciel car nous ne savons pas précisément à partir de apt/yum repo quelle sera la version du logiciel.Fichier
control
d’origine.package : tis-vlc version : 0-0 architecture : all section : base priority : optional maintainer : user description : automatic package for vlc
Fichier
control
modifié :package : tis-vlc version : 0 architecture : all section : base priority : optional maintainer : Tranquil-IT Systems description : VLC for linux target_os : linux min_wapt_version : 1.8
Note
Il est à noter qu’une sous-version -1 a été ajoutée. Il s’agit de la version de packaging du paquet WAPT.
Il permet au développeur de paquets de publier plusieurs versions de paquets WAPT d’un même logiciel, ce qui est très utile pour un développement très rapide et itératif.
Changer le code du fichier
setup.py
en conséquence.:emphasize-lines: 8 # -*- coding: utf-8 -*- from setuphelpers import * uninstallkey = [] def install(): apt_install('vlc')
Enregistrer le paquet.
Gérer la désinstallation¶
Modifier le fichier
setup.py
avec une procédure de désinstallation.
def uninstall(): apt_remove('vlc')
Lancer un remove de VSCode Run Configurations.
Vérifier que le logiciel a été correctement supprimé.
dpkg -l | grep vlc
Indication
Dans la fonction uninstall(), on ne peut pas appeler des fichiers contenus dans le paquet WAPT. Pour les appeler, il faudra avoir copié les fichiers dans un répertoire local de la machine lors de l’installation du paquet.
Gérer le session-setup¶
Modifier le fichier
setup.py
avec unsession-setup
;Dans cet exemple, nous allons créer un fichier :fichier : vlcrc par défaut dans le profil de l’utilisateur.
def session_setup(): vlcrc_content="""[qt] # Qt interface qt-notification=0 qt-privacy-ask=0 metadata-network-access=0 """ vlcdir = os.path.join(os.environ['HOME'], '.config', 'vlc') path_vlrc = makepath(vlcdir,'vlcrc') ensure_dir(vlcdir) if not isfile(path_vlrc): with open(makepath(vlcdir,'vlcrc')) as f: f.write(vlcrc_content)
Lancez un session-setup à partir de VSCode Run Configurations.
Construire et téléverser le paquet¶
Vous trouverez votre paquet ici : ~/waptdev
.
Vous devez transférer le dossier du paquet sur la machine Windows qui possède la clé privée.
Ensuite, se référer à la documentation pour la construire et charger le paquet depuis la console WAPT.
Chiffrer des données sensibles contenues dans un paquet WAPT¶
Note
Cette partie de la documentation est déconseillée aux utilisateurs qui débutent avec WAPT.
Cette fonctionnalité est disponible uniquement dans la version Entreprise.
Quel est l’intérêt de faire cela ?¶
Dans le fonctionnement de WAPT, l’intégrité du paquet est assurée. Un paquet dont le contenu a été modifié sans avoir été re-signé sera systématiquement refusé par le client WAPT.
En revanche le contenu d’un paquet WAPT n’est pas chiffré et sera lisible de tous. Ce modèle technique de transparence apporte cependant de nombreux bénéfices.
Cela peut être génant dans le cas d’un paquet qui contiendrait un mot de passe, une clé de licence, ou une donnée sensible.
Heureusement nous avons une solution.!!
Principe de fonctionnement¶
Lorsque qu’un agent WAPT s'enregistre auprès du serveur WAPT, il génère un couple clé privée / certificat public dans C:Program Files (x86)\waptprivate
.
Le certificat est envoyé au serveur avec l’inventaire lors de l’enregistrement initial du client WAPT.
La clé privée est conservée par l’agent et n’est accessible en lecture que par les Administrateurs Locaux.
Nous allons donc chiffrer la donnée sensible contenue dans le paquet avec le certificat appartenant à la machine.
Lors de l’installation l’agent WAPT pourra ainsi déchiffrer la donnée sensible grâce à sa clé privé.
Avec ce mode de fonctionnement le serveur WAPT et les dépôts secondaires n’ont pas connaissance de la donnée sensible.
Cas pratique¶
Vous trouverez ici un exemple de paquet WAPT ou nous chiffrons un texte dans dans une fonction update_package puis nous déchiffrons ce texte dans la partie install.
Dans cet exemple, la fonction update_package nous permet de parcourir la base de donnée du serveur WAPT pour récupérer le certificat de chaque machine pour ensuite chiffrer le texte sensible avec celui-ci.
Le texte chiffré pour chaque machine est ensuite stocké dans un fichier encrypt-txt.json
à la racine du paquet.
Lors de l’installation du paquet, l’agent WAPT prendra le texte chiffré et le déchiffrera avec sa clé privé.
Vous pouvez le tester par vous-même en téléchargeant le packaging d’exemple tis-encrypt-sample (https://store.wapt.fr/store/tis-encrypt-sample)
Attention
La sortie python (log install du paquet) est accessible en lecture aux utilisateurs de la machine, vous ne devez donc pas afficher le texte déchiffré avec un print lors de l’installation.
Utiliser des IDE différents pour développer les paquet WAPT¶
Si vous êtes habitué(e) à travailler avec un autre IDE, vous pouvez être soulagé maintenant car WAPT supporte d’autres éditeurs de développement intégrés.
Note
Utiliser un IDE supporté lancera le projet de paquet WAPT avec une configuration de débogage valide.
Sur Windows¶
Récupérer le nom du logiciel |
Logo de l’éditeur de texte |
---|---|
vscode; |
|
vscode; |
|
vscodium ; |
Pour configurer un autre éditeur pour WAPT, vous devez modifier l’attribut editor_for_packages
dans la section [global]
du fichier de configuration %LOCALAPPDATA%\waptconsole\waptconsole.ini
de votre console WAPT.
[global]
...
editor_for_packages = vscode
Sur Linux / macOS¶
Récupérer le nom du logiciel |
Logo de l’éditeur de texte |
---|---|
vscode; |
|
vscodium ; |
|
nano ; |
|
vim ; |
Pour configurer un autre éditeur pour WAPT, vous devez modifier l’attribut editor_for_packages
dans la section [global]
du fichier de configuration /opt/wapt/wapt-get.ini
de votre agent WAPT.
Par défaut, si l’attribut editor_for_packages
est vide, le WAPT essaiera de lancer (dans cet ordre) :
vscodium ;
vscode;
nano ;
vim ;
vi.
[global]
...
editor_for_packages = vim
Configurer WAPT pour utiliser un éditeur de code personnalisé¶
[global]
...
editor_for_packages = C:\Program Files\Notepad++\notepad++.exe {setup_filename}
[global]
...
editor_for_packages = /opt/pycharm/bin/pycharm_x64 {wapt_sources_dir}
Arguments personnalisés¶
Argument |
Description |
---|---|
|
Lance l’éditeur de code personnalisé et édite le fichier WAPT setup.py |
|
Lance l’éditeur de code personnalisé et modifie le fichier control des paquets WAPT |
|
Lance l’éditeur de code personnalisé et ouvre le dossier du paquet WAPT |
|
Lance l’éditeur de code personnalisé et ouvre le dossier d’installation WAPT |
Mise à jour des packages WAPT de Python 2 à Python 3¶
Attention
Avec WAPT 2.0, le fonctionnement interne de WAPT est passé à python3. Les paquets WAPT doivent aussi suivre la nouvelle syntaxe python3.
Syntaxe |
Python 2 |
Python 3 |
---|---|---|
|
|
|
unicode string |
|
|
opérateurs |
|
|
Acces à la base de registre Windows |
|
|
Indication
Pour plus de détails sur les changements, consultez :