Del via

Behandle en pull-forespørsel

  • Artikkel

Når du har åpnet en pull-forespørsel (PR), gjennomgår PR et sett med kontroller og anmeldelser for å sikre at de foreslåtte endringene kan slås sammen. Hvis du vil ha mer bakgrunn på PC-er, kan du se grunnleggende om Git og GitHub.

Validering

Før pr-forespørselen kan slås sammen til målgrenen, kan det være nødvendig å gå gjennom én eller flere PR-valideringsprosesser. Når du har valgt Opprett pull-forespørsel, kjører GitHub valideringene som er konfigurert for repositoriet. Når valideringsprosessen er ferdig, vises resultatene i pr.

Valideringsprosesser varierer avhengig av omfanget av foreslåtte endringer og reglene for målrepositoriet. Når du har sendt inn en pr, kan du forvente at ett eller flere av følgende skal skje:

  • Sammenslåing: En gitHub-sammenslåingstest for grunnlinje forekommer først for å bekrefte om de foreslåtte endringene i grenen er i konflikt med målgrenen. Hvis pr indikerer at denne testen mislyktes, må du avstemme innholdet som forårsaker sammenslåingskonflikten før behandlingen kan fortsette.
  • Bidragslisensavtale (CLA): Hvis du bidrar til et offentlig repositorium, kan du bli bedt om å fullføre en kort CLA første gang du sender inn en PR til det repositoriet. Når CLA-trinnet er fjernet, behandles pr-forespørselen din.
  • Merking: Etiketter brukes automatisk på pr for å indikere tilstanden til pr-forespørselen når den passerer gjennom valideringsarbeidsflyten. Nye PC-er kan for eksempel automatisk motta «do-not-merge»-etiketten, noe som angir at pr ennå ikke har fullført trinnene for validering, gjennomgang og avlogging.
  • Validering og build: Automatiserte kontrollerer verifiserer om endringene dine består valideringstester. Valideringstestene kan gi advarsler eller feil, noe som krever at du redigerer én eller flere filer i pull-forespørselen før den kan slås sammen. Resultatene for valideringstesten legges til som en kommentar i pr for din gjennomgang, og de kan bli sendt til deg via e-post.
  • Oppsamling: Ved vellykket validering og bygg distribueres artiklene du endret automatisk til et oppsamlingsmiljø for gjennomgang. Forhåndsvisning av URL-adresser vises i en PR-kommentar.
  • Automatisk fletting: Pr-forespørselen kan automatisk slås sammen hvis den består valideringstesting og bestemte kriterier. I dette tilfellet trenger du ikke å gjøre noe annet.

Se gjennom og adressere tilbakemeldinger

Når all PR-behandling er fullført, bør du se gjennom resultatene (for eksempel PR-kommentarer, byggresultater). Avgjør om du må gjøre flere endringer før du logger av for fletting. Du må kanskje endre innholdet av følgende årsaker:

  • PR-kommentarer fra anmeldere. Hvis en PR-anmelder har gjennomgått pr-forespørselen din, kan de gi tilbakemelding via kommentarer hvis det er utestående problemer eller spørsmål som skal løses før fletting.
  • Tilbakemeldinger fra nodelesere.
  • Formateringsløsninger på grunn av gjengivelsesproblemer.
  • Valideringsfeil eller advarsler.
  • Slå sammen konflikter.

Hvis du trenger å gjøre endringer, kan du redigere innholdet direkte i pr, eller du kan gå tilbake til VS Code for å gjøre endringene. Når du er ferdig, må du utføre endringene i arbeidsgrenen. Pr oppdateres automatisk med endringene.

Hver gang du legger til en utføring i den samme arbeidsgrenen, legges utføringen automatisk til pr. For hver utføring kjører publiseringssystemet automatisk validerings- og gjennomgangsprosessene på nytt.

Påloggings- og kommentarautomatisering

Når du har adressert alle tilbakemeldinger og valideringsfeil, og du er klar for at endringene skal slås sammen, er det på tide å logge av på pr ved å opprette en ny kommentar som leser #sign-off. Du må skrive inn #sign-off kommentaren for å slå sammen endringene. Selv om alle anmeldelser og valideringskontroller passerer, er du ansvarlig for å bruke denne kommentaren til å fortelle PR-anmeldere og repoadministratorer at endringene er klare for sammenslåing.

Når korrekturleserne fastslår at pr-en er problemfri og logget av, slås endringene sammen til standardgrenen, og pr-forespørselen lukkes.

Kommentarautomatisering gjør det mulig for brukere som ikke har skrivetillatelser i et repo å fullføre en handling på skrivenivå ved å tilordne riktig etikett til en PR. Hvis du arbeider i et repo der kommentarautomatisering er implementert, kan du bruke emneknaggkommentarene som er oppført i tabellen nedenfor til å tilordne etiketter, endre etiketter eller lukke en PR. Microsoft-forfattere blir også varslet via e-post for gjennomgang og avlogging når det foreslås endringer i artiklene.

Hashtagkommentar Hva det gjør
#sign-off Tilordner automatisk etiketten som er klar til å flette , slik at korrekturleserne i repo vet at pr er klar for gjennomgang/fletting.

Hvis du ikke er den oppførte forfatteren og prøver å logge av på en offentlig repo-PR ved hjelp av #sign-off kommentaren, oppdateres PR-forespørselen for å angi at bare forfatteren kan tilordne etiketten.
#hold-off Fjerner etiketten for klar til fletting i tilfelle du ombestemmer deg eller gjør en feil. I privat repo tilordnes dette ikke slå sammen-etiketten.
#please-close Lukker pull-forespørselen hvis du bestemmer deg for ikke å slå sammen endringene.
#please-open Åpner en lukket pr eller et lukket problem på nytt.

Publisering

Pr-forespørselen må slås sammen av en PR-korrekturleser før endringene kan inkluderes i neste planlagte publiseringskjøring. Vanligvis blir PR-er gjennomgått og slått sammen i innsendingsrekkefølgen.

Når bidragene dine er godkjent og slått sammen, henter publiseringsprosessen dem opp. Avhengig av teamet som administrerer repositoriet du bidrar til, kan publiseringstiden variere, men de forekommer vanligvis minst én gang hver ukedag. Det kan ta opptil 45 minutter før artikler vises på nett etter publisering.

Når endringene er publisert, går de direkte på Microsoft Learn for andre å begynne å lære av!

Neste trinn

Det var det! Du har gjort et bidrag til Microsoft Learn-innhold!