Ihren ersten Git-Service erstellen

Voraussetzungen

• Sie haben ein STACKIT Kundenkonto: Kundenkonto erstellen
• Sie haben ein STACKIT Benutzerkonto: Benutzerkonto erstellen
• Sie haben ein STACKIT Projekt: Projekt erstellen

Instanz vorbereiten, bestellen und erstellen

In dieser Anleitung zur ersten Nutzung werden Sie eine Instanz erstellen und konfigurieren. Diese Anleitung zeigt die gängigsten Einstellungen für eine kleine Entwicklerumgebung. Bei der Durchführung dieser Anleitung arbeiten Sie mit dem STACKIT Portal.

1. Besuchen Sie das STACKIT Portal.
2. Klicken Sie in der Seitenleiste auf Git.
3. Klicken Sie in der oberen Leiste auf Git erstellen.

Nach Abschluss der Schritte sehen Sie ein Overlay mit drei Abschnitten (Allgemeine Informationen, Pläne und Speicher).

Allgemeine Informationen

• Geben Sie einen Namen für die Instanz ein (z. B. den Unternehmensnamen)

Wählen Sie einen leicht identifizierbaren Namen für Ihr Git Repository. Dieser darf Kleinbuchstaben, Zahlen und Bindestriche enthalten und sollte zwischen 6 und 31 Zeichen lang sein. Das erste Zeichen muss ein Buchstabe und das letzte Zeichen darf kein Schrägstrich sein.

Pläne

• Wählen Sie den Plan Git10, es sei denn, Sie wissen im Voraus, wie viele Ressourcen Sie benötigen werden.

Speicher

Sobald die Kapazität überschritten wird, werden der Speicherplatz auf der Festplatte (Disk Space) und der Object Storage-Speicherplatz hochgestuft, um die erforderliche Kapazität aufzunehmen. Instanzkapazitäts-Upgrades sind in Schritten von 11 GB verfügbar, die Folgendes umfassen: 1 GB Speicherplatz auf der Festplatte (Disk Space), 10 GB Object Storage und 1 zusätzlicher Benutzer.

Bestellung

Nachdem Sie alle Einstellungen überprüft haben, klicken Sie auf Kostenpflichtig bestellen, um Ihre neue Instanz zu erstellen. Anschließend sehen Sie eine Bestätigung, dass Ihre Instanz erstellt wurde. Ihre neue Instanz wird der Liste der Instanzen hinzugefügt. Nach einigen Minuten wechselt sie von Wird erstellt zu Bereit.

Die hier beschriebene Aktion kann Kosten verursachen oder Ihre laufenden Kosten verändern. Bitte prüfen Sie sorgfältig, welche einmaligen und/oder laufenden Kosten anfallen, und führen Sie die Aktionen nur durch, wenn Sie damit einverstanden und dazu autorisiert sind.

Erstellen eines Repositorys in STACKIT Git

1. Besuchen Sie das STACKIT Portal.

2. Klicken Sie in der Seitenleiste auf Git.

3. Klicken Sie in der Liste aller verfügbaren Instanzen auf die Access URL. (z.B. https://[instanceName].git.onstackit.cloud)

4. Klicken Sie in der oberen Leiste auf Sign In und dann auf Sign in with STACKIT IDP.

5. Nach der Anmeldung sehen Sie die Startseite von STACKIT Git.

6. Klicken Sie auf das ”+“-Zeichen oben rechts auf der Seite und wählen Sie + New repository aus dem Menü.

7. Geben Sie die Details Ihres neuen Repositorys ein.

   Geben Sie für einen schnellen Start nur Owner und Repository name an und verwenden Sie für alle anderen Einträge Standardwerte oder füllen Sie die Felder später aus. Eine vollständige Liste mit allen verfügbaren Parametern finden Sie unter So richten Sie ein Git Repository ein

   Formularfeld	Erklärung
   Owner	Hier können Sie festlegen, ob dies Ihr eigenes persönliches Projekt sein soll oder ob es Teil einer Organisation sein soll, der Sie angehören
   Repository name	Ein Name für Ihr Repository (der auch Teil seines Pfads sein wird)

8. Klicken Sie auf Create Repository.

Verbindung zum Git Repository herstellen

Zugangsdaten für das Git Repository generieren

1. Klicken Sie in der oberen Leiste auf Ihr Profilsymbol und wählen Sie settings im Dropdown-Menü.

2. Kopieren Sie im Bereich Public profile Ihren Benutzernamen.

3. Wählen Sie Applications in der linken Navigationsleiste.

4. Erstellen Sie ein neues Zugriffstoken (Access token).

   • Geben Sie einen Namen für das Token ein (Token name)
   • Wählen Sie All aus
   • Öffnen Sie Select permissions und wählen Sie mindestens repository read and write
   • Klicken Sie auf Generate token. Das Token ist nur einmal sichtbar. Speichern Sie es für die zukünftige Verwendung.

Alternative: Authentifizierung mit SSH-Schlüsseln

1. Gehen Sie zu Ihren Benutzereinstellungen, wie oben beschrieben.
2. Wählen Sie SSH / GPG keys in der linken Navigation.
3. Klicken Sie auf Add key, um einen neuen SSH-Schlüssel hinzuzufügen.

Anweisungen zum Generieren von SSH-Schlüsseln finden Sie unter SSH-Schlüssel generieren und hochladen.

Verbindung zum Repository herstellen

Leeres Repository klonen

Wenn Sie ein neues Projekt starten möchten (d. h. wenn Sie noch keinen Quellcode haben, den Sie in STACKIT Git hochladen möchten), ist das Klonen Ihres neu erstellten Repositorys der schnellste Weg, um zu beginnen:

1. Erstellen Sie ein dediziertes Verzeichnis für Ihr neues Projekt und navigieren Sie in der Befehlszeile dorthin.

   mkdir my-new-project
   cd my-new-project

2. Klonen Sie das Repository, indem Sie den Befehl git clone ausführen.

   Die URL finden Sie auf der Übersichtsseite Ihres erstellten Repositorys. Die URL sieht wie folgt aus: https://[instanceName].git.onstackit.cloud/[organization]/[repositoryName].git

   git clone [url]

3. Geben Sie Ihren Benutzernamen ein (Enter username)

4. Geben Sie Ihr Zugriffstoken (Access token) ein

5. Navigieren Sie zu dem geklonten Repository.

   cd [repositoryName]

Lokales Repository verbinden

Wenn Sie bereits Quellcode geschrieben haben, den Sie nun in STACKIT Git hochladen möchten, führen Sie die folgenden Schritte aus:

1. Git Repository initialisieren: Sofern Sie in Ihrem lokalen Quellcodebaum noch kein Git Repository initialisiert haben, führen Sie git init im Verzeichnis Ihres Projekts aus.

   git init

2. Fügen Sie STACKIT Git als Ursprung des Repositorys hinzu.

   Die URL finden Sie auf der Startseite Ihres erstellten Repositorys. Die URL sieht wie folgt aus: https://[instanceName].git.onstackit.cloud/[organization]/[repositoryName].git

   git remote add origin [url]

3. Pushen Sie das vorhandene Repository.

   git push -u origin main

Einen Commit im Repository vornehmen

1. Erstellen Sie eine neue Datei oder bearbeiten Sie eine Datei im Repository

2. Fügen Sie jede geänderte Datei zu Ihrem Commit hinzu

   git add .

3. Committen Sie Ihre Änderungen mit einer Nachricht

   git commit -m "[commit message]"

4. Pushen Sie Ihre Änderungen zu STACKIT Git

   git push

Laden Sie die Übersichtsseite neu. Die gerade gepushten Dateien und Änderungen sind in Ihrem STACKIT Git Repository sichtbar.

Jetzt haben Sie einige grundlegende Befehle ausgeführt. Von hier aus können Sie sich mit den How-Tos tiefer einarbeiten.