# 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.

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 :

| Type | Quand le choisir | Ce que fait Wakastart |
|---|---|---|
| **Managé** | Vous démarrez un nouveau projet | Cré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 GitHub | Ré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](/v1.0/services/creer-un-service).

## Supprimer un dépôt

:::warning[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](/v1.0/builds-et-deploiements/depannage#le-dépôt-géré-reste-en-attente).

## Voir aussi

- [Créer un service](/v1.0/services/creer-un-service)
- [Modifier les fichiers d'un dépôt](/v1.0/builds-et-deploiements/modifier-les-fichiers-d-un-depot)
- [Automatiser les builds et les déploiements](/v1.0/builds-et-deploiements/automatiser-builds-et-deploiements)
