Bitbucket Repository einrichten

Praktische Anleitung zur Einrichtung eines Git-Repositories in Bitbucket

Voraussetzungen

Du hast Zugriff auf das Git-Tool Bitbucket
Git (inkl. Git-Bash) ist auf deinem Computer installiert. Falls nicht, siehe: Git installieren

Du hast die Grundeinstellungen für Git vorgenommen:

git config --global user.name "u123456"  
git config --global user.email "u123456@sbb.ch"

# Für Windows zusätzlich:

git config --global core.autocrlf true  
git config --global core.longpaths true

1
2
3
4
5
6
7
git config --global user.name "u123456"  
git config --global user.email "u123456@sbb.ch"

# Für Windows zusätzlich:

git config --global core.autocrlf true  
git config --global core.longpaths true  

Wende dich an deinen Praxisbildner, falls du nicht bei der SBB arbeitest (und falls Du bei SBB arbeitest, kannst du in der !*Konfiguartion die spezifischen Anleitungen und Informationen freischalten -> Wahl der Ausbildungsstätte).

Schritt-für-Schritt Anleitung

1. Öffne Bitbucket

Öffne !Bitbucket
Logge dich ggf. ein

2. SSH-Schlüssel erstellen

Öffne eine CMD Shell und gib den folgenden Befehl ein:

In früheren Versionen von diesem Modul wurden RSA-Keys eingesetzt. Da diese Keys nicht mehr als sehr sicher gelten wechseln wir zu den besseren ed25519-Keys.

Existiert die Datei bereits, dann überschreibe sie nicht!

Der ssh-key ist ein Schlüssel um sich mit anderen Rechnern zu verbinden. Ändert man diesen Schlüssel, muss man auf den anderen Rechnern, wo man bisher Zugang hatte, überall den öffentlichen Teil (das Schlüsselloch) anpassen.

1
  ssh-keygen -t ed25519 -C "deine.email@sbb.ch"

Drücke Enter für den Standardspeicherort
Optional: Passphrase setzen

Da sich der Schlüssel auf deinem Rechner in deinem persönlichen Ordner befindet, ist es ok, den Schlüssel nicht durch ein Passwort zu schützen.

Die Schlüssel befinden sich in C:\Users\[username]\.ssh\:

id_ed25519 (privat, niemals weitergeben)
id_ed25519.pub (öffentlich)

3. SSH-Schlüssel zu Bitbucket hinzufügen

Zeige den Öffentlichen Schlüssel an:
1
type C:\Users\u123456\.ssh\id_ed25519.pub
In Windows kannst du die Datei auch einfach mit notepad.exe öffnen und den Inhalt kopieren.
Kopiere den Inhalt und füge ihn unter SSH-Key hinzufügen ein.

4. Erstelle ein Repository und klone es

Öffne dein Bitbucket Konto
Klicke auf Repository erstellen
Vergib einen Namen (z. B. it-ninja-[deinName]) und klicke auf Repository erstellen
Öffne auf deinem Rechner den Ordner, wo Repositories abgelegt werden sollen

Wie Word-Dokumente unter Dokumente abgelegt werden, legen wir unseren Quellcode in einem seperaten Ordner ab. In der Talent Factory haben wir uns für C:\Users\u123456\local_repos entschieden.

Falls der Ordner noch nicht existiert, muss er zuerst erstellt werden:

mkdir C:\Users\u123456\local_repos

1
mkdir C:\Users\u123456\local_repos

Öffne ihn:

cd C:\Users\u123456\local_repos

1
cd C:\Users\u123456\local_repos

Clone das Repository. Den Befehl dazu findest du auf der Seite von deinem Projekt. Er sollte in etwa so aussehen:

git clone ssh://git@codessh.sbb.ch:7999/~u123456/it-ninja-[deinName].git

1
git clone ssh://git@codessh.sbb.ch:7999/~u123456/it-ninja-[deinName].git

5. Erstelle ein README.md und pushe es

Mit diesem Schritt wird sichergestellt, dass es keinen leeren Master Branch gibt.

Führe die folgenden Befehle aus:

cd C:\Users\u123456\local_repos\it-ninja-[deinName]
echo it-ninja repository > ./README.md
git add .
git commit -m "Initial Commit"
git push

1
2
3
4
5
cd C:\Users\u123456\local_repos\it-ninja-[deinName]
echo it-ninja repository > ./README.md
git add .
git commit -m "Initial Commit"
git push

6. Praxisbildner berechtigen

Repository in Bitbucket öffnen
Zu Repository Settings → Repository Permissions navigieren
Add user or group klicken
Praxisbildner als Administratoren hinzufügen

Last modified August 14, 2025: Adapt Labs to Java 21; adapt preparation steps (8c9c1820d)