1. Webdesign og -udvikling Sådan opsættes et GitHub-arkiv

Af Sarah Guthals

Et GitHub-arkiv er en mappe med alle de nødvendige filer til dit projekt, inklusive de filer, der sporer alle versionerne af dit projekt, så du kan vende tilbage, hvis du laver en fejl. Et arkiv på GitHub sporer også, hvem der kan samarbejde og hvordan.

For at få en bedre forståelse af, hvad et lager er, og hvordan det er struktureret, skal du oprette din første GitHub-repo:

GitHub ny opbevaringssideGitHub HelloWorld

Oplysninger øverst på dit GitHub-lager

Øverst på depotet er brugernavnet på forfatteren og navnet på depotet. Når du gaffler et lager, ser du den originale forfatter nedenunder for et hurtigt link. At gaffel et lager er at oprette en kopi af det, hvor ændringerne, du foretager i din kopi, kan foreslås til den oprindelige forfatter.

Til højre for dit brugernavn er der tre knapper:

  • Se: Du kan vælge, hvilken type meddelelser du vil modtage, baseret på den type aktivitet, der sker på denne repo. Stjerner: Stjerner kan hjælpe dig med hurtigt at navigere til bestemte lagre samt give GitHub indsigt i ting, du er interesseret i, så anbefalinger bliver mere nøjagtige for dig. For at få adgang til dine stjernemarkerede opbevaringer skal du bare klikke på din avatar øverst til højre på GitHub.com og vælge Dine stjerner. Gaffel: Hvis du ikke er forfatteren til depotet, har du muligheden for at gaffel det.

Vi anbefaler stærkt at vælge enten ikke at se eller frigive kun for de fleste depoter, så du kun får underretninger, når du specifikt er nævnt eller aktivt deltager i en diskussion om et spørgsmål eller en pull-anmodning. Ellers vil din indbakke blive fyldt med e-mails om hver enkelt handling, der udføres på depotet, som vil komme ud af hånden meget hurtigt. Hvis du bemærker, at dette sker, skal du gå til GitHub.com og fjerne alle eller nogle af de oplagringssteder, du ser, med et hurtigt klik.

Faner på dit GitHub-arkiv

Syv faner vises på toppen af ​​din repo. Hver fane indeholder forskellige funktioner til repoen:

  • Kode: Fanen Kode er, hvor du kan finde al din kode og gennemse mapper og filer. Du kan klikke på en fil for at se dens indhold eller klikke på blyantikonet for at ændre filen lige i din internetbrowser. (Se det kommende afsnit "Kode-fane" for at få flere oplysninger.) Problemer: Problemer er en virkelig pæn funktion til repos. Problemer kan hjælpe dig med at spore ting, du stadig vil gøre, problemer, du har, eller forslag til andre mennesker. Trækforespørgsler: Trækforespørgsler, også benævnt PR'er, ligner emner, idet de har en titel og en beskrivelse, men de har også kodeændringer, som du anmoder om at blive trukket ind i hovedgrenen. Den sikreste måde at bidrage med kode er at oprette en ny gren, foretage dine kodeændringer på den gren og derefter anmode om, at grenen skal slås sammen med mastergrenen. En PR giver dig en grænseflade til sammenlægning af de to grene, der viser dig diffen mellem de filer, du har ændret, og dem, der er på mastergrenen, og giver dig et sted at føre en samtale med samarbejdspartnere om, hvorvidt koden skal slås sammen eller ændres skal laves først. Projekter: Du er muligvis allerede bekendt med projekttavler som Trello eller Kanboard. GitHub har projekttavler, der er direkte knyttet til din repo. Det bedste er, at kortene på et GitHub-projektbræt kan være direkte relateret til problemer eller PR'er og automatisk kan flytte sig, når der sker noget. Wiki: Wikier er et fantastisk sted at gemme dokumentation, projektstatus og køreplaner for dit projekt. Det er et fantastisk sted at gå sammen for samarbejdspartnere at se, hvad der foregår, og hvor de kan hoppe ind for at hjælpe! Insights: Fanen Insights, vist i følgende figur, giver dig et overblik over alle samarbejdspartnere og handlinger, der sker på repoen. Det er virkelig pænt at se denne fane på populære open source-projekter. For eksempel har TensorFlow haft 158 ​​bidragydere i den sidste måned! Indstillinger: Fanen Indstillinger er kun synlig, hvis du har de rigtige tilladelser på depotet. På denne fane kan du beslutte, hvem der har adgang til, hvad og hvordan samarbejdspartnere skal samarbejde. Du kan også integrere apps, der fortæller dig, hvor meget af din kode der er dækket med test.
Fanen GitHub Insights

Kode-fanen i dit GitHub-lager

Fanen Kode, der er vist i følgende figur, har en masse yderligere vigtige metadata om din repo, som kommer til nytte i fremtidig udvikling:

  • Beskrivelse og emner: Øverst på fanen Kode er en beskrivelse og et sted, hvor du kan placere emner for at gøre dit lager mere synligt. Tilføjelse af emner er især vigtigt, hvis du vil tiltrække andre kodere til at hjælpe dig med at opbygge din software. Metadata: Denne bjælke indeholder information og links til antallet af forpligtelser, filialer, udgivelser og bidragydere til repoen. Handlingsknapper: På venstre side af repoen er en rullemenu, hvor du kan ændre, hvilken gren du ser på eller gennemse filerne for en bestemt gren. Den nye pull-anmodningsknap giver dig mulighed for hurtigt at oprette en pull-anmodning. Den bedste måde at oprette en pull-anmodning er at skifte til en anden filial, foretage nogle ændringer og derefter klikke på New pull-anmodning. På højre side er tre knapper relateret til filer: Opret ny fil, Upload filer og Find fil. Endelig kan du klikke på den grønne klon eller downloade rulleliste for at klone eller downloade koden til din lokale maskine. Kode: Nederst på fanen Kode er der en liste over alle koder i denne repo. Hvis der vises en md-fil på denne liste, vises filen under listen. For enhver fil kan du klikke på filnavnet for at gå til en side, hvor du kan se filen og redigere den, hvis du vil.
Fanen GitHub-kode
  1. Webdesign og -udvikling Gør handling med GitHub-handlinger

Af Sarah Guthals

GitHub har en funktion, der fjerner behovet for at være vært for vores app uden for GitHub, hvilket kan reducere antallet af bevægelige dele, når GitHub udvides. Denne funktion kaldes GitHub-handlinger.

GitHub-handlinger er en af ​​de nyere, mest spændende funktioner i GitHub. I skrivende stund er det stadig en betafunktion. GitHub-handlinger gør det muligt at oprette tilpassede arbejdsgange på GitHub. Det giver dig mulighed for at implementere tilpasset logik til at reagere på begivenheder på GitHub. I det foregående afsnit skrev vi en GitHub-app for at gøre det. Med GitHub-handlinger behøver vi ikke at oprette en brugerdefineret app. Vi kan opbygge arbejdsgange ved hjælp af eksisterende handlinger, som andre har skrevet, eller vi kan skrive vores egne handlinger, der kører i en Docker-container.

Forhåbentlig, når du læser dette, er GitHub-handlinger generelt tilgængelige. Men i tilfælde af at de stadig er i beta, e-mail [email protected] og beder om at være i GitHub Actions-betaprogrammet.

Overvej følgende scenario for at demonstrere GitHub-handlinger. Når du fusionerer en pull-anmodning i dit eget depot, holder filialen til pull-anmodningen sig rundt. GitHub præsenterer en knap for at slette grenen, men mange glemmer at gøre det og lader disse grene klæbe rundt.

At slette grenen er ikke nødvendigvis en dårlig ting, medmindre du er den type person, der kan lide, at tingene er ryddige og ikke kan tåle at have en gren, der ikke længere har brug for at blive ved. Hvis du er den type person, er du heldig. Jesse Frazelle er også den type person, og hun skrev en GitHub-handling, du kan bruge i dine egne arbejdsgange. Hendes blogindlæg, "The Life of a GitHub Action" er en god læsning for at forstå flere detaljer om livscyklussen for en GitHub-handling.

Oprettelse af en GitHub-arbejdsgang

Hvis du er blevet accepteret i beta-programmet GitHub Actions, eller det er blevet mere udbredt, skal du se en ekstra fane øverst mærket Handlinger, når du ser et lager.

Følgende trin gennemgår processen til oprettelse af en GitHub-handlingsflyd til et depot.

GitHub-arbejdsgangeGitHub enkle arbejdsgange

Test af en GitHub-handling

Når du har overført denne fil til dit arkiv, er arbejdsgangen aktiv. Du kan teste den ved at oprette en ny pull-anmodning og derefter flette den. Et par sekunder eller minutter senere skal du se, at grenen for pull-anmodning blev slettet. En opdatering af pull-anmodningen siger noget lignende

github-actions bot slettede grenens navngren for 1 minut siden

Du kan oprette temmelig nyttige og komplekse arbejdsgange ved hjælp af eksisterende handlinger. Du kan installere handlinger fra GitHub Marketplace eller henvise til dem ved at pege på et arkiv, der indeholder en handling. Du kan også skrive tilpassede handlinger. Hvordan man gør det er uden for denne artikels rækkevidde, men du kan se på handlingen, som Jesse skrev for at få en idé om, hvad det kræver.

Med GitHub-handlinger kan du tilpasse GitHub til din smag på næsten ubegrænsede måder.