Tjenester/Kodelager: Difference between revisions

From Programvareverkstedet
Move contents from Drift/Gitea
 
Expand a bit
Line 1: Line 1:
Gitea er en tjeneste vi bruker for å oppbevare og dele kode.
Gitea er en tjeneste vi bruker for både å oppbevare, dele, og samarbeide på kode og andre filer.
Du kan bruke den som et alternativ til GitHub eller IDI GitLaben.
Du kan bruke den som et alternativ til GitHub eller IDI GitLaben.
Den kjører på [[Maskiner/bekkalokk]] og er tilgjengelig på https://git.pvv.ntnu.no
Den kjører på [[Maskiner/bekkalokk]] og er tilgjengelig på https://git.pvv.ntnu.no
Line 9: Line 9:
På loginsiden kan du logge inn med vanlig PVV-brukernavn og passord
På loginsiden kan du logge inn med vanlig PVV-brukernavn og passord


=== Lag og klon et nytt repo ===
=== Lag og klon en ny kodebrønn (repository) ===


1. Trykk på "New Repository" i menyen i øvre høyre hjørne
1. Trykk på "New Repository" i menyen i øvre høyre hjørne
Line 24: Line 24:


[[File:Gitea_create_repo_3.png|thumb|center|500px|Klon repo]]
[[File:Gitea_create_repo_3.png|thumb|center|500px|Klon repo]]
=== Speiling av kodebrønner ===
Gitea støtter speiling av kodebrønner både til og fra flere kilder. PVV bruker selv å speile en del prosjekter mot GitHub (se https://github.com/Programvareverkstedet). For å komme i gang med speiling, kan du lese mer her:
Hvis du skal speile til en GitHub-brønn eller fra en privat GitHub-brønn må du forsyne Gitea med en token. Vi anbefaler deg å bruke en ny


=== Bruk av CI ===
=== Bruk av CI ===


Se https://docs.gitea.com/usage/actions/quickstart#use-actions
Se https://docs.gitea.com/usage/actions/quickstart#use-actions for generell bruk.
 
For prosjektbrønner har vi satt opp et system for å forhåndsgenerere tokens for å publisere html-dokumenter fra CI. Tokenen er lagret under id <code>WEB_SYNC_SSH_KEY</code>. I tillegg finnes det en heimbrent byggekloss som simplifiserer prosessen. Du kan finne eksempel på bruk her: https://git.pvv.ntnu.no/Projects/rsync-action/src/branch/main/.gitea/workflows/test.yml


== Historie ==
== Historie ==

Revision as of 22:25, 8 March 2025

Gitea er en tjeneste vi bruker for både å oppbevare, dele, og samarbeide på kode og andre filer. Du kan bruke den som et alternativ til GitHub eller IDI GitLaben. Den kjører på Maskiner/bekkalokk og er tilgjengelig på https://git.pvv.ntnu.no

Bruk

For generell bruk, se https://docs.gitea.com/category/usage

På loginsiden kan du logge inn med vanlig PVV-brukernavn og passord

Lag og klon en ny kodebrønn (repository)

1. Trykk på "New Repository" i menyen i øvre høyre hjørne

Klikk "New Repository"

2. Fyll inn feltene du føler er nødvendig. De 2 viktigste er:

  * "Repository Name" - navnet på repoet
  * "Visibility Level" - om repoet skal være offentlig eller privat
Opprett nytt repo

3. Følg instruksjonene for å klone repoet, ev. spør noen i drift om hjelp.

Klon repo

Speiling av kodebrønner

Gitea støtter speiling av kodebrønner både til og fra flere kilder. PVV bruker selv å speile en del prosjekter mot GitHub (se https://github.com/Programvareverkstedet). For å komme i gang med speiling, kan du lese mer her:

Hvis du skal speile til en GitHub-brønn eller fra en privat GitHub-brønn må du forsyne Gitea med en token. Vi anbefaler deg å bruke en ny

Bruk av CI

Se https://docs.gitea.com/usage/actions/quickstart#use-actions for generell bruk.

For prosjektbrønner har vi satt opp et system for å forhåndsgenerere tokens for å publisere html-dokumenter fra CI. Tokenen er lagret under id WEB_SYNC_SSH_KEY. I tillegg finnes det en heimbrent byggekloss som simplifiserer prosessen. Du kan finne eksempel på bruk her: https://git.pvv.ntnu.no/Projects/rsync-action/src/branch/main/.gitea/workflows/test.yml

Historie

Tidlig 2023 ble både TRAC og Gogs tatt ned, og byttet ut med Gitea. De fleste repoer ble migrert (med unntak av noen vi ikke fant kildekode for i datamappene), og det ble satt opp prosjektgrupper for repo-er som tidligere var samarbeidsprosjekter. Repo-er hvor vi så at det hovedsakelig var én person som jobbet, ble omgjort til brukerens personlige repo.