Wytyczne dotyczące pakietu testowego

Ważna

31 maja 2024 r. baza testowa dla platformy Microsoft 365 przejdzie do końca okresu eksploatacji (EOL). Dokładamy wszelkich starań, aby ściśle współpracować z każdym klientem, aby zapewnić pomoc techniczną i wskazówki, aby przejście było jak najbardziej płynne. Jeśli masz jakiekolwiek pytania, wątpliwości lub potrzebujesz pomocy, prześlij wniosek o pomoc techniczną.

1. Odwoływanie się do skryptu

Podczas przekazywania pliku .zip do portalu rozpakowyujemy całą zawartość tego pliku do folderu głównego. Nie trzeba pisać żadnego kodu, aby wykonać tę początkową operację rozpakowywanie. Możesz również odwołać się do dowolnego pliku w .zip, używając ścieżki względem przekazanego pliku zip.

W poniższym przykładzie pokazano, jak można odwoływać się do plików binarnych/skryptów z pola wejściowego na karcie Zadania. Tekst w kolorze niebieskim powinien zostać wprowadzony w polu Ścieżka skryptubez znaków cudzysłowu.

Ważne jest, aby pamiętać o zawartości w pliku zip przed przekazaniem go. Często podczas zipping folderu, komputer lokalny utworzy folder główny poniżej pliku zip. W takim przypadku odwołanie będzie wyświetlane pogrubioną czcionką poniżej:

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"

Innym razem plik zip może mieć pliki lub zawartość tuż pod nim (na przykład nie ma folderu drugiego poziomu):

Zip_file_uploaded.zip:

├── file1.exe

├── ScriptX.ps1

├── folder1

│   ├── file3.exe

│   ├── script.ps1

• ScriptX.ps1 — "ScriptX.ps1"
• Script.ps1 — "folder1/script.ps1"

2. Wykonywanie skryptu

Testy out-of-box: Pakiet aplikacji musi zawierać co najmniej trzy skrypty programu PowerShell. Te skrypty będą wykonywać nienadzorowane instalowanie, uruchamianie i zamykanie aplikacji oraz jej zależności. Każdy skrypt powinien obsługiwać sprawdzanie własnych wymagań wstępnych, weryfikowanie własnego sukcesu i czyszczenie po sobie (w razie potrzeby).

Testy funkcjonalne: Pakiet aplikacji musi zawierać co najmniej jeden skrypt programu PowerShell. W przypadku dostarczenia więcej niż jednego skryptu skrypty są uruchamiane w sekwencji przekazywania, a błąd w określonym skryptze uniemożliwia wykonywanie kolejnych skryptów.

Wymagania dotyczące skryptu

• PowerShell w wersji 5.1 lub nowszej
• Wykonywanie nienadzorowane
• Kod zwracany przez błąd
• Weryfikowanie powodzenia
• Rejestrowanie w folderze dziennika określonego skryptu

Aby pomyślnie wykonać polecenie w potoku testowym, każdy skrypt musi działać bez nadzoru (bez monitów użytkownika).

Uwaga

Skrypty powinny zwracać wartość "0" po pomyślnym ukończeniu i kod błędu inny niż zero, jeśli wystąpi błąd podczas wykonywania.

Każdy skrypt powinien sprawdzić, czy został uruchomiony pomyślnie. Na przykład skrypt instalacji powinien sprawdzić istnienie niektórych plików binarnych i/lub kluczy rejestru w systemie po zakończeniu wykonywania pliku binarnego instalatora. Ta kontrola pomaga zapewnić z rozsądnym stopniem pewności, że instalacja zakończyła się pomyślnie.

Walidacja jest niezbędna do prawidłowego zdiagnozowania, gdzie występują błędy podczas przebiegu testu. Jeśli na przykład skrypt nie może pomyślnie zainstalować aplikacji, a nie może jej uruchomić.

Ważna

Unikaj następujących czynności:

• Skrypty nie powinny ponownie uruchamiać maszyny, jeśli konieczne jest ponowne uruchomienie, określ to podczas przekazywania skryptów.
• Nie modyfikuj listy wyszukiwania sufiksów DNS w konfiguracji adresu IP systemu Windows.

Ważna

Maksymalna ilość dostępnego miejsca na dysku wynosi 127 Gb. Pakiety, które zużywają więcej miejsca niż ta ilość miejsca, nie zostaną wykonane.

Ważna

Pakiety, które współdziałają z interfejsem użytkownika systemu Windows, muszą mieć włączone poświadczenia automatycznego logowania, aby mogły być prawidłowo wykonywane.

Ważna

Wszystkie skrypty w pakietach mają limit czasu wykonywania wynoszący 60 minut. Limit czasu wykonywania skryptów po 60 minutach.

3. Zbieranie dzienników

Każdy skrypt powinien wyprowadzić wszystkie wygenerowane dzienniki do folderu o nazwie logs. Wszystkie foldery w katalogu o nazwie logs zostaną skopiowane i przedstawione do pobrania na Test Results stronie.

Na przykład skrypt instalacji (który może znajdować się w katalogu App/scripts/install ) może wyprowadzić swoje dzienniki do: logs/install.log, tak aby końcowy dziennik znajdował się w: Aplikacje/skrypty/instalacja/dzienniki/install.log

System będzie pobierał install.log plik wraz z innymi plikami w innych logs folderach i zbierał go do pobrania.

4. Pliki binarne aplikacji

Wszystkie pliki binarne i zależności powinny zostać uwzględnione w pojedynczym pliku zip.

Te pliki binarne powinny zawierać wszystko, co jest niezbędne do zainstalowania aplikacji (na przykład instalatora aplikacji). Jeśli aplikacja ma zależność od dowolnych struktur, takich jak .NET Core/Standard lub .NET Framework, te struktury powinny zostać uwzględnione w pliku i poprawnie odwołują się do nich w podanych skryptach.

Uwaga

Przekazany plik zip nie może mieć żadnych spacji ani znaków specjalnych w swojej nazwie

5. Reguły aplikacji/testów

Aby aplikacje/testy działały poprawnie w infrastrukturze Bazy testów, muszą one być zgodne z regułami opisanymi w temacie Reguły aplikacji/testów .

Następne kroki

Przejdź do następnego artykułu, aby wyświetlić niektóre często zadawane pytania

Następny krok