Pokyny pro testovací balíček

  • Článek

1. Odkazování na skripty

Když na portál nahrajete soubor .zip, rozbalíme veškerý obsah tohoto souboru do kořenové složky. K provedení této počáteční operace rozbalení není nutné psát žádný kód. Můžete také odkazovat na libovolný soubor v rámci .zip pomocí cesty relativní k nahranému souboru ZIP.

V následujícím příkladu si ukážeme, jak můžete odkazovat na binární soubory nebo skripty ze vstupního pole na kartě Úkoly. Modrý text by měl být zadán do pole Cesta ke skriptubez uvozovek.

Je důležité, abyste před nahráním souboru ZIP věděli o obsahu souboru ZIP. Při zazipování složky často místní počítač vytvoří pod souborem ZIP hlavní složku. V tomto případě bude odkaz stejný, jak je znázorněno tučným písmem níže:

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"

Jindy může mít soubor ZIP vaše soubory nebo obsah přímo pod ním (například žádná složka 2. úrovně):

Zip_file_uploaded.zip:

├── file1.exe

├── ScriptX.ps1

├── folder1

│   ├── file3.exe

│   ├── script.ps1
  • ScriptX.ps1 – "ScriptX.ps1"
  • Script.ps1 – "folder1/script.ps1"

2. Spuštění skriptu

Předsefinované testy: Balíček aplikace musí obsahovat aspoň tři skripty PowerShellu. Tyto skripty spustí bezobslužnou instalaci, spuštění a zavření aplikace a jejích závislostí. Každý skript by měl zvládnout kontrolu vlastních požadavků, ověření vlastního úspěchu a vyčištění po sobě (v případě potřeby).

Funkční testy: Balíček aplikace musí obsahovat alespoň jeden skript PowerShellu. Pokud je k dispozici více než jeden skript, skripty se spouštějí v pořadí nahrávání a selhání v konkrétním skriptu zastaví spouštění dalších skriptů.

Požadavky na skripty

  • PowerShell verze 5.1 nebo novější
  • Bezobslužné spuštění
  • Návratový kód chyby
  • Ověření úspěšnosti
  • Protokolování do složky protokolu specifické pro skript

Každý skript musí spustit bezobslužné spuštění (bez výzvy uživatele), aby se úspěšně spustil v testovacím kanálu.

Poznámka

Skripty by měly při úspěšném dokončení vrátit hodnotu 0 a nenulový kód chyby, pokud během provádění dojde k nějaké chybě.

Každý skript by měl ověřit, že se úspěšně spustil. Instalační skript by například měl zkontrolovat existenci určitých binárních souborů nebo klíčů registru v systému po dokončení spuštění binárního souboru instalačního programu. Tato kontrola pomáhá zajistit s přiměřenou mírou jistoty, že instalace proběhla úspěšně.

Ověření je nezbytné k správné diagnostice výskytu chyb během testovacího běhu. Například pokud skript nemůže úspěšně nainstalovat aplikaci a nemůže ji spustit.

Důležité

Vyhněte se následujícímu:

  • Skripty by neměly restartovat počítač. Pokud je restartování nutné, zadejte to během nahrávání skriptů.
  • Neupravujte seznam hledání přípon DNS v konfiguraci protokolu IP systému Windows.

Důležité

Maximální dostupné místo na disku je 127 GB. Balíčky, které spotřebovávají více místa než toto množství, se nebudou spouštět.

Důležité

Balíčky, které komunikují s uživatelským rozhraním Windows, musí mít povolené přihlašovací údaje automatického přihlašování, aby se mohly správně spouštět.

Důležité

Všechny skripty v rámci balíčků mají limit doby provádění 60 minut. Spuštění skriptů po 60 minutách by vypršelo.

3. Shromažďování protokolů

Každý skript by měl vygenerovat všechny protokoly, které vygeneruje, do složky s názvem logs. Všechny složky v adresáři s názvem logs se zkopírují a zobrazí ke stažení na Test Results stránce.

Například instalační skript (který se může nacházet v adresáři App/scripts/install) může vypíše své protokoly do složky logs/install.log, aby konečný protokol byl na adrese Apps/scripts/install/logs/install.log.

Systém vyzvedne install.log soubor spolu s dalšími soubory v jiných logs složkách a sbalí ho ke stažení.

4. Binární soubory aplikací

Všechny binární soubory a závislosti by měly být součástí jednoho souboru ZIP.

Tyto binární soubory by měly obsahovat vše potřebné pro instalaci aplikace (například instalační program aplikace). Pokud je aplikace závislá na architekturách, jako je .NET Core/Standard nebo .NET Framework, měly by být tyto architektury zahrnuty do souboru a správně odkazovány v poskytnutých skriptech.

Poznámka

Nahraný soubor ZIP nesmí mít v názvu mezery ani speciální znaky.

5. Pravidla aplikace/testování

Aby vaše aplikace nebo testy správně běžely v infrastruktuře Test Base, musí splňovat pravidla popsaná v tématu Pravidla aplikací/testů .

Další kroky

V dalším článku si můžete prohlédnout některé nejčastější dotazy.

Další krok