Övning – Lägga till ett byggmärke

  • 7 minuter

Det är viktigt för teammedlemmar att känna till byggstatusen. Ett enkelt sätt att snabbt fastställa byggstatusen är att lägga till ett byggmärke i README.md-filen på GitHub. Vi tittar till teamet för att se hur det går till.

Andy är vid sitt skrivbord och går igenom e-post. Han svarar på det tredje e-postmeddelandet som är relaterat till byggstatusen för Space Game-webbplatsen .

Andy: Det måste finnas något sätt att automatisera ett statusmeddelande. Vi har pipelinen, och därför borde vi kunna lägga en status någonstans. Kanske vet Mara hur vi kan göra.

Andy ser att Mara pratar med Amita i fikarummet.

Hej, Amita. Kan jag låna Mara en stund?

Jag måste ändå komma till ett möte. Låna på!

Mara: Hej Andy. Hur är läget?

Andy: Jag gillar verkligen de ändringar vi har gjort i vår byggpipeline med hjälp av Azure Pipelines, och Git är ett bra versionskontrollsystem. Jag undrar, finns det ett sätt att låta folk veta byggstatus?

Mara: Ja, faktiskt. Vi kan använda ett byggmärke.

Vad är byggmärken?

Ett märke är en del av Microsoft Azure Pipelines. Den innehåller metoder som du kan använda för att lägga till en SVG-bild som visar status för bygget på din GitHub-lagringsplats.

De flesta GitHub-lagringsplatser innehåller en fil med namnet README.md, som är en Markdown-fil som innehåller viktig information och dokumentation om projektet. GitHub renderar den här filen på projektets startsida.

Här är ett exempel på ett byggmärke:

Skärmbild av GitHub som visar byggmärket. Statusen visar att den senaste versionen lyckades.

I den här övningen gör du byggmärket synligt för alla. Det kanske inte är en bra idé för dina privata projekt eftersom din bygginformation görs tillgänglig för allmänheten.

Så här kontrollerar du att byggmärket är synligt:

  1. I Azure DevOps navigerar du till din organisation.

  2. Välj Organisationsinställningar i det nedre hörnet.

  3. Under Pipelines väljer du Inställningar.

  4. Inaktivera Inaktivera anonym åtkomst till märken.

    Skärmbild av Azure DevOps som visar hur du inaktiverar anonym åtkomst till märken.

Du måste göra en liknande ändring i projektet:

  1. Gå till ditt projekt.
  2. Gå till Projektinställningar från det nedre hörnet.
  3. Under Pipelines väljer du Inställningar.
  4. Inaktivera Inaktivera anonym åtkomst till märken.

Lägga till byggmärket

Hittills har du skapat Git-grenarna lokalt för att göra ändringar i Space Game-projektet. Du kan även föreslå ändringar direkt via GitHub. I det här avsnittet gör du det för att konfigurera statusmärket.

  1. Välj Pipelines i den vänstra rutan i Azure DevOps och välj sedan din pipeline.

  2. Välj ellipsen (...) i det övre högra hörnet och välj sedan Statusikon.

    Skärmbild av Azure Pipelines som visar alternativmenyn för att ange byggmärket.

  3. Under Exempelmarkering väljer du knappen Kopiera för att kopiera Markdown-koden till Urklipp.

  4. Gå till ditt projekt i GitHub.

  5. Kontrollera att du är på main-grenen. Öppna filen README.md i filområdet.

  6. Välj Redigera den här filen (pennikonen) för att öppna filen i redigeraren.

  7. Överst på sidan lägger du till en tom rad och klistrar sedan in innehållet i Urklipp.

  8. Välj fliken Förhandsversion för att se dina föreslagna ändringar.

    GitHub renderar Markdown-filen och visar byggmärket.

    Skärmbild av GitHub som visar en förhandsgranskning av byggmärket.

Checka in ändringarna i main

I det här avsnittet checkar du in dina ändringar i grenen main på GitHub.

  1. Välj Genomför ändringar.

  2. I området Incheckningsmeddelande anger du ett incheckningsmeddelande, till exempel "Lägg till byggmärke".

    Skärmbild av GitHub som visar incheckningsmeddelandet.

  3. main vara markerat och välj sedan Checka in ändringar för att checka in ändringarna i grenenmain.

    Ditt märke visas på sidan README.md .

    Skärmbild av det slutliga byggmärket som visas på README-sidan.

    Den här processen är ett enklare sätt att sammanslå till GitHub. I stället för att checka in direkt hade du kunnat skapa en pull-begäran med dina ändringar som andra kunde granska.

    I praktiken byter du till grenen main och hämtar de senaste ändringarna från GitHub nästa gång du behöver lägga till en funktion eller åtgärda en bugg.

Andy: Mara, du har precis gjort en ändring direkt till main. Varför använde du inte det flöde som du lärde mig? Det där med funktionsgrenarna.

Mara: Vi kunde ha gjort det. Men ibland när personer bara ändrar README-filen eller andra dokumentationsfiler checkar de in till main just då. Dessutom kunde du och jag kontrollera arbetet tillsammans innan vi sammanslog ändringen.

Det här belyser dock en viktig punkt. Om vi alla bara kan checka in på main när vi vill kan vi låta problem i koden glida in i vår main gren.

Andy: Jag har tänkt prata med dig om det.

Andy och Mara fortsätter diskussionen medan de går tillbaka till sina kontor.