Netlify

Netlify integratsioon jälgib sinu Netlify juurutusi. Kui juurutus on valmis, käivitab Autonomy projekti testjuhtumi või testiplaani täpselt selle juurutuse vastu ja teatab tulemusest, kui GitHubi hoidla on lingitud, commit'il GitHubi kontrollina.

Mida see teeb

• Alustab käivitusi, kui juurutus on valmis, juurutuse tüübi (deploy preview, production, branch deploy) ja haru järgi filtreerituna.
• Testib juurutuse enda püsilinki, näiteks https://<deploy-id>--site.netlify.app, nii et uuem push ei saa muuta seda, mida käivitus näeb.
• Postitab lingitud hoidla kaudu GitHubi kontrolli Autonomy QA. Netlifyl endal pole kontrollide kuvamise kohta.
• Ootab forkitud pull request'ide juurutustega, kuni Netlify meeskonna omanik need heaks kiidab.

Seadistamine

1. Ava Organization → Integrations → Netlify ja klõpsa Connect. Kinnita juurdepääs Netlifys.
2. Klõpsa Link site ja vali Netlify sait, mida testida.
3. Vali jaotises Project Autonomy projekt, mille testid nendel juurutustel käivituvad. Hilisem muutmine tühjendab allolevad vaikeseaded.
4. Vali jaotises Default test case or plan, mis igal juurutusel käivitub. Loetletud on ainult projekti testjuhtumid ja testiplaanid.
5. Vali jaotises Default environment projekti keskkond. Käivitused kasutavad selle väärtusi ja sisselogimisi ning veebisihtmärgiks on juurutuse URL. Ilma keskkonnata jäetakse juurutused vahele.
6. Vali jaotises Trigger on juurutuse tüübid, mis käivituse alustavad, tavaliselt Preview. Lisa Branch filters, et piirata seda osade harudega.
7. Lülita sisse Post a GitHub check via linked repository ja vali GitHub repository for checks.
8. Ava pull request ja kontrolli, et käivitus algab, kui deploy preview on valmis.

Kuidas käivitus algab

Kui juurutus õnnestub, Autonomy:

1. Leiab lingitud saidi ja selle Autonomy projekti. Kui see projekt on arhiveeritud, ei käivitu midagi.
2. Vastendab juurutuse tüübi: Netlify deploy-preview on Preview, production on Production ja branch-deploy on Branch. Seejärel võrdleb ta seda seadega Trigger on ja haru seadega Branch filters.
3. Alustab vaikimisi testjuhtumi või testiplaani vaikekeskkonnas juurutuse püsilingi vastu.

Iga juurutus käivitub üks kord. Kui Netlify saadab webhooki kaks korda, teist käivitust ei alustata.

Forkitud pull request'i juurutuse hoiab Netlify kinni, kuni meeskonna omanik selle heaks kiidab. Autonomy näitab seda ootelolevana ja käivitab selle, kui heakskiidetud juurutus õnnestub.

Kontroll

Lingitud hoidla korral on GitHubi kontroll nimetatud selle järgi, mis käivitus, näiteks Autonomy QA: Checkout, ja see näitab linki igale käivitusele. Selle lõpptulemus on üks järgmistest:

Läbikukkunud käivitus kukutab kontrolli läbi, olgu selle oodatud tulemuseni jõudmata jäänud või agent ei suutnud näidata, et jõuti. Kokkuvõte annab põhjuse.

Kui soovid, et ka vead kukutaksid kontrolli läbi, lülita projekti lehel Settings → Integrations → Pull requests sisse Fail the check on issues. Vaikimisi on see väljas. Kui see on sees, kukutab avatud Bug, mille mõni kontrolli käivitus leidis või uuesti avas, kontrolli läbi: „Failed: a bug was found“. Vaata Pull request'ide testimine.

Ilma lingitud hoidlata on tulemused näha ainult Autonomys. Lingi seaded hoiatavad sind, kui kontrollid on sees, aga hoidlat pole valitud.

Parooliga kaitstud saidid

Kui sait või selle juurutused on parooliga kaitstud, kleebi parool lingitud saidi välja Preview access secret. Autonomy kasutab seda selle saidi igal käivitusel. See salvestatakse saladusena ja seda ei näidata enam kunagi.

Mitu saiti

Lingi iga Netlify sait eraldi. Igal lingil on oma Autonomy projekt, testiplaan, keskkond, päästiku tüübid ja harufiltrid. Mitu saiti võivad kontrollide jaoks jagada üht hoidlat.

Tõrkeotsing

Deploy preview on valmis, kuid ühtegi käivitust ei alga

Ava Autonomys lingitud sait ja vaata viimaseid juurutusi. Vahele jäetud juurutus ütleb, miks:

• project disabled: link on välja lülitatud.
• deployment not ready: juurutus on alles ehitamisel või kukkus läbi.
• context <x> not enabled: juurutuse tüüp pole seadistuses Trigger on.
• branch <x> filtered: haru ei vasta seadele Branch filters.
• no default test target: vali Default test case or plan.
• „Choose an environment for this deploy link in Autonomy.“: vali Default environment.
• project archived või vaikeseade, mis on arhiveeritud või teises projektis: taasta projekt või vali uued vaikeseaded.
• no preview URL: Netlify ei saatnud juurutuse URL-i.

Juurutus jääb ootele

See on forkitud pull request'i juurutus. Kiida see Netlifys heaks; käivitus algab, kui juurutus õnnestub.

Käivitus ei pääse juurutusele ligi

Sait on parooliga kaitstud. Lisa parool väljale Preview access secret.

Pull request'il ei ilmu kontrolli

Kontrolli, et Post a GitHub check via linked repository on sees, et GitHub repository for checks on valitud ja et Autonomy GitHubi rakendus on sellesse paigaldatud.