Beskriva inre källa med gafflarna

Slutförd

Personer förgrenar lagringsplatser när de vill ändra koden på en lagringsplats som de inte behöver skriva åtkomst till.

Om du inte har skrivåtkomst ingår du inte i teamet som bidrar till lagringsplatsen, så varför skulle du ändra kodlagringsplatsen?

Vi brukar leta efter tekniska skäl för att förbättra något i vårt arbete.

Du kan hitta ett bättre sätt att implementera lösningen eller förbättra funktionaliteten genom att bidra till eller förbättra en befintlig funktion.

Du kan förgrena lagringsplatser i följande situationer:

  • Jag vill göra en ändring.
  • Jag tycker att projektet är spännande och kanske vill använda det.
  • Jag vill använda kod på lagringsplatsen som utgångspunkt för mitt projekt.

Programvaruteam uppmuntras att bidra till alla projekt internt, inte bara sina programvaruprojekt.

Gafflarna är ett bra sätt att främja en kultur med inre öppen källkod.

Gafflar är ett nytt tillägg till Azure DevOps Git-lagringsplatserna.

Det här receptet lär dig att förgrena en befintlig lagringsplats och bidra med ändringar uppströms via en pull-begäran.

Gör dig redo

En fork börjar med allt innehåll från sitt uppströms (ursprungliga) arkiv.

När du skapar en förgrening i Azure DevOps kan du inkludera alla grenar eller begränsa dem till endast standardgrenen.

En förgrening kopierar inte behörigheter, principer eller versionsdefinitioner för lagringsplatsen som förgrenas.

När en förgrening har skapats delas inte de nyligen skapade filerna, mapparna och grenarna mellan lagringsplatserna om du inte startar en pull-begäran.

Pull-begäranden stöds i båda riktningarna: från förgrening till uppströms eller uppströms till förgrening.

Den vanligaste metoden för en pull request är från fork till uppströms.

Så här gör du det

  1. Välj knappen Förgrening (1) och välj sedan det projekt där du vill att förgreningen ska skapas (2). Ge din förgrening ett namn och välj knappen Förgrening (3).

  2. När din förgrening är klar klonar du den med hjälp av kommandoraden eller en IDE, till exempel Visual Studio. Forken kommer att vara ditt ursprungsfjärr. För enkelhetens skull vill du lägga till den ursprungliga lagringsplatsen (där du forkade från) som en fjärranslutning med namnet upstream. På kommandoraden skriver du:

    git remote add upstream {upstream_url}
    
  3. Det går att arbeta direkt i huvudgrenen – den här förgreningen är din kopia av lagringsplatsen. Vi rekommenderar dock att du fortfarande arbetar i en ämnesgren. Det gör att du kan underhålla flera oberoende arbetsströmmar samtidigt. Dessutom minskar förvirring senare när du vill synkronisera ändringar i din fork. Gör och checka in dina ändringar som vanligt. När du har slutfört ändringarna skickar du dem till ursprunget (din förgrening).

  4. Öppna en pull-begäran från din förgrening till uppströms. Den överordnade lagringsplatsen tillämpar alla principer som krävs för granskare och versioner. När alla policyer är uppfyllda kan PR:n slutföras och ändringarna blir en permanent del av det överordnade arkivet.
    diagram som visar hur man skapar en pull-begäran.

  5. När din PR accepteras i huvudprojektet måste du se till att din förgrening återspeglar det senaste tillståndet i lagringsplatsen. Vi rekommenderar att du bygger om på den överordnade huvudgrenen (förutsatt att huvudgrenen är den huvudsakliga utvecklingsgrenen). På kommandoraden kör du:

    git fetch upstream main
    git rebase upstream/main
    git push origin
    

Mer information om Git finns i: