Intégration de Tosca avec Sauce Labs : Guide en 5 étapes et bonnes pratiques pour l’automatisation des tests multi-navigateurs
Tricentis Tosca est un outil d'automatisation de tests extrêmement polyvalent, capable d'automatiser une grande variété d'applications, y compris les applications web. Tosca utilise un plugin ou une extension de navigateur pour exécuter les cas de test localement dans un navigateur. Cet avantage est considérable, car un cas de test n'a besoin d'être écrit qu'une seule fois ; Tosca peut ensuite l'exécuter sur différents navigateurs locaux grâce à des paramètres de configuration.
Pour poursuivre et étendre ce concept de réutilisation des cas de test précédemment développés sur différentes plateformes et navigateurs, il est judicieux de connecter un fournisseur de cloud multiplateforme comme Sauce Labs à Tosca pour l'automatisation des tests. Les avantages d'une telle solution sont les suivants :
- Vérification simple de la conception réactive d'une application web
- Réduction des efforts et des coûts liés à la maintenance d'une infrastructure de dispositifs
- Les coûts d'acquisition élevés liés au matériel sont évités
- Obtenir une couverture de test plus élevée
Ce guide sert de manuel d'intégration de Tosca à la plateforme Sauce Labs, notamment dans un environnement d'entreprise avec pare-feu et proxy web. Il présente également les bonnes pratiques pour la configuration des cas de test dans Tosca.
Étape n° 1 : Hello Sauce Labs – Configuration initiale de la connexion
Pour établir une base solide pour la configuration ultérieure, il est recommandé d'utiliser un agent Tosca pour la connexion initiale au cloud Sauce Labs. Cet agent doit disposer d'un accès complet et, idéalement, ne pas se trouver derrière un proxy ou un pare-feu d'entreprise. Bien que cette étape puisse paraître anodine, elle nous permet de revenir à cette configuration à tout moment lors du dépannage, ce qui nous permet d'analyser et d'isoler potentiellement les erreurs d'accès à la connexion sans aucune limitation.
L'objectif de la première étape se présente comme suit :
Nous utilisons un cas de test simple et nous nous assurons d'abord qu'il s'exécute correctement sur l'agent Tosca local dans le Scratchbook :
Ensuite, le même cas de test est exécuté dans le cloud de Sauce Labs. Nous utilisons le centre de données européen https://ondemand.eu-central-1.saucelabs.com/wd/hub (un aperçu de tous les points de terminaison des centres de données est disponible ici : Points de terminaison des centres de données | Documentation Sauce Labs).
Le paramètre de configuration de test « HubAddress » doit être configuré dans Tosca selon le schéma suivant :
En utilisant le paramètre « HubAddress », le test n'est plus exécuté localement, mais sur le cloud de Sauce Labs. Après exécution dans Scratchbook, le résultat s'affiche sur le cloud de Sauce Labs. Comme illustré ci-dessus, il suffit de spécifier le paramètre « Browser » pour lancer le test. Des valeurs par défaut sont utilisées pour le système d'exploitation et la version du navigateur.
Ensuite, nous mettrons en œuvre l'exécution à l'aide de Sauce Labs depuis le réseau de l'entreprise via un proxy web.
Étape n° 2 : Configuration d’entreprise – Configuration de l’exécution avec une connexion proxy
Pour configurer l'accès de Tosca au cloud Sauce Labs au sein d'un réseau d'entreprise avec serveur proxy et pare-feu, des paramètres supplémentaires doivent être ajoutés à la configuration de test. Toutefois, il est impératif de vérifier au préalable auprès de votre service informatique si les agents Tosca peuvent accéder au cloud Sauce Labs. Il peut s'avérer nécessaire d'ajuster certaines règles du pare-feu.
La configuration ressemble maintenant à ceci :
Une fois qu'il est vérifié que l'accès web depuis les agents Tosca vers le point de terminaison du centre de données Sauce Labs fonctionne, trois paramètres de configuration de test importants doivent être ajoutés :
- WebDriverHubProxyAddress: Adresse du serveur proxy avec le port
- Nom d'utilisateur WebDriverProxy: Nom d'utilisateur pour l'authentification auprès du proxy web
- WebDriverProxyPassword: Mot de passe pour l'authentification auprès du proxy web
Une fois ces paramètres ajoutés à la configuration, nous pouvons relancer l'exécution dans Scratchbook et vérifier dans Sauce Labs si le test s'est déroulé correctement. En cas de problème lors de l'exécution, il convient de l'analyser en détail avec le service informatique interne.
Lors de l'exécution du test Sauce Labs, examinez attentivement les métadonnées de session. Si vous constatez l'utilisation du protocole JWP WebDriver obsolète, il est impératif de le corriger.
Étape n° 3 : Utilisation du protocole WebDriver correct (W3C)
L'utilisation du protocole W3C est documentée plus en détail par Sauce Labs : Prise en charge des capacités W3C WebDriver | Documentation Sauce Labs
Sauce Labs recommande d'utiliser le protocole W3C plus récent plutôt que le JWP (JSON Wire Protocol). La procédure suivante explique comment mettre en œuvre ces recommandations avec Tosca. Le nom des fonctionnalités à utiliser est essentiel.
Le Webdriver_platformName configure la plateforme à utiliser (la valeur obsolète « OperatingSystem » est à proscrire). Sauce Labs utilisera alors le protocole approprié. Vous pouvez le vérifier dans l’onglet « Métadonnées » de l’environnement de test de Sauce Labs.
À ce jour, nous avons établi avec succès la connexion entre Tosca et Sauce Labs et pouvons désormais configurer tous les paramètres nécessaires au contrôle des tests dans le cloud. L'outil de configuration de la plateforme Sauce Labs s'avère également très utile à cet égard.
Étape n° 4 : Écrire une fois, utiliser plusieurs fois – Mise en œuvre de l’automatisation multi-navigateurs d’un cas de test Tosca avec Sauce Labs
Sauce Labs propose un outil très utile pour générer les paramètres de configuration des différentes versions possibles d'appareils et de systèmes d'exploitation, ainsi que, par exemple, la résolution d'écran : le Platform Configurator (Sauce Labs - Platform Configurator) :
La configuration présentée ci-dessus (Windows 11 / Chrome version 110 / résolution de 1920x1080 pixels) est implémentée dans Tosca comme suit :
Notez la notation correcte pour les différents paramètres :
- WebDriver_browserVersion : Vous pouvez ici saisir une version disponible sur Sauce Labs. La valeur « latest » utilisera la version la plus récente.
- WebDriver_platformName: système d'exploitation à utiliser
- WebDriver_sauce___screenResolution: Résolution de l'appareil dans Sauce Labs. Tous les paramètres spécifiques à Sauce Labs sont spécifiés à l'aide du schéma «_sauce___optionName» (un trait de soulignement «_», suivi de «sauce», puis de trois traits de soulignement «_»).
La configuration présentée ci-dessus permet d'exécuter un cas de test, développé une fois dans Tosca, sur différentes plateformes dans Sauce Labs :
Il est recommandé de structurer la zone d'exécution Tosca avec des dossiers en fonction des configurations requises et d'appliquer les configurations de test Tosca précédemment créées aux dossiers correspondants :
Dans les listes d'exécution, un même cas de test peut désormais être réutilisé plusieurs fois et donc exécuté sur différentes configurations.
Étape n° 5 : Analyse des erreurs et rapport des résultats des tests
Tosca offre déjà des fonctionnalités complètes de reporting et d'analyse des erreurs. Il est recommandé de continuer à utiliser les rapports existants issus des exécutions de tests dans Tosca.
Cependant, Sauce Labs propose d'autres options pour la traçabilité de la procédure de test. En particulier, les enregistrements vidéo des essais offrent aux testeurs un outil complet d'analyse des erreurs :
Les commandes situées à gauche peuvent également être utilisées pour analyser les problèmes de synchronisation, par exemple.
Conclusion
Se connecter à Sauce Labs depuis Tosca est simple, même dans un environnement d'entreprise avec authentification par proxy. Cependant, la dénomination des paramètres de configuration n'est pas uniforme, et trouver les paramètres appropriés pour la connexion peut parfois s'avérer complexe.
Une fois les paramètres correctement configurés, une extension complète de l'environnement Tosca est mise en place : les cas de test écrits une seule fois peuvent être exécutés sur des appareils distants. Ceci élimine le besoin d'un achat coûteux et d'une maintenance intensive de l'infrastructure correspondante.
De plus, Sauce Labs Cloud permet de tester automatiquement les applications mobiles sur des appareils virtuels et réels. Cela engendre des économies supplémentaires et, au final, une couverture de test plus étendue.
