68 lines
3.7 KiB
Markdown
68 lines
3.7 KiB
Markdown
---
|
|
title: Gitea
|
|
description:
|
|
published: true
|
|
date: 2021-04-13T17:06:49.806Z
|
|
tags:
|
|
editor: markdown
|
|
dateCreated: 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 <a name="application" id="application"></a>
|
|
|
|
Der Zugang zu Gitea kann über ein Add-On im [Pretix](/de/services/pretix) System beantragt werden. Fordere einfach [Gutschein](/de/services/webstly#voucher) an und löse diesen unter [membership.bstly.de](https://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 <a name="guide" id="guide"></a>
|
|
|
|
Dies ist nur eine kurze Anleitung um mit *Gitea* und *Git* zu starten. Eine Anleitung zur Installation von *Git* findest du bei [Atlassian.com](https://www.atlassian.com/de/git/tutorials/install-git). Ausführlichere Anleitungen zum fortgeschrittenen Themen wie *Branches* oder *Pull-Requests* findest du sicher über eine Suchmaschine deiner Wahl oder frage beim [Support](/de/help#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](#ssh) zu verwalten.
|
|
{.is-warning}
|
|
|
|
## SSH-Zugang <a name="ssh" id="ssh"></a>
|
|
|
|
> Eine einfach Anleitung zum erzeugen von *SSH-Schlüsseln* findest du bei [Heise.de](https://www.heise.de/tipps-tricks/SSH-Key-erstellen-so-geht-s-4400280.html).
|
|
{.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 <a name="repository" id="repository"></a>
|
|
|
|
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 <a name="local" id="local"></a>
|
|
|
|
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. |