Oefening: een pull-aanvraag maken, beoordelen en samenvoegen

  • 5 minuten

U hebt het werk voltooid om een wachtrij toe te voegen aan uw website. Het team voor websiteontwikkeling is nu klaar om de wijzigingen in uw hoofdbranch samen te voegen. In deze oefening maakt en voegt u een pull-aanvraag voor uw wijzigingen samen.

Tijdens het proces gaat u het volgende doen:

  • Maak een pull-aanvraag.
  • Controleer de pull-aanvraag.
  • Voltooi de pull-aanvraag.
  • Controleer of de wijzigingen zijn samengevoegd.

Een pull-aanvraag maken om de functiebranch samen te voegen

Omdat u wijzigingen niet rechtstreeks naar de hoofdbranch van uw opslagplaats kunt pushen, moet u een pull-aanvraag maken.

  1. Ga in uw browser naar Code.

  2. Selecteer 2 vertakkingen om de vertakkingen in uw GitHub-opslagplaats weer te geven.

    Schermopname van GitHub die de opslagplaatspagina toont, waarbij de koppeling naar de vertakkingslijst gemarkeerd is.

  3. Selecteer naast wachtrij voor bestellingenhet pictogram Meer (...), en selecteer vervolgens Nieuwe pull-aanvraag indienen.

    Schermopname van GitHub met de vertakkingslijst. De knop voor een nieuwe pull-aanvraag is gemarkeerd voor de vertakking add-orders-queue.

  4. Wanneer u de pull-aanvraag hebt gemaakt, ziet u dat GitHub automatisch het Git-doorvoerbericht heeft gebruikt als de titel van de pull-aanvraag.

    Werk de beschrijving bij naar de volgende tekst:

    Met deze pull-aanvraag wordt een nieuwe Azure Storage-wachtrij toegevoegd voor het verwerken van orders en wordt de websiteconfiguratie bijgewerkt om het opslagaccount en de wachtrijgegevens op te nemen.

  5. Selecteer pull-aanvraag maken.

    Schermopname van GitHub waarop de pagina voor het maken van pull-aanvragen wordt weergegeven, met de knop voor het maken van een pull-aanvraag gemarkeerd.

  1. Ga in uw browser naar Repositories>Bestanden.

    U ziet dat In Azure DevOps een banner wordt weergegeven die aangeeft dat er wijzigingen zijn in de add-orders-queue branch. De banner biedt aan om een pull-aanvraag te maken voor deze wijzigingen.

    Schermopname van Azure DevOps waarin de bestandslijst van de opslagplaats wordt weergegeven, inclusief een banner die aanbiedt om een pull-aanvraag te maken.

  2. Selecteer Een pull-aanvraag maken.

  3. Op de pagina voor het maken van een pull-aanvraag ziet u dat Azure DevOps het Git-doorvoerbericht automatisch heeft gebruikt als titel van de pull-aanvraag.

    Werk de beschrijving bij naar de volgende tekst:

    Met deze pull-aanvraag wordt een nieuwe Azure Storage-wachtrij toegevoegd voor het verwerken van orders en wordt de websiteconfiguratie bijgewerkt om het opslagaccount en de wachtrijgegevens op te nemen.

  4. Selecteer maken.

    Schermopname van Azure DevOps waarop de pagina voor het maken van pull-aanvragen wordt weergegeven, met de knop voor het maken van een pull-aanvraag gemarkeerd.

De pull-aanvraag controleren

Normaal gesproken wordt een pull-aanvraag beoordeeld door iemand anders dan de auteur. In dit voorbeeld doet u zich voor als een ander teamlid en controleert u uw eigen pull-aanvraag.

  1. Selecteer op de pagina met pull-aanvragen het tabblad Bestanden gewijzigd.

    Schermopname van GitHub met het tabblad voor gewijzigde bestanden in een pull-aanvraag.

    GitHub toont u de bestanden die zijn gewijzigd in deze pull-aanvraag. U ziet dat alle lijnen worden gemarkeerd die zijn gewijzigd, zodat u gemakkelijk kunt zien wat u moet controleren.

    Tip

    Stel dat u dit bekijkt voor uw eigen team. Zou u suggesties doen?

  2. Beweeg in het bestand main.bicep dat is gewijzigd de muisaanwijzer over regel 18 en kies de knop met het plusteken (+).

    nl-NL: Schermopname van GitHub met wijzigingen in het main.bicep-bestand. De muisaanwijzer zweeft boven regel 18 en de knop voor het toevoegen van opmerkingen is gemarkeerd.

  3. Voer in het opmerkingenvak de volgende tekst in: Moet dit hoofdlettergebruik zijn?

  4. Selecteer Een beoordeling starten.

    Schermopname van GitHub waarin het opmerkingenveld wordt weergegeven, met de knop voor het starten van een beoordeling gemarkeerd.

    Tip

    Met GitHub kunt u uw eigen pull-aanvragen niet goedkeuren. Hier plaatst u een commentaar op uw pull request, maar u keurt deze niet goed. Wanneer u met de pull-aanvragen van uw eigen team werkt, is dit het punt waarop u het goedkeurt om aan te geven dat u tevreden bent dat het wordt samengevoegd.

  5. Selecteer Voltooi uw beoordeling.

  6. Selecteer in het controlevenster dat wordt weergegeven Beoordeling verzenden.

    Schermopname van GitHub waarin het deelvenster voor het voltooien van een beoordeling wordt weergegeven, met de knop voor het indienen van een beoordeling gemarkeerd.

    GitHub retourneert u naar het tabblad Gesprek van de pull-aanvraag.

  1. Selecteer op de pull request-pagina het tabblad Bestanden.

    schermopname van Azure DevOps waarin de bestanden worden weergegeven die zijn gewijzigd in de pull-aanvraag.

    Azure DevOps toont u de bestanden die zijn gewijzigd in deze pull-aanvraag. U ziet dat alle gewijzigde regels gemarkeerd worden, zodat u eenvoudig kunt zien wat u moet beoordelen.

    Fooi

    Stel dat u dit bekijkt voor uw eigen team. Zou u suggesties doen?

  2. In het bestand main.bicep dat is gewijzigd, zweef boven regel 18 en selecteer de knop Commentaar.

    Schermafbeelding van Azure DevOps die wijzigingen in het belangrijkste bicep-dot-bestand toont. De muisaanwijzer zweeft boven regel 18 en de knop voor het toevoegen van een opmerking is gemarkeerd.

  3. Voer in het opmerkingenvak de volgende tekst in: Moet dit hoofdlettergebruik zijn?

  4. Selecteer en opmerking.

    Schermopname van Azure DevOps met het veld Opmerking, met de knop Opmerking gemarkeerd.

    De breedte van je browservenster kan van invloed zijn op hoe het opmerkingenvenster wordt weergegeven. De opmerking opent een dialoogvenster Discussie in plaats van de inline-opmerking, zoals wordt weergegeven in de schermafbeelding.

  5. Selecteer goedkeuren.

    schermopname van Azure DevOps met de knop Goedkeuren voor de pull-aanvraag.

    Nadat u Goedkeurenhebt geselecteerd, verandert de instelling Automatisch voltooien naar Volledig. U zult deze functie later in deze eenheid gebruiken.

Reageren op de beoordeling van de pull-aanvraag

Wanneer u een pull-aanvraag maakt of bekijkt, kunt u deelnemen aan een gesprek over de inhoud ervan. Stel dat u de auteur van dit bestand bent en dat u wilt reageren op een opmerking van de revisor.

  1. Reageer op de beoordeling van de pull-aanvraag met de volgende opmerking: Nee, opslagwachtrijen moeten kleine letters hebben.

  2. Selecteer opmerkingen selecteer vervolgens Markeer als opgelost om aan te geven dat de discussie in de conversatie voorbij is.

    Schermopname van GitHub waarin het antwoord op een opmerking wordt weergegeven, met de knoppen voor het invoeren van een opmerking en het oplossen van een gesprek gemarkeerd.

  1. Selecteer op de pull request-pagina het tabblad Overzicht.

    Schermopname van Azure DevOps met het tabblad Overzicht.

  2. Stel dat u de auteur van dit bestand bent. Reageer op de beoordeling van de pull-aanvraag met de volgende opmerking: Nee, opslagwachtrijen moeten kleine letters hebben.

  3. Selecteer Beantwoorden & oplossen om aan te geven dat de discussie op de regel voorbij is.

    Schermopname van Azure DevOps waarin het antwoord op een opmerking wordt weergegeven, met de knop voor beantwoorden en oplossen gemarkeerd.

De pull-aanvraag voltooien

Het ontwikkelteam van uw website heeft bevestigd dat het gereed is voor u om de orders naar de wachtrij te verzenden, zodat u klaar bent om uw pull-aanvraag te voltooien en samen te voegen.

Uw pull-aanvraag is goedgekeurd. Het ontwikkelteam van uw website heeft bevestigd dat het gereed is voor u om de orders naar de wachtrij te verzenden, zodat u klaar bent om uw pull-aanvraag te voltooien en samen te voegen.

  1. Selecteer Pull-aanvraag samenvoegen.

    Schermopname van GitHub met een pull-aanvraag met de knop voor het samenvoegen gemarkeerd.

  2. GitHub vraagt u om de samenvoegbewerking te bevestigen. Wanneer GitHub de pull-aanvraag samenvoegt, wordt er een doorvoer gemaakt en wordt automatisch een doorvoerbericht gegenereerd. Selecteer Bevestig samenvoegen.

    Schermopname van GitHub met een pull-aanvraag met de knop voor het bevestigen van een samenvoeging gemarkeerd.

    Uw pull-aanvraag wordt samengevoegd en uw nieuwe functie bevindt zich nu in de hoofdbranch van uw opslagplaats.

  3. Het is een goed idee om uw functievertakkingen te verwijderen wanneer u er klaar mee bent. Door vertakkingen te verwijderen, voorkomt u in de toekomst verwarring onder de teamleden over welk werk nog in uitvoering is. Selecteer Verwijder vertakking.

    Schermopname van GitHub met een pull-aanvraag met de knop voor het verwijderen van een vertakking gemarkeerd.

  1. Selecteer voltooien.

    schermopname van Azure DevOps met de knop Volledig voor een pull-aanvraag.

  2. Gebruik in "Voltooi pull-aanvraag ",de standaardinstellingen. Selecteer Samenvoegen voltooien.

    schermopname van Azure DevOps waarin het deelvenster met voltooiing van pull-aanvragen wordt weergegeven, met de knop voor het voltooien van een samenvoegbewerking gemarkeerd.

    Uw pull-aanvraag wordt samengevoegd en uw nieuwe functie bevindt zich nu in de hoofdbranch van uw opslagplaats.

    Azure DevOps heeft de functiebranch automatisch verwijderd toen u de pull-aanvraag hebt samengevoegd. Het is een goed idee om uw functievertakkingen te verwijderen wanneer u er klaar mee bent. Door vertakkingen te verwijderen, voorkomt u dat teamleden in de toekomst in de war raken over welk werk nog gaande is.

De wijzigingen controleren

Nadat u een pull-aanvraag hebt samengevoegd, is het een goed idee om te bevestigen dat de wijzigingen zijn samengevoegd.

  1. Ga naar Code.

  2. Ga naar het bestand deploy/main.bicep en ga vervolgens naar het bestand deploy/modules/appService.bicep.

    Schermopname van GitHub waarin de bestandslijst van de opslagplaats wordt weergegeven nadat de pull-aanvraag is samengevoegd.

    U ziet dat de wachtrij en uw andere wijzigingen zich nu in de bestanden bevinden.

  1. Ga naar repositories>bestanden.

  2. Ga naar het bestand deploy/main.bicep en ga vervolgens naar het bestand deploy/modules/appService.bicep.

    U ziet dat de wachtrij en uw andere wijzigingen zich nu in de bestanden bevinden.