Comment Connecter des Dépôts

Vous pouvez connecter le dépôt contenant le code de votre application à notre Plateforme d’Applications lors de la création d'une nouvelle app dans le panneau de contrôle Hostman.

La plateforme d’applications prend en charge les dépôts GitLab, GitHub et BitBucket, ainsi que tout dépôt accessible par URL, y compris Gitea, GitLab auto-hébergé, GitHub Enterprise, etc.

Connecter un dépôt depuis GitLab, GitHub ou BitBucket

Pour connecter le dépôt :

1. Accédez à la section Plateforme d’Apps et cliquez sur Créer.

2. À l’étape Dépôt, cliquez sur l’icône de la plateforme.

3. Connectez-vous à votre compte.

4. Autorisez l’accès aux dépôts nécessaires.

5. Sélectionnez le dépôt pour le déploiement dans le tableau de bord Hostman.

Si vous êtes déjà connecté à votre compte GitHub, GitLab ou Bitbucket, Hostman affichera automatiquement les dépôts disponibles. Il ne vous reste plus qu'à sélectionner celui que vous souhaitez.

Si vous êtes connecté mais que le dépôt requis ne s’affiche pas :

1. Cliquez sur Ajouter un compte.

2. Choisissez une plateforme.

3. Connectez-vous si nécessaire.

4. Sélectionnez les dépôts souhaités et enregistrez les modifications.

Sélectionnez ensuite le dépôt à déployer dans le tableau de bord Hostman.

Connecter un dépôt via une URL

Vous pouvez connecter tout dépôt à la plateforme d’applications s’il possède une adresse HTTP ou HTTPS externe, y compris les dépôts GitLab auto-hébergés, GitHub Enterprise ou ceux hébergés par des fournisseurs non directement pris en charge (par exemple, Gitea).

Cette option peut aussi être utilisée pour des raisons de sécurité : si vous ne souhaitez pas donner accès à l’ensemble de votre compte Git, vous pouvez ajouter un dépôt spécifique via un lien.

Notez que le déploiement automatique n’est pas disponible pour les dépôts connectés par URL. Après avoir mis à jour le code, vous devrez lancer manuellement le déploiement en sélectionnant le commit souhaité.

Pour les dépôts publics, il suffit de fournir l’URL.

Pour les dépôts privés, vous devrez fournir un identifiant et un mot de passe ou un token généré depuis l’interface du fournisseur (GitLab, GitHub, etc.).

Connecter un dépôt

Vous pouvez connecter un dépôt par URL lors de la création d’une nouvelle application :

1. Allez dans la section Plateforme d’Apps et cliquez sur Créer.

2. À l’étape Dépôt, cliquez sur Connecter un dépôt via une URL.

3. Fournissez l’URL du dépôt et les informations d’accès si le dépôt est privé.

4. Cliquez sur Connecter.

Le dépôt et les commits disponibles s’afficheront dans le panneau de contrôle.

Obtenir un lien Git

Le lien de connexion doit être au format d’URL Git, par exemple :

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

Dans GitHub, cliquez sur Code → HTTPS pour obtenir ce lien.

Dans GitLab ou BitBucket, allez dans le dépôt → cliquez sur Code/Cloner → Cloner avec HTTPS.

Obtenir un lien et un token dans BitBucket

Il existe deux méthodes pour obtenir un token et un lien dans BitBucket.

Méthode 1.

1. Allez dans Paramètres personnels Bitbucket → Mot de passe d’application.

2. Définissez un nom (Label) et les autorisations nécessaires ; les autorisations en lecture sont suffisantes.

3. Cliquez sur Créer.

4. Copiez le mot de passe et collez-le dans le champ Mot de passe ou token du tableau de bord Hostman.

5. Accédez au dépôt et cliquez sur Cloner. Copiez tout ce qui suit git clone et collez-le dans le champ URL du dépôt.

6. Copiez la partie de l’URL entre https:// et @ et collez-la dans le champ Nom d’utilisateur.

Méthode 2.

1. Accédez à Paramètres → Paramètres du dépôt → Token d’accès → Créer un token d’accès au dépôt.

2. Définissez un nom et les autorisations (Scopes). Les autorisations de lecture sont suffisantes.

3. Copiez la valeur du champ Votre token d’accès au dépôt et collez-la dans le champ Mot de passe ou token du tableau de bord Hostman.

4. Comme lien vers le dépôt, utilisez l’URL indiquée dans le champ Comment utiliser ce token avec votre dépôt Git. Copiez tout ce qui suit git clone et collez-le dans le champ URL du dépôt dans Hostman.

Obtenir un token sur GitHub

Vous ne pouvez pas connecter un dépôt GitHub avec votre mot de passe de compte ; vous devez générer un token.

Pour générer un token sur GitHub :

1. Allez dans Paramètres → Paramètres développeur → Tokens d’accès personnels → Tokens → Générer un token d’accès personnel.

2. Définissez un nom, une date d’expiration et les autorisations du token. Pour travailler avec des dépôts privés, sélectionnez repo.

3. Cliquez sur Générer le token.

4. Copiez le token et collez-le dans le champ Mot de passe ou token dans Hostman.

Obtenir un token dans GitLab

Pour connecter des dépôts GitLab, vous pouvez utiliser votre mot de passe ou un token généré dans les paramètres de votre compte GitLab.

1. Accédez à Préférences → Tokens d’accès.

2. Créez un nouveau token en définissant son nom, sa date d’expiration et ses autorisations. Au minimum, les autorisations de lecture des dépôts sont nécessaires.

3. Cliquez sur Créer un token d’accès personnel.

4. Copiez le token et collez-le dans le champ Mot de passe ou token dans Hostman.

Supprimer des dépôts connectés

Tout dépôt ajouté peut être supprimé de la plateforme d’applications.

Si vous supprimez un dépôt, les déploiements (automatiques ou manuels) de toutes les applications issues de ce dépôt deviendront impossibles.

1. Allez dans la section Plateforme d’Apps et cliquez sur Créer.

2. Accédez à l’étape Dépôt. Cliquez sur la liste déroulante des dépôts et cliquez sur Supprimer à côté du dépôt à supprimer.

3. Confirmez l’action.

Le dépôt requis ne s’affiche pas

Si votre compte GitHub, GitLab ou Bitbucket est connecté à la plateforme d’applications mais que le dépôt requis ne s’affiche pas dans le tableau de bord Hostman, cela peut être dû à deux raisons :

• Vous avez ajouté le dépôt après vous être connecté à votre compte via la plateforme.

• Vous avez autorisé l’accès uniquement à certains dépôts, et le dépôt requis n’est pas sélectionné.

Pour résoudre le problème :

1. Allez dans la section Plateforme d’Apps et cliquez sur Créer.

2. Accédez à l’étape Dépôt et cliquez sur Ajouter un compte.

3. Choisissez une plateforme.

4. Connectez-vous si nécessaire.

5. Sélectionnez le dépôt requis et enregistrez les modifications.

Les dépôts connectés apparaîtront dans le tableau de bord Hostman, et vous pourrez choisir celui dont vous avez besoin.