wikijs/services/gitea.md
2021-09-01 21:05:57 +02:00

3.7 KiB

title description published date tags editor dateCreated
Gitea true 2021-04-13T17:06:49.806Z markdown 2021-03-24T20:04:53.409Z

Nutzung von Gitea

Der Zugang zu Gitea ist aktuell eingeschränkt, da (noch) keine Quota umgesetzt ist. Möchtest du Gitea nutzen musst du den Zugang zunächst beantragen.

Zugang beantragen

Der Zugang zu Gitea kann über ein Add-On im Pretix System beantragt werden. Fordere einfach Gutschein an und löse diesen unter membership.bstly.de ein. Nach Genehmigung des Antrages bekommst du wieder eine E-Mail zum einlösen des Token für deinen Account. Nachdem du das Token eingelöst hast ist der Zugang für dich aktiviert.

Basis Anleitung

Dies ist nur eine kurze Anleitung um mit Gitea und Git zu starten. Eine Anleitung zur Installation von Git findest du bei Atlassian.com. Ausführlichere Anleitungen zum fortgeschrittenen Themen wie Branches oder Pull-Requests findest du sicher über eine Suchmaschine deiner Wahl oder frage beim Support nach.

Da dein Zugang auch über OIDC eingerichtet wird, hast du kein Passwort für diesen Service gesetzt. Es wird daher empfohlen deine Repositories alle über den SSH-Zugang zu verwalten. {.is-warning}

SSH-Zugang

Eine einfach Anleitung zum erzeugen von SSH-Schlüsseln findest du bei Heise.de. {.is-info}

Nachdem du eingeloggt bist, klicke rechts oben auf dein Avatar und wähle Einstellungen aus. Anschließend wählst du den Tab SSH- / GPG-Schlüssel aus. Klicke bei SSH-Schlüssel verwalten auf Schlüssel hinzufügen, kopiere deinen Öffentlichen SSH Schlüssel in das Textfeld Inhalt und lade so deinen Schlüssel hoch.

Neues Repository erstellen

Eine neues Repository erstellst du einfach über das +-Symobol oben rechts. Bis auf einen Namen musst du grundsätzlich nichts weiter angeben. Du solltest dir aber noch überlegen ob dein Repository öffentlich (Standard) ist oder du lieber ein privates Repository anlegen möchtest. Für ein privates Reporitory aktivere einfach die entsprechende Schaltfläche.

Repository lokal einrichten

Um dein Repository nun auf deinem Computer einzurichten kannst du folgende Befehle verwenden.

git init
git config --global user.name "{username}"
git config --global user.email "{username}@we.bstly.de"
git checkout -b main

Nun kannst du Dateien hinzufügen wie z.B. eine README.md mit einer Beschreibung. Anschließend kannst mit folgenden Befehlen deine ersten Dateien hochladen und die Verbindung zu deinem Gitea Repository herstellen.

Achte auf die korrekte Url. Wenn du kein Passwort angegegen hast, wähle undebdingt die SSH-Url aus. {.is-warning}

git add .
git commit -m "{first commit}"
git remote add origin ssh://gitea@git.bstly.de:222/{username}/{repository}.git
git push -u origin main

Lokale Änderungen übernehmen

Hast du Dateien in deinem lokalen Repository verändert, hinzugefügt oder gelöscht kannst du diese Änderungen mit drei kurzen Befehlen in dein Gitea Repository übernehmen.

git add .
git commit -m "{commit message}"
git push

Entfernte Änderungen übernehmen

Haben sich Dateien in deinem Gitea Repository geändert reicht der Befehl git pull in der Regel aus um die Änderungen in dein lokales Reposirtoy zu übernehmen.