Richtlijnen voor testpakketten

1. Script dat verwijst naar

Wanneer u een .zip bestand uploadt naar de portal, pakken we alle inhoud van dat bestand uit in een hoofdmap. U hoeft geen code te schrijven om deze eerste uitgepakte bewerking uit te voeren. U kunt ook verwijzen naar elk bestand in de .zip met behulp van het pad ten opzichte van het zip-bestand dat is geüpload.

In het onderstaande voorbeeld laten we zien hoe u naar uw binaire bestanden/scripts kunt verwijzen vanuit het invoerveld op het tabblad Taken. De blauwe tekst moet zonder aanhalingstekens worden ingevoerd in het padveld Script.

Het is belangrijk dat u op de hoogte bent van de inhoud in uw zip-bestand voordat u het uploadt. Wanneer u een map zipt, maakt uw lokale computer vaak een hoofdmap onder het zip-bestand. In dit geval wordt de verwijzing vet weergegeven:

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/map1/script.ps1'

Op andere momenten kan uw zip-bestand uw bestanden of inhoud direct eronder hebben (bijvoorbeeld geen map op het tweede niveau):

Zip_file_uploaded.zip:

├── file1.exe

├── ScriptX.ps1

├── folder1

│   ├── file3.exe

│   ├── script.ps1
  • ScriptX.ps1 - "ScriptX.ps1"
  • Script.ps1 - "map1/script.ps1"

2. Scriptuitvoering

Out-of-Box-tests: Het toepassingspakket moet ten minste drie PowerShell-scripts bevatten. Met deze scripts worden de toepassing en de bijbehorende afhankelijkheden zonder toezicht geïnstalleerd, gestart en gesloten. Elk script moet de controle van de eigen vereisten afhandelen, het valideren van het eigen succes en het opschonen na zichzelf (indien nodig).

Functionele tests: Het toepassingspakket moet ten minste één PowerShell-script bevatten. Als er meer dan één script wordt opgegeven, worden de scripts uitgevoerd in de uploadvolgorde en wordt een fout in een bepaald script voorkomen dat volgende scripts worden uitgevoerd.

Scriptvereisten

  • PowerShell versie 5.1+
  • Uitvoering zonder toezicht
  • Fout geretourneerde code
  • Geslaagd valideren
  • Logboekregistratie naar scriptspecifieke logboekmap

Elk script moet zonder toezicht worden uitgevoerd (geen gebruikersprompts) om te kunnen worden uitgevoerd in de testpijplijn.

Opmerking

Scripts moeten '0' retourneren bij een geslaagde voltooiing en een foutcode zonder nul als er een fout optreedt tijdens de uitvoering.

Elk script moet valideren dat het is uitgevoerd. Het installatiescript moet bijvoorbeeld controleren op het bestaan van bepaalde binaire bestanden en/of registersleutels op het systeem nadat het binaire installatieprogramma is uitgevoerd. Met deze controle kunt u met een redelijke mate van zekerheid garanderen dat de installatie is geslaagd.

Validatie is nodig om op de juiste manier vast te stellen waar fouten optreden tijdens een testuitvoering. Bijvoorbeeld als het script de toepassing niet kan installeren of niet kan starten.

Belangrijk

Vermijd het volgende: Scripts moeten de computer niet opnieuw opstarten. Als opnieuw opstarten nodig is, moet u dit opgeven tijdens het uploaden van uw scripts.

3. Logboekverzameling

Elk script moet alle logboeken uitvoeren die worden gegenereerd in een map met de naam logs. Alle mappen in de map met de naam logs worden gekopieerd en weergegeven om te worden gedownload op de Test Results pagina.

Het installatiescript (dat zich bijvoorbeeld in de map App/scripts/installeren kan bevinden) kan de logboeken uitvoeren naar: logs/install.log, zodat het uiteindelijke logboek zich bevindt op: Apps/scripts/install/logs/install.log

Het systeem haalt het install.log bestand samen met andere bestanden in andere logs mappen op en sorteert het voor downloaden.

4. Binaire toepassingsbestanden

Binaire bestanden en afhankelijkheden moeten worden opgenomen in het enkele zip-bestand.

Deze binaire bestanden moeten alles bevatten wat nodig is voor de installatie van de toepassing (bijvoorbeeld het installatieprogramma van de toepassing). Als de toepassing afhankelijk is van frameworks, zoals .NET Core/Standard of .NET Framework, moeten deze frameworks worden opgenomen in het bestand en correct worden verwezen in de opgegeven scripts.

Opmerking

Het geüploade zip-bestand mag geen spaties of speciale tekens bevatten in de naam

5. Toepassing/testregels

Om ervoor te zorgen dat uw toepassingen/tests correct worden uitgevoerd onder de Test Base-infrastructuur, moeten ze voldoen aan de regels die worden beschreven in toepassing/testregels .

Volgende stappen

Ga naar het volgende artikel om enkele veelgestelde vragen (FAQ) weer te geven