Wie man ein bestehendes Projekt auf GitHub hochlädt

Einführung

GitHub ist ein cloudbasiertes Git-Management-Tool. Git ist eine verteilte Versionskontrolle, d. h. das gesamte Repository und seine Historie sind überall dort verfügbar, wo Sie es speichern. GitHub wird häufig in Geschäfts- oder Entwicklungs-Workflows als Managed-Hosting-Lösung zur Datensicherung eingesetzt. Darüber hinaus ermöglicht GitHub die Vernetzung mit Kollegen, Freunden, Organisationen und mehr.

In diesem Tutorial lernen Sie, wie Sie ein bestehendes Projekt, an dem Sie arbeiten, auf GitHub hochladen.

Voraussetzungen

• Ein kostenloser GitHub-Account
• Git ist auf Ihrem lokalen Rechner installiert.

Schritt 1 – Ein neues GitHub-Repository erstellen

Melde dich bei GitHub an und erstelle ein neues, leeres Repository. Du kannst wählen, ob du eine README-Datei initialisieren möchtest oder nicht. Das spielt aber keine Rolle, da wir ohnehin alles in diesem Remote-Repository überschreiben werden.

Hinweis: Im weiteren Verlauf dieses Tutorials lautet Ihr GitHub-Benutzername „Sammy“ und das von Ihnen erstellte Repository heißt „my-new-project“. Ersetzen Sie diese Platzhalter unbedingt durch Ihren tatsächlichen Benutzernamen und Repository-Namen.

Schritt 2 – Git im Projektordner starten

Nachdem Sie zu dem Ordner navigiert haben, den Sie hinzufügen möchten, führen Sie die folgenden Befehle in Ihrem Terminal aus.

Schritt 3 – Git-Repository einrichten

Stellen Sie sicher, dass Sie sich im Stammverzeichnis des Projekts befinden, das Sie auf GitHub hochladen möchten, und führen Sie folgenden Befehl aus:

Hinweis: Falls Sie bereits über ein einfaches Git-Repository verfügen, können Sie diesen Befehl überspringen.

git init

Dieser Schritt erstellt ein verstecktes .git-Verzeichnis in Ihrem Projektordner, das von der Git-Software erkannt und zum Speichern aller Metadaten und des Versionsverlaufs des Projekts verwendet wird.

Füge Dateien zum Git-Verzeichnis hinzu

git add -A

Mit dem Befehl git add teilt man Git mit, welche Dateien in einen Commit einbezogen werden sollen, und das Argument -A (oder --all) bedeutet “alle einschließen”.

Die hinzugefügten Dateien übernehmen.

git commit -m 'Added my project'

Der Befehl `git commit` erstellt einen neuen Commit mit allen hinzugefügten Dateien. Die Option `-m` (oder `-message`) legt eine Nachricht fest, die dem Commit beigefügt wird und später zum besseren Verständnis des Commits dient. In diesem Fall lautet die Nachricht: «Ich habe mein Projekt hinzugefügt».

Neue Remotequelle hinzufügen

git remote add origin [email protected]:sammy/my-new-project.git

Hinweis: Denken Sie daran, die hervorgehobenen Teile „Benutzername“ und „Repository-Name“ durch Ihren Benutzernamen und Ihren Repository-Namen zu ersetzen.

In Git bezeichnet “Remote” eine entfernte Version desselben Repositorys, die sich üblicherweise auf einem Server befindet (in diesem Fall GitHub). “Origin” ist der Standardname, den Git einem Remote-Server gibt (es können mehrere Remotes vorhanden sein). Der Befehl `git remote add origin` weist Git an, die Standard-Remote-Server-URL für dieses Repository hinzuzufügen.

Auf GitHub hochladen

git push -u -f origin main

Der Parameter `-u` (oder `--set-upstream`) legt den Remote-Ursprung als Upstream-Referenz fest. Dadurch können Sie später `git push`- und `git pull`-Befehle ausführen, ohne den Ursprung angeben zu müssen, wie es GitHub in diesem Fall immer vorsieht.

Der Parameter `-f` (oder `--force`) steht für „force“ (erzwingen). Er überschreibt automatisch alle Dateien im Remote-Verzeichnis. Wir verwenden ihn hier, um die standardmäßige README-Datei zu überschreiben, die GitHub automatisch erstellt.

Hinweis: Wenn Sie beim Erstellen des Projekts auf GitHub keine Standard-README-Datei angegeben haben, ist der Parameter -f nicht unbedingt erforderlich.

Alle zusammen

git init
git add -A
git commit -m 'Added my project'
git remote add origin [email protected]:sammy/my-new-project.git
git push -u -f origin main

Ergebnis

Jetzt können Sie Ihre Codeänderungen remote auf GitHub verfolgen.