Aller au contenu

Connecter un dépôt Git

Créez un dépôt GitHub géré par Wakastart ou référencez un dépôt existant, pour que vos services puissent être construits depuis Git.

GuideDéveloppeur
Accès requis
Accès à l'infrastructure de l'application (profil Infra)
Durée
5 min
Voir en Markdown

Chaque service est construit depuis un dépôt Git de l'application. Un même dépôt peut servir plusieurs services (monorepo), ou chaque service peut avoir le sien. Wakastart travaille avec GitHub.

Avant de commencer

Choisissez le type de dépôt :

TypeQuand le choisirCe que fait Wakastart
ManagéVous démarrez un nouveau projetCrée le dépôt sur GitHub, dans l'organisation de Wakastart, et y donne accès à la plateforme
ImportéVotre code existe déjà sur GitHubRéférence votre dépôt ; il doit être accessible à l'application GitHub de Wakastart

Créer un dépôt géré

  1. Dans le menu de l'application, cliquez sur Architecture, puis sur la carte Repositories, puis sur Nouveau repository.
  2. Laissez Repository managé activé.
  3. Dans Nom du repository, saisissez un nom en minuscules, chiffres et tirets, par exemple wk-monapp. La convention est wk-<nom court de l'application>.
  4. Dans Visibilité, choisissez Privé, Interne ou Public.
  5. Cliquez sur Créer.

Résultat : le message « Repository créé » s'affiche. Le dépôt apparaît avec le badge Managé et le statut En attente, puis Provisionné une fois créé sur GitHub, en général en moins d'une minute. Sur GitHub, son nom est préfixé par l'identifiant de l'application : ab12cd-wk-monapp. Il est initialisé sur la branche main, n'accepte que les fusions en « squash » et supprime les branches fusionnées.

Référencer un dépôt existant

  1. Dans Architecture > Repositories, cliquez sur Nouveau repository.
  2. Désactivez Repository managé.
  3. Dans Nom du repository, saisissez le nom sous lequel le dépôt apparaîtra dans la console, par exemple wk-monapp.
  4. Dans URL du repository, saisissez l'URL HTTPS du dépôt terminée par .git, par exemple https://github.com/exemple-org/wk-monapp.git.
  5. Optionnel : renseignez Visibilité et Branche par défaut.
  6. Cliquez sur Créer.

Résultat : le dépôt apparaît avec le badge Importé et le statut Provisionné. Aucune ressource n'est créée sur GitHub.

Donner accès à un dépôt importé

Pour cloner un dépôt importé, lister ses branches et recevoir ses push, la plateforme passe par l'application GitHub de Wakastart. Elle doit être installée sur l'organisation ou le dépôt GitHub, avec accès à ce dépôt. Contactez Wakastart pour obtenir son installation.

Sans cet accès :

  • la liste des branches du formulaire de build ne se charge pas ;
  • les builds échouent avec, dans leurs logs, ERROR: GitHub App is not installed on repo exemple-org/wk-monapp ;
  • l'activation du build automatique est refusée : « Le build automatique nécessite un accès complet à ce repository. Vérifiez la configuration d'accès GitHub de ce repository. ».

Utiliser un dépôt pour plusieurs services

Dans un monorepo, chaque service désigne le même dépôt et son propre Répertoire racine, par exemple apps/front et services/api. Le build du service ne prend que ce dossier comme contexte, et le build automatique ne se déclenche que si un push touche ce dossier. Voir Créer un service.

Supprimer un dépôt

Un dépôt géré est supprimé de GitHub

Supprimer un dépôt managé supprime le dépôt sur GitHub, avec tout son historique. Clonez-le ou transférez son contenu avant de le supprimer. Supprimer un dépôt importé retire seulement la référence ; votre dépôt GitHub n'est pas touché.

  1. Retirez d'abord le dépôt de chaque service qui l'utilise, ou supprimez ces services.
  2. Dans Architecture > Repositories, cliquez sur l'icône de suppression de la ligne du dépôt.
  3. Dans la fenêtre Supprimer le repository, cliquez sur Supprimer.

Résultat : le message « Repository supprimé » s'affiche ; le dépôt passe en Suppression… puis disparaît.

Vérifier le résultat

  • La liste Repositories affiche le dépôt au statut Provisionné, avec son URL.
  • En cliquant sur son nom, la carte Fichiers affiche son contenu et ses branches.

Dépannage

  • « L'URL du repository est obligatoire pour un repo importé » : renseignez URL du repository.
  • Imported repository URL must start with https:// and end with .git : ajoutez .git à la fin de l'URL.
  • Le dépôt géré reste En attente ou passe en Échec : voir Résoudre les problèmes de build et de déploiement.

Voir aussi