Richtlijnen voor testpakketten

  • Artikel

Belangrijk

Test Base voor Microsoft 365 gaat over naar het einde van de levensduur (EOL) op 31 mei 2024. We streven ernaar om nauw samen te werken met elke klant om ondersteuning en begeleiding te bieden om de overgang zo soepel mogelijk te laten verlopen. Als u vragen of opmerkingen hebt of hulp nodig hebt, dient u een ondersteuningsaanvraag in.

1. Script waarnaar wordt verwezen

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 uitpakbewerking 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 ziet u hoe u kunt verwijzen naar uw binaire bestanden/scripts vanuit het invoerveld op het tabblad Taken. De tekst in het blauw moet zonder aanhalingstekens worden ingevoerd in het veld Scriptpad.

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 weergegeven zoals hieronder vet wordt 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/folder1/script.ps1"

Op andere momenten kan uw zip-bestand uw bestanden of inhoud er direct onder 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 wordt het installeren, starten en sluiten van de toepassing en de bijbehorende afhankelijkheden zonder toezicht uitgevoerd. Elk script moet het controleren van de eigen vereisten, het valideren van het eigen succes en het opschonen zelf afhandelen (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 worden volgende scripts niet meer uitgevoerd door een fout in een bepaald script.

Scriptvereisten

  • PowerShell versie 5.1+
  • Uitvoering zonder toezicht
  • Fout retourcode
  • Geslaagd valideren
  • Logboekregistratie voor scriptspecifieke logboekmap

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

Opmerking

Scripts moeten '0' retourneren na een geslaagde voltooiing en een niet-nul foutcode 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 er met een redelijke mate van vertrouwen van zijn dat de installatie is geslaagd.

Validatie is nodig om goed vast te stellen waar fouten optreden tijdens een testuitvoering. Bijvoorbeeld als het script de toepassing niet kan installeren en niet kan worden gestart.

Belangrijk

Vermijd het volgende:

  • Scripts mogen de computer niet opnieuw opstarten. Als opnieuw opstarten nodig is, geeft u dit op tijdens het uploaden van uw scripts.
  • Wijzig de lijst met dns-achtervoegsels niet in Windows IP-configuratie.

Belangrijk

De maximaal beschikbare schijfruimte is 127 Gb. Pakketten die meer dan deze hoeveelheid ruimte verbruiken, worden niet uitgevoerd.

Belangrijk

Voor pakketten die communiceren met de Windows-gebruikersinterface moeten de referenties voor automatisch aanmelden zijn ingeschakeld om correct te kunnen worden uitgevoerd.

Belangrijk

Scripts in pakketten hebben allemaal een uitvoeringstijdslimiet van 60 minuten. Uitvoering van scripts na 60 minuten zou een time-out hebben.

3. Logboekverzameling

Elk script moet alle logboeken die worden gegenereerd, uitvoeren 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 mogelijk in de map App/scripts/install bevindt) kan bijvoorbeeld de logboeken uitvoeren naar: logs/install.log, zodat het uiteindelijke logboek zich op: Apps/scripts/install/logs/install.log

Het systeem haalt het install.log bestand op samen met andere bestanden in andere logs mappen en verzamelt het om te downloaden.

4. Binaire bestanden van toepassingen

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 in de naam hebben

5. Toepassings-/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 Toepassings-/testregels .

Volgende stappen

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

Volgende stap