GitHub nach Codeberg spiegeln
Ein GitHub-Actions-Workflow, der Branches und Tags mit einfachem git push über SSH nach Codeberg spiegelt, ohne Action von Dritten.
Geprüft von adrian
am
Ich wollte für mein Repository ein zweites Zuhause, falls GitHub irgendwann verschwindet oder seltsam wird, und Codeberg lag nahe. Was ich nicht wollte, war noch eine Action aus dem Marketplace auf diesem Weg. Ein einfaches git push über SSH reicht.
Das Ziel
- Bei jedem Push auf
mainvon GitHub nach Codeberg spiegeln. - Keine Abhängigkeit von Dritten im Workflow.
- Nur Branches und Tags: ein sauberes Repository, in das keine
origin/*-Refs durchsickern.
Ein eigener SSH-Schlüssel
Der Spiegel soll keinen vorhandenen Schlüssel mitbenutzen. Ich habe lokal ein neues ed25519-Paar nur für diesen Zweck erzeugt:
ssh-keygen -t ed25519 -C "github-actions-codeberg-mirror" -f ~/.ssh/codeberg_mirror -N ""
Die Schlüssel an die richtigen Stellen
Die beiden Hälften des Paares gehören auf entgegengesetzte Seiten, und sie zu verwechseln ist der häufigste Grund, warum es nicht klappt.
- Deploy-Key bei Codeberg (
Repository → Settings → Deploy keys): den Inhalt von~/.ssh/codeberg_mirror.pubeinfügen. Allow write access einschalten, sonst kann der Spiegel nicht pushen. - Secret bei GitHub (
Settings → Secrets and variables → Actions):CODEBERG_SSHmit dem Inhalt von~/.ssh/codeberg_mirroranlegen, also dem privaten Schlüssel.
Meldet ein Formular Key is invalid. You must supply a key in OpenSSH public key format, ist der private Schlüssel dort gelandet, wo der öffentliche hingehört. Tausch sie.
Der Workflow
Datei: .github/workflows/sync-mirror.yml:
name: Mirror to Codeberg
on:
push:
branches: [main]
workflow_dispatch:
schedule:
- cron: '30 0 * * 0'
jobs:
codeberg:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
with:
fetch-depth: 0
- name: Configure SSH
run: |
mkdir -p ~/.ssh
printf '%s\n' "${{ secrets.CODEBERG_SSH }}" > ~/.ssh/id_ed25519
chmod 600 ~/.ssh/id_ed25519
ssh-keyscan -H codeberg.org >> ~/.ssh/known_hosts
cat <<'EOF' > ~/.ssh/config
Host codeberg.org
HostName codeberg.org
User git
IdentityFile ~/.ssh/id_ed25519
IdentitiesOnly yes
EOF
- name: Verify SSH access
run: |
ssh -T git@codeberg.org || true
git ls-remote git@codeberg.org:adrian-altner/website.git > /dev/null
- name: Mirror to Codeberg
run: |
git remote add mirror git@codeberg.org:adrian-altner/website.git
# Remove previously mirrored remote-tracking refs (for example refs/remotes/origin/*).
while IFS= read -r ref; do
git push mirror ":${ref}"
done < <(git ls-remote --refs mirror 'refs/remotes/*' | awk '{print $2}')
# Mirror only real branches and tags.
git push --prune mirror \
+refs/heads/*:refs/heads/* \
+refs/tags/*:refs/tags/*
Drei Auslöser: jeder Push auf main, ein Knopf für workflow_dispatch und ein wöchentlicher Cron am Sonntag um 00:30 UTC. Der Cron ist das Sicherheitsnetz, falls ein Ausfall bei Codeberg einmal einen Push unbemerkt verschluckt.
Der Spiegel-Schritt macht zwei Dinge nacheinander. Erst räumt er alle refs/remotes/* weg, die in früheren Läufen hineingerutscht sind: Ich hatte ein paar refs/remotes/origin/* aus einem älteren Setup auf Codeberg, und sie kamen immer wieder. Dann pusht er refs/heads/* und refs/tags/* ausdrücklich, mit --prune, damit Löschungen auf GitHub mitkommen, statt sich anzuhäufen. --mirror hätte jeden Remote-Tracking-Ref gleich mitgenommen.
Was du beim Testen siehst
Bei einem erfolgreichen SSH-Handshake meldet Forgejo, auf dem Codeberg läuft:
... successfully authenticated ... but Forgejo does not provide shell access.
Das ist kein Fehler. Der Server verweigert eine Shell, nimmt fetch und push aber an. Siehst du die Meldung, hat die Anmeldung geklappt.
Zum Mitnehmen
- Ein Schlüssel, ein Zweck: Den Schlüssel des Spiegels zu widerrufen trifft nie etwas anderes.
- Ausdrückliche Refspecs statt
--mirrorhalten das Ziel sauber.
Beruht auf
-
Mirroring GitHub to Codeberg Without a Third-Party Action
(
raw/2026/2026-03-05/mirroring-github-to-codeberg-without-a-third-party-action.md) [post]
Mehr dazu
Thema
- Self-Hosting Dienste auf einem Server betreiben, über den du selbst verfügst, statt die gehostete Fassung eines Anbieters zu nutzen.
Siehe auch
- GitHub-Deploy-Key auf einem VPS Ein Deploy-Key mit reinem Lesezugriff, damit ein VPS ohne Personal Access Token und ohne Passwort von GitHub pullen kann.