GitHub til AI-byggede apps: hvorfor og hvordan kommer I i gang?

Kort fortalt: Hvad er GitHub?

GitHub er en onlinetjeneste til projekter, der bruger versionsstyringen Git. Jeres repository er projektets mappe med kode og ændringshistorik. En commit er et navngivet øjebliksbillede af ændringerne, og en branch er et separat spor, hvor nye ændringer kan afprøves, før de bliver en del af den stabile version.

Hvorfor er GitHub vigtigt, når appen allerede virker?

En prototype kan sagtens fungere uden et ordentligt repository. Problemet viser sig ofte først ved den næste ændring, når ingen længere kan se præcist, hvad der blev ændret, eller hvordan man kommer tilbage til versionen fra før fejlen.

• Ejerskab: Virksomheden har selv adgang til den aktuelle kode og historikken.
• Sporbarhed: Hver ændring kan kobles til en dato, en person og en forklaring.
• Sikker afprøvning: Nye funktioner kan bygges på en branch uden at ændre den stabile version med det samme.
• Samarbejde: En anden udvikler kan få afgrænset adgang uden at få tilsendt en gammel kopi af projektet.
• Automatisering senere: GitHub Actions kan efterfølgende teste og udgive nye versioner fra samme repository.

Før I opretter repositoryet

Brug ti minutter på at afklare ejerskab og følsomme oplysninger. Det er langt nemmere end at flytte projektet eller rotere lækkede nøgler bagefter.

1. 1. Brug virksomhedens konto eller organisation. Repositoryet bør ikke kun ligge på en ekstern udviklers private konto.
2. 2. Start privat. Vælg et privat repository, medmindre I bevidst vil udgive koden offentligt.
3. 3. Find hemmeligheder før første upload. API-nøgler, adgangskoder, private nøgler og filer som .env må ikke med i repositoryet.
4. 4. Aftal den stabile branch. For et lille projekt er main et fint navn til den version, der må sættes i drift.

Sådan kommer I i gang uden kommandolinjen

GitHub Desktop er den mest overskuelige vej for mange, fordi commits, branches, push og pull kan håndteres i et grafisk program. GitHubs officielle dokumentation anbefaler også Desktop som en begyndervenlig måde at lære den normale arbejdsgang.

Den enkle arbejdsgang bagefter

Når repositoryet er oprettet, behøver hverdagen ikke være kompliceret:

1. 1. Hent seneste version med Pull, før I begynder.
2. 2. Lav én afgrænset ændring ad gangen.
3. 3. Gennemse de ændrede filer i GitHub Desktop.
4. 4. Skriv en kort commit-besked om, hvad der blev ændret og hvorfor.
5. 5. Send committen til GitHub med Push.

Når flere arbejder på løsningen, bør ændringer ske på branches og samles gennem pull requests. Det giver en synlig gennemgang, før ændringen lander på main.

Tjekliste: er fundamentet på plads?

• □ Virksomheden har ejerskab eller administrativ adgang.
• □ Repositoryet er privat, medmindre offentlig kode er et bevidst valg.
• □ Ingen adgangskoder, tokens, private nøgler eller persondata ligger i historikken.
• □ main indeholder en kendt, fungerende version.
• □ README forklarer kort, hvad appen gør, og hvordan den startes lokalt.
• □ Det er aftalt, hvem der må godkende og udgive ændringer.
• □ Data, filer og eksterne tjenester har en separat backup-plan.

Hvad er næste skridt?

Når koden og historikken er samlet i GitHub, er næste naturlige skridt at lade GitHub Actions kontrollere appen automatisk. Et simpelt workflow kan bygge og teste hver ændring, før den bliver udgivet. Den del får sin egen guide, fordi en halvfærdig workflowfil kan give falsk tryghed.