Vercel
Käivita projekti testid igal Verceli juurutusel ja teata tulemusest Verceli juurutuse kontrollina.
Verceli integratsioon jälgib sinu Verceli juurutusi. Kui juurutus on valmis, käivitab Autonomy projekti testjuhtumi või testiplaani selle URL-i vastu ja teatab tulemusest juurutuse kontrollina. Kui ka hoidla on lingitud, ilmub sama tulemus commit'il GitHubi kontrollina.
Mida see teeb
- Alustab käivitusi, kui Verceli juurutus on valmis, juurutuse tüübi (eelvaade, production, haru) ja haru järgi filtreerituna.
- Testib juurutuse enda URL-i sinu valitud projekti keskkonnas.
- Postitab Verceli juurutuse kontrolli nimega
Autonomy QAja võib productionisse edutamist peatada, kuni kontroll lõpeb. - Alustab uue käivituse, kui keegi klõpsab Vercelis kontrollil Re-run.
Seadistamine
Enne alustamist
- Verceli meeskond või konto projektiga, mis loob eelvaate juurutusi.
- Autonomy projekt keskkonnaga, millel on veebisihtmärk. Nende käivituste puhul asendab juurutuse URL selle veebi-URL-i.
- Selle projekti testjuhtum või testiplaan, mis läbib eelvaate- või staging-keskkonnas.
- Organisatsiooni omaniku või administraatori õigused Autonomys.
- Ava Organization → Integrations → Vercel ja klõpsa Connect. Vercel palub valida meeskonna või konto ja kinnitada küsitud õigused, sealhulgas juurutuse kontrollid.
- Klõpsa Link project ja vali Verceli projekt, mida testida. Selle kontrolli definitsioon luuakse sinu eest.
- Vali jaotises Project Autonomy projekt, mille testid nendel juurutustel käivituvad. Hilisem muutmine tühjendab allolevad vaikeseaded.
- Vali jaotises Default test case or plan, mis igal juurutusel käivitub. Loetletud on ainult projekti testjuhtumid ja testiplaanid.
- 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.
- Vali jaotises Trigger on juurutuse tüübid, mis käivituse alustavad, tavaliselt Preview. Lisa Branch filters, näiteks
mainvõirelease/*, et piirata seda osade harudega. - Lülita sisse Post a Vercel deployment check. Lülita sisse Block deployment promotion until check completes, kui läbikukkunud kontroll peaks edutamise peatama.
- Lükka üles commit ja kontrolli, et käivitus algab, kui eelvaade on valmis.
Kuidas käivitus algab
Kui juurutus on valmis, Autonomy:
- Leiab lingitud Verceli projekti ja selle Autonomy projekti. Kui see projekt on arhiveeritud, ei käivitu midagi.
- Võrdleb juurutuse tüüpi seadega Trigger on ja haru seadega Branch filters.
- Alustab vaikimisi testjuhtumi või testiplaani vaikekeskkonnas juurutuse URL-i vastu.
Iga juurutus käivitub üks kord. Kui Vercel saadab webhooki kaks korda, teist käivitust ei alustata.
Kontroll
Kontrolli nimi on Autonomy QA ja see näitab linki igale käivitusele. Selle lõpptulemus on üks järgmistest:
| Lõpptulemus | Millal |
|---|---|
succeeded | Iga käivitus läbis. |
failed | Mõni käivitus kukkus läbi. |
neutral | Mõni käivitus ei saanud alata, nii et pole midagi hinnata. |
canceled | Käivitused tühistati. |
timeout | Käivitused ei lõppenud 15 minuti jooksul. |
Läbikukkunud käivitus kukutab juurutuse 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.
Kontrolli läbikukkumine probleemide korral
Probleemid ei muuda kunagi käivituse tulemust, nii et läbinud käivitus läbib kontrolli ka siis, kui see teatas probleemist. Kui soovid, et ka vead kukutaksid juurutuse 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, muudab avatud Bug, mille mõni kontrolli käivitus leidis või uuesti avas, kontrolli olekuks failed: „Failed: a bug was found“. Riskid ning vead, mille oled lahendanud või eiranud, ei loe. Vaata Pull request'ide testimine.
Edutamise blokeerimine
Kui Block deployment promotion until check completes on sees, ei eduta Vercel juurutust productionisse enne, kui kontroll lõpeb. Kontrolli aeg saab otsa 15 minuti pärast. Käivitus võib Autonomys ka pärast seda lõppeda, kuid Verceli kontroll enam ei muutu.
Uuesti käivitamine
Kui klõpsad Vercelis kontrollil Re-run, alustatakse sama juurutuse vastu uued käivitused lingi praeguste seadetega.
Kaitstud eelvaated
Kui Verceli Deployment Protection on sees, ei saa runner eelvaadet ilma möödapääsuta avada:
- Ava Vercelis projekti Settings → Deployment Protection ja kopeeri saladus Protection Bypass for Automation.
- Ava Autonomys lingitud Verceli projekt ja kleebi see välja Preview access secret.
Autonomy saadab selle iga päringuga selle projekti eelvaadetele. See salvestatakse saladusena ja seda ei näidata enam kunagi.
Mitu Verceli projekti
Lingi iga Verceli projekt eraldi. Igal lingil on oma Autonomy projekt, testiplaan, keskkond, päästiku tüübid ja harufiltrid, nii et veebirakenduse, dokumentatsiooni ja halduspaneeliga monorepo saab igaühe jaoks käivitada eri plaani.
Tõrkeotsing
Eelvaate juurutamisel ei alga ühtegi käivitust
Ava Autonomys lingitud Verceli projekt ja vaata viimaseid juurutusi. Vahele jäetud juurutus ütleb, miks:
project disabled: link on välja lülitatud.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 archivedvõi vaikeseade, mis on arhiveeritud või teises projektis: taasta projekt või vali uued vaikeseaded.no preview URL: Vercel ei saatnud juurutuse URL-i.
Kontrolli ka, et Vercel on Autonomys olekus Active.
Käivitus ei pääse eelvaatele ligi
Deployment Protection blokeerib selle. Lisa või uuenda Preview access secret.
Kontroll kukkus läbi, kuigi iga käivitus läbis
Fail the check on issues on sees ja mõni käivitus leidis vea. Ava käivituse Issues found.
Kontroll näitab olekut neutral
Mõni käivitus ei saanud alata, näiteks seetõttu, et eelvaade ei avanenud või blokeeris testbrauseri kui roboti. Ava käivitus, et näha põhjust, paranda see ja klõpsa Vercelis Re-run.
Ei leidnud?