1. Nettdesign og utvikling Hvordan sette opp et GitHub-arkiv

Av Sarah Guthals

Et GitHub-arkiv er en mappe med alle filene som trengs for prosjektet ditt, inkludert filene som sporer alle versjonene av prosjektet ditt, slik at du kan gå tilbake hvis du gjør en feil. Et depot på GitHub sporer også hvem som kan samarbeide og hvordan.

For å få en bedre forståelse av hva et depot er og hvordan det er strukturert, må du lage din første GitHub-repo:

GitHubs nye arkivsideGitHub HelloWorld

Informasjon øverst i GitHub-depotet

Øverst i depotet er brukernavnet til forfatteren og tittelen på depotet. Når du gaffler et depot, ser du den opprinnelige forfatteren under for en hurtigkobling. Å gaffle et depot er å lage en kopi av det, der endringene du gjør i kopien din kan foreslås for den opprinnelige forfatteren.

Til høyre for brukernavnet ditt er tre knapper:

  • Se: Du kan velge hva slags varslinger du vil motta basert på type aktivitet som skjer på denne repoen. Stjerner: Stjerner kan hjelpe deg med å raskt navigere til bestemte depoter, samt gi GitHub innsikt i ting du er interessert i, slik at anbefalingene blir mer nøyaktige for deg. For å få tilgang til stjernemerkede lagre, klikker du bare på avataren din øverst til høyre på GitHub.com og velger Dine stjerner. Gaffel: Hvis du ikke er forfatteren til depotet, har du muligheten til å gaffel det.

Vi anbefaler på det sterkeste å velge enten Ikke se eller slippe ut bare for de fleste depotene, slik at du bare får varsler når du spesielt er nevnt eller aktivt deltar i en diskusjon om et problem eller en pull-forespørsel. Ellers blir innboksen din fylt med e-postmeldinger om hver eneste handling som gjøres på depotet, som vil komme ut av hånden veldig raskt. Hvis du merker at dette skjer, kan du gå til GitHub.com og fjerne alle eller noen av depotene du ser på med et raskt klikk.

Faner på GitHub-depotet

Syv faner vises over toppen av repoen din. Hver fane har forskjellige funksjoner for repoen:

  • Kode: Koden-fanen er der du kan finne all koden og bla gjennom mapper og filer. Du kan klikke på en fil for å se innholdet eller klikke på blyantikonet for å endre filen rett i nettleseren din. (Se den kommende delen "Kode-fanen" for mer informasjon.) Problemer: Utgaver er en veldig fin funksjon for repos. Problemer kan hjelpe deg med å spore ting du fremdeles vil gjøre, problemer du har eller forslag til andre mennesker. Trekkforespørsler: Trekkforespørsler, også referert til som PR-er, ligner på problemer ved at de har en tittel og en beskrivelse, men de har også kodeendringer som du ber om å bli trukket inn i hovedgrenen. Den tryggeste måten å bidra med kode på er å opprette en ny gren, gjøre koden endringer på den grenen og deretter be om at grenen skal slås sammen med hovedgrenen. En PR gir deg et grensesnitt for sammenslåing av de to grenene, og viser deg diffen mellom filene du har endret og de som er på mastergrenen, og gir deg et sted å snakke med samarbeidspartnere om koden skal slås sammen eller endres bør lages først. Prosjekter: Du er kanskje allerede kjent med prosjekttavler som Trello eller Kanboard. GitHub har prosjekttavler som er direkte knyttet til repoen din. Det beste er at kortene på et GitHub-prosjekttavle kan være direkte relatert til problemer eller PR-er og automatisk kan bevege seg når noe skjer. Wiki: Wikier er et flott sted å lagre dokumentasjon, prosjektstatus og veikart for prosjektet ditt. Det er et flott sted for samarbeidspartnere å se hva som skjer og hvor de kan hoppe inn for å hjelpe! Insights: Fanen Insights, vist i figuren nedenfor, gir deg en oversikt over alle samarbeidspartnere og handlinger som skjer på repoen. Det er veldig koselig å se denne fanen på populære open source-prosjekter. For eksempel har TensorFlow hatt 158 ​​bidragsytere den siste måneden! Innstillinger: Innstillinger-fanen er bare synlig hvis du har riktige tillatelser på depotet. I denne fanen kan du bestemme hvem som har tilgang til hva og hvordan samarbeidspartnere skal samarbeide. Du kan også integrere apper som forteller deg hvor mye av koden din som er dekket med tester.
Fanen GitHub Insights

Kodefanen i GitHub-depotet

Koden-fanen, vist i følgende figur, har mange ekstra viktige metadata om repoen din som vil komme til nytte i fremtidig utvikling:

  • Beskrivelse og emner: Øverst i kategorien Kode er en beskrivelse og et sted der du kan legge inn emner for å gjøre depotet ditt mer synlig. Det er spesielt viktig å legge til emner hvis du vil tiltrekke deg andre kodere som hjelper deg med å bygge programvaren. Metadata: Denne linjen inneholder informasjon og lenker til antall forpliktelser, grener, utgivelser og bidragsytere for repoen. Handlingsknapper: På venstre side av repoen er en rullegardinmeny der du kan endre hvilken gren du ser på eller bla gjennom filene for en bestemt gren. Med knappen Ny forespørsel kan du raskt opprette en trekkforespørsel. Den beste måten å opprette en pull-forespørsel er å bytte til en annen gren, gjøre noen endringer og deretter klikke på New pull-forespørsel. På høyre side er tre knapper relatert til filer: Lag ny fil, Last opp filer og Finn fil. Til slutt kan du klikke på den grønne klonen eller laste ned rullegardinlisten for å klone eller laste ned koden til din lokale maskin. Kode: Nederst i kategorien Kode er en liste over alle koden i denne repoen. Hvis en md-fil vises i denne listen, vises filen under listen. For en hvilken som helst fil kan du klikke på filnavnet for å gå til en side der du kan se filen og redigere den hvis du vil.
Kategorien GitHub-kode
  1. Nettdesign og utvikling Tiltak med GitHub-handlinger

Av Sarah Guthals

GitHub har en funksjon som fjerner behovet for å være vertskap for appen vår utenfor GitHub, noe som kan redusere antall bevegelige deler når du utvider GitHub. Denne funksjonen kalles GitHub-handlinger.

GitHub Actions er en av de nyere, mest spennende funksjonene i GitHub. I skrivende stund er det fortsatt en betafunksjon. GitHub-handlinger gjør det mulig å lage tilpassede arbeidsflyter på GitHub. Den lar deg implementere tilpasset logikk for å svare på hendelser på GitHub. I forrige seksjon skrev vi en GitHub-app for å gjøre det. Med GitHub-handlinger trenger vi ikke å lage en tilpasset app. Vi kan bygge arbeidsflyter ved å bruke eksisterende handlinger som andre har skrevet, eller vi kan skrive våre egne handlinger som kjører i en Docker-beholder.

Forhåpentligvis, når du leser dette, er GitHub-handlinger generelt tilgjengelige. Men i tilfelle de fremdeles er i beta, kan du sende en e-post til support@github.com og be om å være i GitHub Actions-betaprogrammet.

For å demonstrere GitHub-handlinger, vurder følgende scenario. Når du fusjonerer en trekkforespørsel i ditt eget depot, stikker grenen for trekkforespørselen rundt. GitHub presenterer en knapp for å slette grenen, men mange glemmer å gjøre det og lar disse grenene holde seg rundt.

Å ikke slette grenen er ikke nødvendigvis en dårlig ting, med mindre du er den typen personer som liker at ting er ryddig og ikke kan tåle å ha en gren som ikke lenger trenger å henge med. Hvis du er den typen personer, har du flaks. Jesse Frazelle er også den typen personer, og hun skrev en GitHub-handling du kan bruke i dine egne arbeidsflyter. Blogginnlegget hennes, “The Life of a GitHub Action” er en god lese for å forstå flere detaljer om livssyklusen til en GitHub-handling.

Opprette en arbeidsflyt fra GitHub-handlingen

Hvis du er blitt akseptert i beta-programmet GitHub Actions, eller det har blitt mer tilgjengelig, bør du se en ekstra fane øverst merket Handlinger når du ser et depot.

Følgende trinn går gjennom prosessen for å lage en arbeidsflyt fra GitHub for et depot.

GitHub-arbeidsflyterGitHub enkle arbeidsflyter

Testing av en GitHub-handling

Etter at du har forpliktet denne filen til depotet ditt, er arbeidsflyten aktiv. Du kan teste den ved å opprette en ny trekkeforespørsel og deretter slå den sammen. Noen sekunder eller minutter senere skal du se at grenen for trekkforespørsel ble slettet. En oppdatering på pull-forespørselen sier noe som

github-actions bot slettet grenenavnet for 1 minutt siden

Du kan lage ganske nyttige og komplekse arbeidsflyter ved å bruke eksisterende handlinger. Du kan installere handlinger fra GitHub Marketplace eller referere dem ved å peke til et depot som inneholder en handling. Du kan også skrive tilpassede handlinger. Hvordan du gjør det er utenfor rammen for denne artikkelen, men du kan se på handlingen som Jesse skrev for å få et inntrykk av hva som trengs.

Med GitHub-handlinger kan du tilpasse GitHub til din smak på nesten ubegrensede måter.