Déclarer le dépôt distant dans Git

Vous avez créé un dépôt vide sur une forge, mais votre dépôt local ne connaît pas encore son adresse. Tant que ce lien n’est pas déclaré, Git ne peut pas identifier ce dépôt comme destination pour les opérations de partage. Vous allez enregistrer l’adresse sous le nom `origin`, puis vérifier l’association sans envoyer de contenu.

Vérifier le dépôt local avant de le relier

Dans les leçons précédentes, vous avez créé un dépôt local et un dépôt distant vide. Le dépôt local `suivi-site` contient son historique ainsi qu’une note provisoire non commitée dans `README.md` ; cette note doit rester telle quelle. Placez-vous dans le dossier du projet avant d’exécuter les commandes suivantes.

cd suivi-site
git status --short

 M README.md

La ligne affichée confirme que `README.md` est modifié et que sa modification n’est pas préparée. C’est l’état attendu dans ce scénario : ne restaurez pas ce fichier et ne l’ajoutez pas à la préparation. La déclaration de l’adresse distante ne nécessite aucune modification du contenu du site.

Déclarer l’adresse du dépôt distant

Une URL distante est l’adresse qui permet à Git de désigner le dépôt hébergé sur la forge. Copiez l’adresse fournie par la page de votre dépôt `suivi-site` : selon la forge et votre méthode d’accès, elle peut commencer par `https://` ou par `git@`. Utilisez l’adresse exacte de votre dépôt, et non l’adresse d’exemple ci-dessous.

git remote add origin https://forge.example/votre-compte/suivi-site.git

Dans cette commande, `git remote add` demande à Git d’enregistrer un dépôt distant. `origin` est l’alias choisi pour le désigner dans les commandes ultérieures ; c’est une convention courante, pas une adresse ni un mot réservé. Remplacez toute l’URL d’exemple par celle copiée sur votre forge, en conservant l’alias `origin`.

Vérifier l’association

Affichez les dépôts distants enregistrés et leurs adresses. La commande montre l’adresse utilisée pour lire le dépôt et celle destinée aux opérations d’envoi ; après l’ajout, elles sont identiques si vous avez déclaré une seule URL.

git remote -v

origin  https://forge.example/votre-compte/suivi-site.git (fetch)
origin  https://forge.example/votre-compte/suivi-site.git (push)

Les deux lignes doivent afficher `origin` et l’URL exacte de votre dépôt `suivi-site`. Si l’adresse est incorrecte, ne poursuivez pas avec une URL erronée : comparez-la à celle affichée par la forge. La commande d’ajout ne vérifie pas que vous avez accès au dépôt ni qu’il est joignable ; elle enregistre simplement l’adresse dans les paramètres du dépôt local.

À retenir

• Déclarez l’adresse de la forge depuis le dossier du dépôt local `suivi-site`.
• Utilisez `git remote add origin URL` pour enregistrer cette adresse sous l’alias `origin`.
• Vérifiez l’adresse avec `git remote -v` avant toute opération ultérieure.
• Cette association ne publie aucun commit et ne modifie pas la note provisoire de `README.md`.
• À la prochaine leçon, vous utiliserez ce lien pour publier les commits locaux.