Hoe Repositories Verbinden

Je kunt de repository met de code van je applicatie verbinden met ons App Platform tijdens het aanmaken van een nieuwe app in het Hostman-configuratiescherm.

Het App Platform ondersteunt GitLab-, GitHub- en BitBucket-repositories, evenals repositories die toegankelijk zijn via een URL, zoals Gitea, self-hosted GitLab, GitHub Enterprise, enzovoort.

Repository verbinden vanaf GitLab, GitHub of BitBucket

Om een repository te verbinden:

1. Ga naar het gedeelte App Platform en klik op Maken.

2. Klik in de stap Repository op het pictogram van het platform.

3. Log in op je account.

4. Verleen toegang tot de gewenste repositories.

5. Selecteer de repository voor deployment in het Hostman-dashboard.

Als je al bent ingelogd bij GitHub, GitLab of Bitbucket, toont Hostman automatisch de beschikbare repositories. Je hoeft alleen degene te kiezen die je nodig hebt.

Als je al bent ingelogd maar de gewenste repository wordt niet weergegeven:

1. Klik op Account toevoegen.

2. Kies een platform.

3. Log in indien nodig.

4. Selecteer de gewenste repositories en sla de wijzigingen op.

Selecteer vervolgens de gewenste repository voor deployment in het Hostman-dashboard.

Repository verbinden via URL

Je kunt elke repository met een externe HTTP- of HTTPS-link verbinden, inclusief repositories van self-hosted GitLab, GitHub Enterprise of andere providers die we niet direct ondersteunen (bijv. Gitea).

Deze optie is ook geschikt voor beveiligingsdoeleinden: als je geen toegang wilt geven tot het hele Git-account, kun je slechts één specifieke repository toevoegen via een link.

Let op: automatische deployment is niet beschikbaar voor repositories die via een URL zijn verbonden. Na het bijwerken van de code moet je handmatig een deployment uitvoeren door de gewenste commit te selecteren.

Voor publieke repositories is alleen de URL voldoende.

Voor private repositories moet je inloggegevens of een token opgeven dat gegenereerd is in de interface van de provider (GitLab, GitHub, enz.).

Repository verbinden

Je kunt de repository via URL verbinden tijdens het maken van een nieuwe app:

1. Ga naar het gedeelte App Platform en klik op Maken.

2. Klik in de stap Repository op Verbind repository via URL.

3. Geef de URL van de repository op en de toegangsgegevens als de repository privé is.

4. Klik op Verbinden.

De repository en beschikbare commits worden weergegeven in het configuratiescherm.

Een git-link ophalen

De verbindingslink moet in Git URL-formaat zijn, bijvoorbeeld:

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

In GitHub kun je de benodigde link vinden door op Code → HTTPS te klikken.

Hetzelfde geldt voor GitLab of BitBucket: ga naar de gewenste repository → klik op Code/Klonen → Klonen met HTTPS.

Link en token ophalen in BitBucket

Er zijn twee manieren om een token en link te verkrijgen in BitBucket.

Methode 1.

1. Ga naar Persoonlijke Bitbucket-instellingen → App-wachtwoorden.

2. Geef een naam op (Label) en machtigingen; leesrechten zijn voldoende.

3. Klik op Maken.

4. Kopieer het wachtwoord en plak het in het veld Wachtwoord of token in het Hostman-dashboard.

5. Ga naar de repository en klik op Klonen. Kopieer alles na git clone en plak het in het veld Repository-URL.

6. Kopieer het gedeelte van de link tussen https:// en @ en plak dit in het veld Gebruikersnaam.

Methode 2.

1. Ga naar Instellingen → Repository-instellingen → Toegangstoken → Maak repository-toegangstoken aan.

2. Stel de naam en machtigingen (Scopes) in. Leestoegang is voldoende.

3. Kopieer de waarde van het veld Je Repository Access Token en plak het in het veld Wachtwoord of token in het Hostman-dashboard.

4. Gebruik als link de URL uit het veld Hoe je dit token gebruikt met je Git-repository. Kopieer alles na git clone en plak het in het veld Repository-URL in het Hostman-dashboard.

Token verkrijgen in GitHub

Je kunt een GitHub-repository niet verbinden met alleen je wachtwoord; je hebt een token nodig.

Om een token in GitHub te genereren:

1. Ga naar Instellingen → Ontwikkelaarsinstellingen → Persoonlijke toegangstokens → Tokens → Genereer een persoonlijk toegangstoken.

2. Stel een naam, vervaldatum en machtigingen in. Voor toegang tot private repositories moet je repo selecteren.

3. Klik op Genereer token.

4. Kopieer het token en plak het in het veld Wachtwoord of token in het Hostman-dashboard.

Token verkrijgen in GitLab

Voor het verbinden van GitLab-repositories kun je je accountwachtwoord of een token gebruiken dat in je GitLab-instellingen is gegenereerd.

1. Ga naar Voorkeuren → Toegangstokens.

2. Maak een nieuw token aan met naam, vervaldatum en machtigingen. Minimaal moet je leestoegang tot repositories geven.

3. Klik op Maak persoonlijk toegangstoken aan.

4. Kopieer het token en plak het in het veld Wachtwoord of token in het Hostman-dashboard.

Repositories ontkoppelen

Elke toegevoegde repository kan losgekoppeld worden van het App Platform.

Als je een repository loskoppelt, zijn er geen deployments (automatisch of handmatig) meer mogelijk voor apps die hieruit zijn aangemaakt.

1. Ga naar het gedeelte App Platform en klik op Maken.

2. Ga naar de stap Repository. Klik op de vervolgkeuzelijst van repositories en klik op Verwijderen naast de repository die je wilt verwijderen.

3. Bevestig de actie.

App Platform toont de vereiste repository niet

Als je GitHub-, GitLab- of Bitbucket-account is verbonden met het App Platform maar de vereiste repository niet zichtbaar is in het Hostman-dashboard, zijn er twee mogelijke oorzaken:

• Je hebt de repository toegevoegd nadat je was ingelogd bij GitHub, GitLab of Bitbucket vanaf het App Platform.

• Je hebt alleen toegang verleend tot bepaalde repositories en de gewenste is niet geselecteerd.

Om het probleem op te lossen:

1. Ga naar het gedeelte App Platform en klik op Maken.

2. Ga naar de stap Repository en klik op Account toevoegen.

3. Kies een platform.

4. Log in indien nodig.

5. Selecteer de gewenste repository en sla je wijzigingen op.

Verbonden repositories verschijnen nu in het Hostman-dashboard en je kunt degene selecteren die je nodig hebt.