Instructions relatives aux packages de test

  • Article

Importante

La base de test pour Microsoft 365 passera en fin de vie (EOL) le 31 mai 2024. Nous nous engageons à travailler en étroite collaboration avec chaque client pour fournir un support et des conseils pour rendre la transition aussi fluide que possible. Si vous avez des questions, des préoccupations ou si vous avez besoin d’aide, envoyez une demande de support.

1. Référencement de script

Lorsque vous chargez un fichier .zip dans le portail, nous décompressons tout le contenu de ce fichier dans un dossier racine. Vous n’avez pas besoin d’écrire de code pour effectuer cette opération de décompression initiale. Vous pouvez également référencer n’importe quel fichier dans le .zip en utilisant le chemin relatif au fichier zip chargé.

Dans l’exemple ci-dessous, nous montrons comment vous pouvez référencer vos fichiers binaires/scripts à partir du champ d’entrée sous l’onglet Tâches. Le texte en bleu doit être entré dans le champ Chemin du script sans guillemets.

Il est important que vous connaissiez le contenu de votre fichier zip avant de le charger. Souvent, lors du zip d’un dossier, votre ordinateur local crée un dossier main sous le fichier zip. Dans ce cas, le référencement sera comme indiqué en gras ci-dessous :

Contoso_App_Folder.zip:

├── Contoso_App_Folder

│   ├── file1.exe

│   ├── ScriptX.ps1

│   ├── folder1

│      ├── file3.exe

│      ├── script.ps1
  • ScriptX.ps1 : « Contoso_App_Folder/ScriptX.ps1 »
  • Script.ps1 : « Contoso_App_Folder/folder1/script.ps1 »

Dans d’autres cas, votre fichier zip peut contenir vos fichiers ou contenu juste en dessous (par exemple, aucun dossier de niveau 2e) :

Zip_file_uploaded.zip:

├── file1.exe

├── ScriptX.ps1

├── folder1

│   ├── file3.exe

│   ├── script.ps1
  • ScriptX.ps1 - « ScriptX.ps1 »
  • Script.ps1 - « folder1/script.ps1 »

2. Exécution du script

Tests out-of-Box : Le package d’application doit contenir au moins trois scripts PowerShell. Ces scripts exécutent l’installation, le lancement et la fermeture sans assistance de l’application et de ses dépendances. Chaque script doit gérer la vérification de ses propres prérequis, la validation de sa propre réussite et le nettoyage après lui-même (si nécessaire).

Tests fonctionnels : Le package d’application doit contenir au moins un script PowerShell. Lorsque plusieurs scripts sont fournis, les scripts sont exécutés dans une séquence de chargement et un échec dans un script particulier empêche l’exécution des scripts suivants.

Conditions requises pour les scripts

  • PowerShell version 5.1+
  • Exécution sans assistance
  • Code de retour d’erreur
  • Valider la réussite
  • Journalisation dans un dossier de journal spécifique de script

Chaque script doit s’exécuter sans assistance (aucun utilisateur n’y invite) pour s’exécuter correctement dans le pipeline de test.

Remarque

Les scripts doivent retourner « 0 » en cas d’exécution réussie et un code d’erreur différent de zéro si une erreur se produit pendant l’exécution.

Chaque script doit vérifier qu’il s’est exécuté correctement. Par exemple, le script d’installation doit case activée l’existence de certains fichiers binaires et/ou clés de Registre sur le système une fois l’exécution du fichier binaire du programme d’installation terminée. Cette case activée permet de garantir avec un degré raisonnable de confiance que l’installation a réussi.

La validation est nécessaire pour diagnostiquer correctement où les erreurs se produisent pendant une série de tests. Par exemple, si le script ne parvient pas à installer l’application correctement plutôt qu’à la lancer.

Importante

Évitez les éléments suivants :

  • Les scripts ne doivent pas redémarrer l’ordinateur. Si un redémarrage est nécessaire, spécifiez-le lors du chargement de vos scripts.
  • Ne modifiez pas la liste de recherche de suffixes DNS dans configuration IP Windows.

Importante

L’espace disque maximal disponible est de 127 Go. Les packages qui consomment plus de cette quantité d’espace ne sont pas exécutés.

Importante

Les informations d’identification de connexion automatique des packages qui interagissent avec l’interface utilisateur Windows doivent être activées pour s’exécuter correctement.

Importante

Les scripts dans les packages ont tous une limite de temps d’exécution de 60 minutes. L’exécution des scripts après 60 minutes expirerait.

3. Collection de journaux

Chaque script doit générer les journaux qu’il génère dans un dossier nommé logs. Tous les dossiers du répertoire nommé logs seront copiés et présentés pour téléchargement sur la Test Results page.

Par exemple, le script d’installation (qui peut se trouver dans le répertoire App/scripts/install ) peut générer ses journaux dans : journaux/install.log, de sorte que le journal final se trouve à l’adresse : Applications/scripts/install/logs/install.log

Le système récupère le install.log fichier avec d’autres fichiers dans d’autres logs dossiers et le rassemble pour le télécharger.

4. Fichiers binaires d’application

Tous les fichiers binaires et dépendances doivent être inclus dans le fichier zip unique.

Ces fichiers binaires doivent inclure tout ce qui est nécessaire à l’installation de l’application (par exemple, le programme d’installation de l’application). Si l’application a une dépendance sur des frameworks, tels que .NET Core/Standard ou .NET Framework, ces frameworks doivent être inclus dans le fichier et référencés correctement dans les scripts fournis.

Remarque

Le fichier zip chargé ne peut pas avoir d’espaces ou de caractères spéciaux dans son nom

5. Règles d’application/de test

Pour que vos applications/tests s’exécutent correctement dans l’infrastructure de base de test, ils doivent se conformer aux règles décrites dans Règles d’application/test .

Prochaines étapes

Passez à l’article suivant pour afficher des questions fréquentes (FAQ)

Étape suivante