So Verbinden Sie Repositories

Sie können das Repository mit dem Code Ihrer Anwendung mit unserer App-Plattform verbinden, wenn Sie im Hostman-Kontrollpanel eine neue App erstellen.

Die App-Plattform unterstützt Repositories von GitLab, GitHub und BitBucket sowie alle Repositories, die über eine URL erreichbar sind, einschließlich Gitea, selbst gehostetem GitLab, GitHub Enterprise usw.

Repository von GitLab, GitHub oder BitBucket verbinden

So verbinden Sie ein Repository:

1. Gehen Sie zum Abschnitt App-Plattform und klicken Sie auf Erstellen.

2. Klicken Sie im Schritt Repository auf das Plattform-Symbol.

3. Melden Sie sich bei Ihrem Konto an.

4. Erlauben Sie den Zugriff auf die benötigten Repositories.

5. Wählen Sie das Repository für die Bereitstellung im Hostman-Dashboard aus.

Wenn Sie bereits bei Ihrem GitHub-, GitLab- oder BitBucket-Konto angemeldet sind, zeigt Hostman automatisch die verfügbaren Repositories an. Wählen Sie einfach das gewünschte aus.

Wenn Sie angemeldet sind, das gewünschte Repository aber nicht verfügbar ist:

1. Klicken Sie auf Konto hinzufügen.

2. Wählen Sie eine Plattform aus.

3. Melden Sie sich gegebenenfalls an.

4. Wählen Sie die benötigten Repositories aus und speichern Sie die Änderungen.

Wählen Sie dann das gewünschte Repository zur Bereitstellung im Hostman-Dashboard aus.

Repository über URL verbinden

Sie können jedes Repository mit externer HTTP- oder HTTPS-Adresse mit der App-Plattform verbinden, einschließlich Repositories von selbst gehostetem GitLab, GitHub Enterprise oder von anderen Anbietern wie Gitea.

Diese Option kann auch aus Sicherheitsgründen genutzt werden: Wenn Sie keinen Zugriff auf das gesamte Git-Konto gewähren möchten, können Sie ein einzelnes Repository per Link hinzufügen.

Bitte beachten Sie, dass automatische Bereitstellungen für Repositories, die über eine URL verbunden wurden, nicht verfügbar sind. Nach Code-Änderungen müssen Sie die Anwendung manuell bereitstellen, indem Sie den gewünschten Commit auswählen.

Für öffentliche Repositories reicht es, die URL anzugeben.

Für private Repositories müssen Sie Benutzername und Passwort oder ein Token angeben, das im Interface des Anbieters (GitLab, GitHub usw.) erstellt wird.

Repository verbinden

Sie können das Repository per URL verbinden, wenn Sie eine neue Anwendung erstellen:

1. Gehen Sie zum Abschnitt App-Plattform und klicken Sie auf Erstellen.

2. Klicken Sie im Schritt Repository auf Repository über URL verbinden.

3. Geben Sie die URL zum Repository sowie ggf. die Zugangsdaten ein, wenn das Repository privat ist.

4. Klicken Sie auf Verbinden.

Das Repository und die verfügbaren Commits werden im Kontrollpanel angezeigt.

Git-Link abrufen

Der Verbindungslink muss im Git-URL-Format vorliegen, z. B.:

https://github.com/hostman/app-example.git

In GitHub erhalten Sie den Link, indem Sie auf Code → HTTPS klicken.

In GitLab oder BitBucket: Gehen Sie zum gewünschten Repository → klicken Sie auf Code/Klonen → Klonen mit HTTPS.

Link und Token in BitBucket abrufen

Es gibt zwei Methoden, um ein Token und einen Link in BitBucket zu erhalten.

Methode 1.

1. Gehen Sie zu Persönliche Bitbucket-Einstellungen → App-Passwort.

2. Geben Sie einen Namen (Label) und Berechtigungen an. Leserechte sind ausreichend.

3. Klicken Sie auf Erstellen.

4. Kopieren Sie das Passwort und fügen Sie es im Hostman-Dashboard im Feld Passwort oder Token ein.

5. Gehen Sie zum Repository und klicken Sie auf Klonen. Kopieren Sie alles nach git clone und fügen Sie es im Feld Repository-URL ein.

6. Kopieren Sie den Teil der URL zwischen https:// und @ und fügen Sie ihn im Feld Benutzername ein.

Methode 2.

1. Gehen Sie zu Einstellungen → Repository-Einstellungen → Zugriffstoken → Repository-Zugriffstoken erstellen.

2. Geben Sie Name und Berechtigungen an (Scopes). Leserechte reichen aus.

3. Kopieren Sie den Wert aus dem Feld Ihr Repository-Zugriffstoken und fügen Sie ihn im Hostman-Dashboard in das Feld Passwort oder Token ein.

4. Als Repository-Link verwenden Sie die URL aus dem Feld Verwendung des Tokens mit Git-Repository. Kopieren Sie alles nach git clone und fügen Sie es im Hostman-Dashboard ins Feld Repository-URL ein.

Token in GitHub erstellen

Sie können ein GitHub-Repository nicht mit Ihrem Kontopasswort verbinden – dafür benötigen Sie ein Token.

So erstellen Sie ein Token in GitHub:

1. Gehen Sie zu Einstellungen → Entwickler-Einstellungen → Persönliche Zugriffstoken → Tokens → Persönlichen Zugriffstoken erstellen.

2. Geben Sie Namen, Ablaufdatum und Berechtigungen an. Für private Repositories ist repo erforderlich.

3. Klicken Sie auf Token generieren.

4. Kopieren Sie das Token und fügen Sie es im Hostman-Dashboard ins Feld Passwort oder Token ein.

Token in GitLab erstellen

Um GitLab-Repositories zu verbinden, können Sie Ihr Kontopasswort oder ein in den GitLab-Einstellungen generiertes Token verwenden.

1. Gehen Sie zu Einstellungen → Zugriffstoken.

2. Erstellen Sie ein neues Token mit Namen, Ablaufdatum und Berechtigungen. Mindestens Lesezugriff auf Repositories ist erforderlich.

3. Klicken Sie auf Persönlichen Zugriffstoken erstellen.

4. Kopieren Sie das Token und fügen Sie es im Hostman-Dashboard ins Feld Passwort oder Token ein.

Verbundene Repositories entfernen

Jedes hinzugefügte Repository kann von der App-Plattform getrennt werden.

Wenn Sie ein Repository trennen, sind alle Deployments (automatisch und manuell) von Anwendungen aus diesem Repository nicht mehr möglich.

1. Gehen Sie zum Abschnitt App-Plattform und klicken Sie auf Erstellen.

2. Gehen Sie zum Schritt Repository. Klicken Sie auf die Dropdown-Liste und dann auf Löschen neben dem gewünschten Repository.

3. Bestätigen Sie den Vorgang.

App-Plattform zeigt das gewünschte Repository nicht an

Wenn Ihr GitHub-, GitLab- oder BitBucket-Konto mit der App-Plattform verbunden ist, das gewünschte Repository aber im Hostman-Dashboard nicht erscheint, kann das zwei Gründe haben:

• Sie haben das Repository hinzugefügt, nachdem Sie sich bei GitHub, GitLab oder BitBucket über die App-Plattform angemeldet haben.

• Sie haben nur bestimmten Repositories Zugriff gewährt, das gewünschte ist nicht dabei.

So lösen Sie das Problem:

1. Gehen Sie zum Abschnitt App-Plattform und klicken Sie auf Erstellen.

2. Gehen Sie zum Schritt Repository und klicken Sie auf Konto hinzufügen.

3. Wählen Sie eine Plattform aus.

4. Melden Sie sich bei Bedarf an.

5. Wählen Sie das gewünschte Repository aus und speichern Sie die Änderungen.

Verbundene Repositories erscheinen im Hostman-Dashboard und Sie können das benötigte auswählen.