Testipaketin ohjeet

Tärkeää

Microsoft 365:n Test Base siirtyy käyttöiän päättymiseen 31.5.2024. Olemme sitoutuneet tekemään tiivistä yhteistyötä jokaisen asiakkaan kanssa, jotta voimme tarjota tukea ja ohjeita, jotta siirtyminen olisi mahdollisimman sujuvaa. Jos sinulla on kysyttävää, huolenaiheita tai tarvitset apua, lähetä tukipyyntö.

1. Komentosarjaan viittaaminen

Kun lataat .zip -tiedoston portaaliin, puramme tiedoston kaiken sisällön pääkansioon. Sinun ei tarvitse kirjoittaa mitään koodia tämän ensimmäisen puramistoiminnon suorittamiseksi. Voit myös viitata mihin tahansa tiedostoon .zip käyttämällä polkua suhteessa ladattuun zip-tiedostoon.

Alla olevassa esimerkissä näytämme, miten voit viitata binaaritiedostoihin/komentosarjoihin Tehtävät-välilehden syötekentästä. Sininen teksti tulee syöttää Komentosarjapolku-kenttäänilman lainausmerkkejä.

On tärkeää, että olet tietoinen zip-tiedoston sisällöstä ennen sen lataamista. Kun suljet kansion, paikallinen tietokone luo usein pääkansion zip-tiedoston alle. Tässä tapauksessa viittaaminen näkyy lihavoituna alla:

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"

Joskus zip-tiedoston alla saattaa olla tiedostoja tai sisältöä (esimerkiksi ei 2. tason kansiota):

Zip_file_uploaded.zip:

├── file1.exe

├── ScriptX.ps1

├── folder1

│   ├── file3.exe

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

2. Komentosarjan suorittaminen

Käyttövalmiit testit: Sovelluspaketin on sisällettävä vähintään kolme PowerShell-komentosarjaa. Nämä komentosarjat suorittavat sovelluksen ja sen riippuvuuksien tahattoman asentamisen, käynnistämisen ja sulkemisen. Jokaisen komentosarjan tulee käsitellä omien edellytystensä tarkistamista, oman onnistumisensa vahvistamista ja itse siivoamista (tarvittaessa).

Toiminnalliset testit: Sovelluspaketin on sisällettävä vähintään yksi PowerShell-komentosarja. Jos annettuja komentosarjoja on useita, komentosarjat suoritetaan latausjärjestyksessä, ja tietyn komentosarjan virhe estää myöhempien komentosarjojen suorittamisen.

Komentosarjavaatimukset

  • PowerShellin versio 5.1+
  • Tahaton suorittaminen
  • Virheen palautuskoodi
  • Onnistumisen vahvistaminen
  • Kirjaaminen komentosarjakohtaan lokikansioon

Kunkin komentosarjan suorittaminen testiputkessa edellyttää valvomatonta suorittamista (ei käyttäjän kehotteita).

Huomautus

Komentosarjojen tulee palauttaa arvo "0" onnistuneen valmistumisen yhteydessä ja nollasta poikkeava virhekoodi, jos suorituksen aikana ilmenee virheitä.

Kunkin komentosarjan on vahvistettava, että se suoritettiin onnistuneesti. Asennuskomentosarjan tulisi esimerkiksi tarkistaa tiettyjen binaaritiedostojen ja/tai rekisteriavainten olemassaolo järjestelmässä sen jälkeen, kun asennusohjelman binaaritiedoston suorittaminen on päättynyt. Tämä tarkistus auttaa varmistamaan kohtuullisen luotettavasti, että asennus onnistui.

Vahvistus on tarpeen, jotta voidaan diagnosoida oikein, missä virheitä ilmenee testin suorittamisen aikana. Jos komentosarja ei esimerkiksi pysty asentamaan sovellusta onnistuneesti, sen käynnistäminen ei onnistu.

Tärkeää

Vältä seuraavia:

  • Komentosarjojen ei pitäisi käynnistää tietokonetta uudelleen, jos uudelleenkäynnistys on tarpeen, määritä tämä komentosarjojen lataamisen aikana.
  • Älä muokkaa DNS-jälkiliitehakuluetteloa Windowsin IP-määrityksessä.

Tärkeää

Käytettävissä oleva levytila on enintään 127 Gt. Paketteja, jotka kuluttavat enemmän tilaa, ei suoriteta.

Tärkeää

Windowsin käyttöliittymää käyttävissä paketeissa on oltava automaattisen kirjautumisen tunnistetiedot käytössä, jotta ne voidaan suorittaa oikein.

Tärkeää

Pakettien komentosarjojen suoritusaikarajoitus on 60 minuuttia. Komentosarjojen suorittaminen 60 minuutin kuluttua aikakatkaistiin.

3. Lokikokoelma

Kunkin komentosarjan pitäisi tulostaa luomansa lokit kansioon nimeltä logs. Kaikki nimetyn logs hakemiston kansiot kopioidaan ja esitetään ladattavissa Test Results sivulla.

Esimerkiksi asennuskomentosarja (joka saattaa sijaita sovellus/komentosarjat/asennushakemistossa ) voi tulostaa lokitiedostonsa kohteeseen: lokit/install.log, jolloin lopullinen loki on osoitteessa: Sovellukset/komentosarjat/asennus/lokit/install.log

Järjestelmä noutaa install.log tiedoston yhdessä muiden muiden logs kansioiden sisältämien tiedostojen kanssa ja lajittele sen ladattavaksi.

4. Sovelluksen binaaritiedostot

Kaikki binaaritiedostot ja riippuvuudet tulee sisällyttää yksittäiseen zip-tiedostoon.

Näiden binaaritiedostojen tulee sisältää kaikki sovelluksen asennuksessa tarvittava sisältö (esimerkiksi sovelluksen asennusohjelma). Jos sovellus on riippuvainen mistä tahansa sovelluskehyksestä, kuten .NET Core/Standard tai .NET Framework, nämä sovelluskehykset on sisällytettävä tiedostoon ja niihin on viitattava oikein annetuissa komentosarjoissa.

Huomautus

Palvelimeen ladatun zip-tiedoston nimessä ei voi olla välilyöntejä tai erikoismerkkejä

5. Sovellus- ja testisäännöt

Jotta sovelluksesi/testisi toimisivat oikein Test Base -infrastruktuurissa, niiden on noudatettava kohdassa Sovellus/testisäännöt kuvattuja sääntöjä.

Seuraavat vaiheet

Siirry seuraavaan artikkeliin ja tarkastele usein kysyttyjä kysymyksiä