Pull request-gennemgange
De fleste hændelser begynder med en ændring. Polylane gennemgår hver pull request i et forbundet repository mod de produktionsressourcer, den deployer til, og poster én kommentar, der siger pass eller fail.
Hvad det gør
En agent læser diffen og de live metrikker, logs og åbne issues for de ressourcer, repositoryet deployer til, og beslutter derefter, om ændringen kan skade produktion. Du får én kommentar på pull requesten, et valgfrit Polylane production impact-check og en tråd i konsollen med den fulde analyse.
Sådan fungerer det
- At åbne en pull request mod standardbranchen, pushe til den eller markere den som klar til gennemgang starter en gennemgang af dens head-commit. Drafts gennemgås ikke.
- Et senere push erstatter den igangværende gennemgang, så kun den seneste commit bedømmes.
- Ændringer, der kun berører dokumentation, tests eller CI-filer, passerer uden en undersøgelse.
- Polylane følger repositoryets deploy-kanter til dets produktionsressourcer eller gennemgår mod arbejdsområdets cloudkonti som helhed, når det ikke har nogen.
- Agenten undersøger i en tråd og registrerer en
pass- ellerfail-vurdering. - Én kommentar pr. pull request redigeres ved hver gennemgang. Et fail lyder Hold this merge med påvirkningsniveauet og fundet; et pass lyder Production impact unlikely eller siger, om en rettelse af et opdaget issue forventes at løse det. Når et senere push adresserer en bekymring, skifter kommentaren tilbage til et pass og siger det.
Agenten kan også foreslå observability-forbedringer, som én samlet gennemgang af forslagskommentarer eller en stacked pull request. De påvirker aldrig vurderingen.
Handl på en gennemgang
Nævn @polylane i en kommentar på pull requesten, og Polylane svarer i den samme samtale; ikke-medlemmer modtager i stedet en note om adgang.
| Du beder om | Hvad der sker |
|---|---|
| Et spørgsmål | Agenten svarer fra gennemgangstråden med beviserne foran sig. |
| Et nyt blik | Agenten gennemgår det seneste push igen og genovervejer vurderingen. |
| En rettelse | Polylane starter et fix run og åbner en stacked pull request mod pull requestens branch, linket fra kommentaren. |
Repositoryets Changes-fane i konsollen lister hver gennemgang. Et fail tilbyder Fix with Polylane, som starter det samme fix run, og Dismiss, når bekymringen ikke gælder: pull requesten bliver ved med at blive gennemgået, men får ikke flere kommentarer, før du bruger Restore på den.
| Status | Beskrivelse |
|---|---|
| In review | Polylane gennemgår det seneste push. |
| Flagged | Gennemgangen fandt en produktionsbekymring. |
| Passed | Ingen produktionsbekymringer fundet. |
| Resolved | Et senere push adresserede bekymringerne. |
| Dismissed | Et medlem afviste gennemgangen; pull requesten får ikke flere kommentarer. |
Konfigurer
Gennemgange er slået til for hvert forbundet repository. Settings > Pull request reviews slår dem fra for hele arbejdsområdet og bestemmer, om gennemgangstråde deles med dem, der ser pull requesten. Under Settings > Repositories tilføjer et repositorys Settings-fane tre felter.
| Felt | Beskrivelse |
|---|---|
| Review pull requests for production impact | Slår gennemgange fra for dette repository alene. |
| Pull request review instructions | Fri tekst, agenten læser ved hver gennemgang: deploy-kritiske stier, eller bekymringer andre gates allerede håndterer. |
| Block merging on production concerns | Poster Polylane production impact-checket på hver gennemgået pull request; det fejler ved en bekymring. Slået til som standard. Kræv det i branch protection for at blokere merge. |
Checket fuldføres også på merge queue-commits, da pull requesten blev gennemgået, før den kom i køen. En fail-vurdering kan sende e-mailen Production Concern Found, slået fra som standard under Notifikationer.
Bemærkninger om planer
Hver plan indeholder et månedligt antal pull request-gennemgange; Free-planens kvote er angivet under Fakturering og forbrug, og medlemmer får en e-mail, når den er ved at være opbrugt. Ud over kvoten registrerer konsollen pull requesten som Production impact not verified, og intet postes til GitHub.
Relateret
- Repositories for at forbinde et repository og koble dets ressourcer.
- Fix runs for hvordan en gennemgangstråd når sin vurdering.
- Autofix for de pull requests, et fix run åbner.
- Notifikationer for den e-mail, en fejlet gennemgang kan sende.