Kapitel 6: Remote-Repositories Grundlagen

6.1 Remote-Repository-Konzept

📖 Was ist ein Remote-Repository?

Ein Remote-Repository ist eine zentrale Version Ihres Projekts, die auf einem Server gehostet wird.

Warum Remote-Repositories?

✅ Backup: Ihr Code ist sicher auf einem Server gespeichert
✅ Teamkollaboration: Mehrere Entwickler können am selben Projekt arbeiten
✅ Zugriff von überall: Sie können von jedem Computer auf Ihr Projekt zugreifen

🌐 Gängige Plattformen

Plattform	URL	Besonderheit
GitHub	github.com	Marktführer, Open-Source-freundlich
GitLab	gitlab.com	Integrierte CI/CD-Pipelines
Bitbucket	bitbucket.org	Gute Jira-Integration
Gitee	gitee.com	Chinesische Alternative (GitHub-ähnlich)
Azure DevOps	dev.azure.com	Microsoft-Lösung (Enterprise)

6.2 Gängige Remote-Plattformen nutzen (GitHub/Gitee)

🔹 GitHub (Empfohlen für Open-Source)

Schritt 1: Account erstellen

Besuchen Sie https://github.com/
Klicken Sie auf "Sign up"
Folgen Sie den Anweisungen

Schritt 2: Neues Repository erstellen

Klicken Sie auf das "+"-Symbol (oben rechts)
Wählen Sie "New repository"
Füllen Sie das Formular aus:
- Repository name: mein-projekt
- Description: (Optional) "Mein erstes Git-Projekt"
- Public/Private: Wählen Sie "Public" (oder "Private")
- ✅ Add a README file: (Empfohlen)
- ✅ Add .gitignore: Wählen Sie eine Vorlage (z.B. Node, Python)
Klicken Sie auf "Create repository"

Schritt 3: Repository-Einstellungen

Settings: Repository-Einstellungen (Sichtbarkeit, Branches schützen)
Collaborators: Teammitglieder hinzufügen
Branches: Default-Branch ändern (main/master)

🔹 Gitee (Chinesische Alternative)

Schritt 1: Account erstellen

Besuchen Sie https://gitee.com/
Klicken Sie auf "注册" (Registrieren)
Folgen Sie den Anweisungen

Schritt 2: Neues Repository erstellen

Klicken Sie auf das "+"-Symbol
Wählen Sie "新建仓库" (Neues Repository)
Füllen Sie das Formular aus:
- 仓库名称: mein-projekt
- 仓库介绍: (Optional) "Mein erstes Git-Projekt"
- 是否开源: Öffentlich/Privat
- ✅ 初始化仓库: (Empfohlen)
Klicken Sie auf "创建" (Erstellen)

📊 GitHub vs. Gitee

Merkmal	GitHub	Gitee
Sprache	Englisch	Chinesisch
Geschwindigkeit (China)	Langsam	Schnell
Open Source	Sehr stark	Mittel
CI/CD	GitHub Actions	Gitee Go
Kosten	Kostenlos (Private Repos begrenzt)	Kostenlos (mehr Features)

6.3 Lokales Repository mit Remote verknüpfen (`git remote`)

📖 Was ist `git remote`?

git remote verwaltet die Verbindung zwischen Ihrem lokalen Repository und dem Remote-Repository.

🔹 1. Remote hinzufügen (`git remote add`)

bash

# Remote-Repository hinzufügen
git remote add origin https://github.com/benutzer/mein-projekt.git

# Überprüfen, ob Remote hinzugefügt wurde
git remote -v

# Ausgabe-Beispiel:
# origin  https://github.com/benutzer/mein-projekt.git (fetch)
# origin  https://github.com/benutzer/mein-projekt.git (push)

Erklärung:

origin: Standardname für das Remote-Repository (können Sie ändern)
https://...: URL des Remote-Repositories

🔹 2. Remote anzeigen (`git remote -v`)

bash

# Alle Remotes anzeigen
git remote -v

# Details zu einem Remote anzeigen
git remote show origin

🔹 3. Remote-URL ändern (`git remote set-url`)

bash

# URL des Remotes ändern (z.B. von HTTPS zu SSH)
git remote set-url origin git@github.com:benutzer/mein-projekt.git

# Überprüfen
git remote -v

🔹 4. Remote entfernen (`git remote remove`)

bash

# Remote entfernen
git remote remove origin

# Überprüfen
git remote -v

6.4 Kern-Grundbefehle für Remote-Repositories

🔹 1. `git push` (Lokale Änderungen hochladen)

bash

# Änderungen zum Remote-Repository pushen
git push origin main

# Beim ersten Mal: Upstream-Branch setzen
git push -u origin main

# Alle Branches pushen
git push --all origin

Optionen:

Option	Erklärung
`-u` / `--set-upstream`	Setzt den Upstream-Branch (danach reicht `git push`)
`--force` / `-f`	Erzwungenes Pushen (⚠️ Vorsicht!)
`--all`	Alle Branches pushen

🔹 2. `git pull` (Remote-Änderungen herunterladen & mergen)

bash

# Änderungen vom Remote-Repository pullen (fetch + merge)
git pull origin main

# Wenn Upstream gesetzt ist, reicht:
git pull

Was passiert?

git fetch: Änderungen werden heruntergeladen
git merge: Änderungen werden in Ihren lokalen Branch gemergt

🔹 3. `git fetch` (Remote-Änderungen herunterladen, aber nicht mergen)

bash

# Änderungen herunterladen (ohne zu mergen)
git fetch origin

# Alle Remotes fetchen
git fetch --all

Vorteil: Sie können die Änderungen zuerst überprüfen, bevor Sie mergen.

Verwendung:

bash

# 1. Fetch durchführen
git fetch origin

# 2. Änderungen anzeigen (ohne zu mergen)
git log HEAD..origin/main

# 3. Wenn alles OK ist, mergen
git merge origin/main

📊 Vergleich: `git pull` vs. `git fetch`

Aspekt	`git pull`	`git fetch`
Aktion	Fetch + Merge	Nur Fetch
Sicherheit	Weniger sicher (direkt gemergt)	Sicherer (Sie können zuerst prüfen)
Empfehlung	Für Einsteiger	Für Fortgeschrittene

6.5 Remote-Repository Praxisbeispiel

📝 Szenario: Lokales Projekt zu GitHub pushen

Schritt 1: Lokales Repository erstellen

bash

mkdir mein-projekt
cd mein-projekt
git init
echo "# Mein Projekt" > README.md
git add .
git commit -m "Initialer Commit"

Schritt 2: Remote-Repository auf GitHub erstellen

Siehe Abschnitt 6.2 (GitHub: Neues Repository erstellen)

Schritt 3: Remote hinzufügen

bash

git remote add origin https://github.com/benutzer/mein-projekt.git

Schritt 4: Änderungen pushen

bash

git push -u origin main

Schritt 5: Auf GitHub überprüfen

Besuchen Sie https://github.com/benutzer/mein-projekt
Sie sollten Ihre Dateien sehen! 🎉

📝 Szenario: Remote-Repository klonen (Download)

bash

# Repository klonen
git clone https://github.com/benutzer/mein-projekt.git

# In das Projektverzeichnis wechseln
cd mein-projekt

# Änderungen vornehmen
echo "Neue Zeile" >> README.md
git add .
git commit -m "Update: README aktualisiert"

# Änderungen pushen
git push origin main

6.6 Remote-Repository-Zugriffsberechtigungen

🔹 1. Repository-Sichtbarkeit

Sichtbarkeit	Erklärung
Public	Jeder kann das Repository sehen (Klonen erlaubt)
Private	Nur Sie und eingeladene Mitarbeiter können es sehen

🔹 2. Mitarbeiter hinzufügen (GitHub)

Gehen Sie zu Ihrem Repository auf GitHub
Klicken Sie auf "Settings"
Klicken Sie auf "Collaborators" (in der Seitenleiste)
Klicken Sie auf "Add people"
Suchen Sie nach dem GitHub-Benutzernamen
Klicken Sie auf "Add collaborator"
Der Benutzer erhält eine Einladung (muss annehmen)

🔹 3. Authentifizierung (HTTPS vs. SSH)

Methode 1: HTTPS (Einfach)

bash

# Beim Pushen werden Sie nach Benutzernamen und Token gefragt
git push origin main

# Benutzername: Ihr GitHub-Benutzername
# Passwort: Ihr Personal Access Token (PAT)  ← Nicht Ihr Passwort!

Token erstellen (GitHub):

Gehen Sie zu Settings > Developer settings > Personal access tokens
Klicken Sie auf "Generate new token"
Wählen Sie die Berechtigungen (repo, workflow)
Klicken Sie auf "Generate token"
Kopieren Sie den Token sofort (wird nur einmal angezeigt!)

Methode 2: SSH (Sicherer & Komfortabler)

Schritt 1: SSH-Key erstellen

bash

# SSH-Key erstellen
ssh-keygen -t ed25519 -C "ihre-email@example.com"

# (Einfach Enter drücken für Standardeinstellungen)

Schritt 2: SSH-Key zu GitHub hinzufügen

Kopieren Sie den öffentlichen Key:

bash

# Windows
cat ~/.ssh/id_ed25519.pub

# Mac/Linux
cat ~/.ssh/id_ed25519.pub

Gehen Sie zu Settings > SSH and GPG keys
Klicken Sie auf "New SSH key"
Fügen Sie den Key ein
Klicken Sie auf "Add SSH key"

Schritt 3: Repository-URL auf SSH umstellen

bash

# URL von HTTPS auf SSH umstellen
git remote set-url origin git@github.com:benutzer/mein-projekt.git

# Testen
git push origin main

📊 HTTPS vs. SSH

Aspekt	HTTPS	SSH
Einfachheit	Einfacher (kein Key-Management)	Komplexer (Key-Management)
Sicherheit	Mittel (Token kann leaken)	Hoch (Key ist verschlüsselt)
Komfort	Weniger komfortabel (Token eingeben)	Sehr komfortabel (kein Passwort)
Empfehlung	Für Einsteiger	Für Fortgeschrittene / tägliche Arbeit

📝 Zusammenfassung

In diesem Kapitel haben Sie gelernt:

✅ Was Remote-Repositories sind und warum sie wichtig sind
✅ GitHub/Gitee verwenden (Account erstellen, Repository erstellen)
✅ Lokales Repository mit Remote verknüpfen (git remote add)
✅ Kern-Grundbefehle (git push, git pull, git fetch)
✅ Praxisbeispiel (Lokales Projekt pushen, Remote klonen)
✅ Zugriffsberechtigungen (Mitarbeiter hinzufügen, Authentifizierung)

Nächstes Kapitel: Wir werden Teamkollaboration behandeln (Klonen, Branching-Strategien, Merge-Konflikte in Teams).

Kapitel 6: Remote-Repositories Grundlagen ​

6.1 Remote-Repository-Konzept ​

📖 Was ist ein Remote-Repository? ​

🌐 Gängige Plattformen ​

6.2 Gängige Remote-Plattformen nutzen (GitHub/Gitee) ​

🔹 GitHub (Empfohlen für Open-Source) ​

Schritt 1: Account erstellen ​

Schritt 2: Neues Repository erstellen ​

Schritt 3: Repository-Einstellungen ​

🔹 Gitee (Chinesische Alternative) ​

Schritt 1: Account erstellen ​

Schritt 2: Neues Repository erstellen ​

📊 GitHub vs. Gitee ​

6.3 Lokales Repository mit Remote verknüpfen (git remote) ​

📖 Was ist git remote? ​

🔹 1. Remote hinzufügen (git remote add) ​

🔹 2. Remote anzeigen (git remote -v) ​

🔹 3. Remote-URL ändern (git remote set-url) ​

🔹 4. Remote entfernen (git remote remove) ​

6.4 Kern-Grundbefehle für Remote-Repositories ​

🔹 1. git push (Lokale Änderungen hochladen) ​

🔹 2. git pull (Remote-Änderungen herunterladen & mergen) ​

🔹 3. git fetch (Remote-Änderungen herunterladen, aber nicht mergen) ​

📊 Vergleich: git pull vs. git fetch ​

6.5 Remote-Repository Praxisbeispiel ​

📝 Szenario: Lokales Projekt zu GitHub pushen ​

📝 Szenario: Remote-Repository klonen (Download) ​

6.6 Remote-Repository-Zugriffsberechtigungen ​

🔹 1. Repository-Sichtbarkeit ​

🔹 2. Mitarbeiter hinzufügen (GitHub) ​

🔹 3. Authentifizierung (HTTPS vs. SSH) ​

Methode 1: HTTPS (Einfach) ​

Methode 2: SSH (Sicherer & Komfortabler) ​

📊 HTTPS vs. SSH ​

📝 Zusammenfassung ​

🔗 Weiterführende Links ​

Kapitel 6: Remote-Repositories Grundlagen

6.1 Remote-Repository-Konzept

📖 Was ist ein Remote-Repository?

🌐 Gängige Plattformen

6.2 Gängige Remote-Plattformen nutzen (GitHub/Gitee)

🔹 GitHub (Empfohlen für Open-Source)

Schritt 1: Account erstellen

Schritt 2: Neues Repository erstellen

Schritt 3: Repository-Einstellungen

🔹 Gitee (Chinesische Alternative)

Schritt 1: Account erstellen

Schritt 2: Neues Repository erstellen

📊 GitHub vs. Gitee

6.3 Lokales Repository mit Remote verknüpfen (`git remote`)

📖 Was ist `git remote`?

🔹 1. Remote hinzufügen (`git remote add`)

🔹 2. Remote anzeigen (`git remote -v`)

🔹 3. Remote-URL ändern (`git remote set-url`)

🔹 4. Remote entfernen (`git remote remove`)

6.4 Kern-Grundbefehle für Remote-Repositories

🔹 1. `git push` (Lokale Änderungen hochladen)

🔹 2. `git pull` (Remote-Änderungen herunterladen & mergen)

🔹 3. `git fetch` (Remote-Änderungen herunterladen, aber nicht mergen)

📊 Vergleich: `git pull` vs. `git fetch`

6.5 Remote-Repository Praxisbeispiel

📝 Szenario: Lokales Projekt zu GitHub pushen

📝 Szenario: Remote-Repository klonen (Download)

6.6 Remote-Repository-Zugriffsberechtigungen

🔹 1. Repository-Sichtbarkeit

🔹 2. Mitarbeiter hinzufügen (GitHub)

🔹 3. Authentifizierung (HTTPS vs. SSH)

Methode 1: HTTPS (Einfach)

Methode 2: SSH (Sicherer & Komfortabler)

📊 HTTPS vs. SSH

📝 Zusammenfassung

🔗 Weiterführende Links