Enregistrer votre travail avec des validations

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Git ne prend pas automatiquement des captures instantanées de votre travail lorsque vous modifiez des fichiers dans votre référentiel. Vous indiquez à Git les modifications de fichier que vous souhaitez capturer dans une capture instantanée en préproduction de modifications spécifiques. Après la mise en lots, vous enregistrez la capture instantanée en effectuant une validation.

Cet article fournit des procédures pour les tâches suivantes :

• De quelle manière Git effectue le suivi des modifications
• Éléments d’une validation
• De quelle manière indexer vos modifications
• De quelle manière créer une validation
• De quelle manière mettre à jour votre dernière validation

Pour obtenir une vue d’ensemble du flux de travail Git, consultez le tutoriel Git Azure Repos.

De quelle manière Git effectue le suivi des modifications

Lorsque vous travaillez dans votre référentiel, Git effectue le suivi des modifications apportées à tous les fichiers suivis . Les fichiers suivis sont des fichiers actuellement indexés ou inclus dans la validation précédente. Git sépare les fichiers suivis en trois catégories :

• Fichiers non modifiés : ces fichiers n’ont pas changé depuis votre dernière validation.
• Fichiers modifiés : fichiers que vous avez modifiés depuis votre dernière validation, mais que vous n’avez pas indexés pour la validation suivante.
• Fichiers indexés : fichiers modifiés depuis votre dernière validation, et indexés pour la validation suivante.

Lorsque vous créez une validation, seuls les fichiers intermédiaires et non modifiés sont utilisés pour la capture instantanée. Les modifications non indexés des fichiers modifiés sont conservées, mais la capture instantanée contient la version non modifiée de ces fichiers. Git n’effectue aucun suivi des modifications apportées aux nouveaux fichiers et n’inclut aucun nouveau fichier dans la capture instantanée tant que vous l’avez pas indexé.

Les validations sont créées dans votre référentiel Git local. Chaque validation ne doit pas être parfaite, et plusieurs validations peuvent être nécessaires pour effectuer une modification prévue. Créez des validations au cours de votre travail, et lorsque vous avez terminé, vous pouvez envoyer à un référentiel distant pour partager votre travail avec d’autres personnes.

Éléments d’une validation

Chaque validation comprend les informations suivantes :

• Une capture instantanée de tous les fichiers suivis dans votre référentiel lors de la validation. Une capture instantanée ne représente pas la différence entre les validations, bien que Git utilise des captures instantanées pour calculer la différence. Les captures instantanées permettent une commutation rapide entre les branches et prennent en charge la fusion de branches.
• Référence au(x) validation(s) parente(s). La plupart des validations détiennent un parent, mais la validation suivante après une fusion de branche comporte plusieurs parents et la première validation d’un référentiel n’en a aucun.
• Message décrivant les modifications apportées à la validation. Vous insérez le message lorsque vous créez la validation.

Git utilise les captures instantanées et les références parentes de chaque validation pour conserver un enregistrement complet du développement dans le référentiel. Pour examiner les modifications apportées à votre code, vous pouvez consulter l’historique Git de votre référentiel.

De quelle manière indexer vos modifications

Pour créer une capture instantanée pour une validation :

• Indexez les nouveaux fichiers pour demander à Git de les ajouter à la capture instantanée, et d’effectuer le suivi des modifications apportées à ces fichiers à l’avenir.
• Indexez les fichiers modifiés pour demander à Git de placer la version modifiée du fichier dans la capture instantanée, et non la version non modifiée du fichier.
• Indexez les fichiers supprimés pour demander à Git de les supprimer de la capture instantanée et de ne plus les suivre.

Pour exclure des fichiers temporaires, des fichiers journaux ou d’autres fichiers de votre instantané, vous pouvez configurer Git de manière à ignorer des fichiers spécifiques.

Notes

Git prend en charge l’indexation interactive des fichiers modifiés vous permettant de choisir d’indexer des modifications spécifiques dans un fichier. Il s’agit d’une fonctionnalité utile lorsque vous souhaitez modifier différents fichiers dans différentes validations.

Visual Studio 2022

Visual Studio 2022 offre une expérience de contrôle de version Git à l’aide du menu Git, des modifications Git et des menus contextuels dans l’Explorateur de solutions. Visual Studio 2019 version 16.8 offre également l’interface utilisateur Git de Team Explorer. Pour plus d’informations, consultez l’onglet Visual Studio 2019 - Team Explorer.

Dans la fenêtre Modifications Git, cliquez avec le bouton droit sur un fichier de la section Modifications et choisissez Indexer pour l’ajouter à la section Modifications indexées.

Vous pouvez également indexer un fichier modifié en sélectionnant le signe plus à côté du fichier. Pour indexer tous les fichiers modifiés dans un dossier, sélectionnez le signe plus à côté du dossier. Pour indexer tous les fichiers modifiés dans votre référentiel, sélectionnez le signe plus dans le coin supérieur droit de la section Modifications.

Vous pouvez indiquer à Git d’ignorer un fichier en cliquant dessus avec le bouton droit et en sélectionnant Ignorer cet élément local ou Ignorer cette extension. Ces deux commandes créent un fichier .gitignore dans votre référentiel s’il n’existe pas, et y ajoute une entrée. Les fichiers ignorés n’apparaissent pas dans la section Modifications de Visual Studio. Toutefois, le fichier .gitignore n’a aucun effet sur les fichiers suivis. Pour plus d’informations concernant la configuration de Git pour ignorer les fichiers suivis, consultez Ignorer les fichiers. Pour gagner du temps, vous pouvez télécharger des modèles .gitignore pour différents environnements de développement à partir du référentiel GitHub gitignore.

Notes

À compter de Visual Studio 2022 version 17.3, Visual Studio prend en charge les modifications partielles intermédiaires dans un fichier. Pour plus d’informations, consultez Indexer des lignes de code dans Visual Studio.

Visual Studio 2019 - Menu Git

Visual Studio 2019 offre une expérience de contrôle de version Git à l’aide du menu Git, des modifications Git et des menus contextuels dans l’Explorateur de solutions.

Dans la fenêtre Modifications Git, cliquez avec le bouton droit sur un fichier de la section Modifications et choisissez Indexer pour l’ajouter à la section Modifications indexées.

Vous pouvez également indexer un fichier modifié en sélectionnant le signe plus à côté du fichier. Pour indexer tous les fichiers modifiés dans un dossier, sélectionnez le signe plus à côté du dossier. Pour indexer tous les fichiers modifiés dans votre référentiel, sélectionnez le signe plus dans le coin supérieur droit de la section Modifications.

Vous pouvez indiquer à Git d’ignorer un fichier en cliquant dessus avec le bouton droit et en sélectionnant Ignorer cet élément local ou Ignorer cette extension. Ces deux commandes créent un fichier .gitignore dans votre référentiel s’il n’existe pas, et y ajoute une entrée. Les fichiers ignorés n’apparaissent pas dans la section Modifications de Visual Studio. Toutefois, le fichier .gitignore n’a aucun effet sur les fichiers suivis. Pour plus d’informations concernant la configuration de Git pour ignorer les fichiers suivis, consultez Ignorer les fichiers. Pour gagner du temps, vous pouvez télécharger des modèles .gitignore pour différents environnements de développement à partir du référentiel GitHub gitignore.

Visual Studio 2019 - Team Explorer

Visual Studio 2019 version 16.8 et versions ultérieures fournit une expérience de gestion de version Git tout en conservant l’interface utilisateur Git de Team Explorer. Pour utiliser Team Explorer, décochez Outils>Options>Fonctionnalités en préversion>Nouvelle expérience utilisateur Git dans la barre du menu. Vous pouvez exercer les fonctionnalités Git à partir de l’une ou l’autre interface de manière interchangeable.

1. Dans Team Explorer, sélectionnez le bouton Accueil et choisissez Modifications.

   

2. Dans la vue Modifications, cliquez avec le bouton droit sur un fichier de la section Modifications et choisissez Indexer pour l’ajouter à la section Modifications indexées.

   

   Vous pouvez également mettre en scène un fichier modifié en le faisant glisser de la section Modifications vers la section Modifications intermédiaires. Pour indexer tous les fichiers modifiés dans un dossier, cliquez avec le bouton droit sur le dossier et choisissez Indexer. Pour indexer tous les fichiers modifiés dans votre référentiel, sélectionnez le signe plus dans le coin supérieur droit de la section Modifications.

Vous pouvez indiquer à Git d’ignorer un fichier en cliquant dessus avec le bouton droit et en sélectionnant Ignorer cet élément local ou Ignorer cette extension. Ces deux commandes créent un fichier .gitignore dans votre référentiel s’il n’existe pas, et y ajoute une entrée. Les fichiers ignorés n’apparaissent pas dans la section Modifications de Visual Studio. Toutefois, le fichier .gitignore n’a aucun effet sur les fichiers suivis. Pour plus d’informations concernant la configuration de Git pour ignorer les fichiers suivis, consultez Ignorer les fichiers. Pour gagner du temps, vous pouvez télécharger des modèles .gitignore pour différents environnements de développement à partir du référentiel GitHub gitignore.

Notes

Visual Studio 2019 ne prend pas en charge les modifications partielles intermédiaires d’un fichier.

Ligne de commande Git

Pour indexer tous les fichiers suivis et non suivis dans votre référentiel modifiés depuis la dernière validation, utilisez la commande git add avec l’indicateur --all . Toutefois, l’indicateur --all n’indexe pas les fichiers que vous avez configurés pour que Git soit ignoré.

git add --all

Vous pouvez indexer des modifications dans des fichiers spécifiques à l’aide de la commande suivante.

git add <file path>

Vous pouvez indexer de manière interactive des parties d’un fichier modifié à l’aide de l’option --patch.

git add --patch <file path>

Les autres commandes Git associées sont les suivantes :

• git rm pour supprimer des fichiers dans votre référentiel et préparer la modification.
• git mv pour déplacer ou renommer des fichiers dans votre référentiel et indexer la modification.
• git statuspour passer en revue le statut actuel des modifications apportées à votre référentiel.

Pour plus d’informations concernant ces commandes, consultez la référence des commandes du tutoriel et la référence de ligne de commande Git.

Conseil

Une fois les fichiers indexés, passez en revue vos modifications indexées et non indexées en exécutant git status.

De quelle manière créer une validation

Visual Studio 2022

Dans la fenêtre Modifications Git, insérez un message décrivant vos modifications indexées puis sélectionnez Valider les modifications indexées.

Sélectionnez le lien de validation pour obtenir les détails de la validation.

Notes

Si toutes vos modifications ne sont pas indexées, vous pouvez ignorer l’indexation et valider directement en choisissant Valider tout.

Visual Studio 2019 - Menu Git

Dans la fenêtre Modifications Git, insérez un message décrivant vos modifications indexées puis sélectionnez Valider les modifications indexées.

Sélectionnez le lien de validation pour obtenir les détails de la validation.

Notes

Si toutes vos modifications ne sont pas indexées, vous pouvez ignorer l’indexation et valider directement en choisissant Valider tout.

Visual Studio 2019 - Team Explorer

1. Dans la vue Modifications de Team Explorer, insérez un message décrivant vos modifications indexées puis sélectionnez Valider les modifications indexées.

   

2. Sélectionnez le lien de validation pour obtenir les détails de la validation.

   

   Notes

   Si toutes vos modifications ne sont pas indexées, vous pouvez ignorer l’indexation et valider directement en choisissant Valider tout.

   

Ligne de commande Git

Vous pouvez créer une validation à l’aide de la commande git commit avec l’indicateur -m pour spécifier un message de validation. Si vous n’indiquez aucun message de validation, Git ouvre un éditeur vous permettant d’en fournir un.

git commit -m "<commit message>"

Conseil

Avant d’effectuer une validation, passez en revue vos modifications indexées et non indexées en exécutant git status.

De quelle manière mettre à jour votre dernière validation

Git prend en charge la modification des fichiers indexés ou du message de votre dernière validation. Cette opération remplace votre dernière validation par un nouvelle validation associant les fichiers indexés des deux validations et utilisant le nouveau message de validation. La modification d’une validation est utile si vous avez oublié d’indexer un fichier ou si votre dernier message de validation présente une faute de frappe.

Avertissement

Ne modifiez pas une validation déjà envoyée, ceci pouvant causer des problèmes de synchronisation avec votre référentiel distant. Pour une validation envoyée, utilisez l’une des stratégies suivantes :

• Créez et envoyez un autre validation corrigeant les problèmes causés par la validation précédente.
• Annulez la validation précédente envoyée, à l’aide de git revert pour créer une nouvelle validation qui rétablit toutes les modifications apportées par la validation précédente. Ensuite, envoyez (push) la nouvelle validation.

Visual Studio 2022

Dans la fenêtre Modifications Git, indexez un ou plusieurs fichiers, insérez un message de validation, sélectionnez Modifier, puis choisissez Valider les modifications indexées.

La fenêtre Modifications Git prend en charge la révision du message de validation, des fichiers indexés ou des deux. Lorsque vous sélectionnez Réviser, l’identificateur SHA de la validation précédente s’affiche.

Visual Studio 2019 - Menu Git

Dans la fenêtre Modifications Git, indexez un ou plusieurs fichiers, insérez un message de validation, sélectionnez Modifier, puis choisissez Valider les modifications indexées.

La fenêtre Modifications Git prend en charge la révision du message de validation, des fichiers indexés ou des deux. Lorsque vous sélectionnez Réviser, l’identificateur SHA de la validation précédente s’affiche.

Visual Studio 2019 - Team Explorer

Dans la vue Modifications de Team Explorer, indexez un ou plusieurs fichiers, insérez un message de validation, puis choisissez Actions >Réviser la validation précédente.

Team Explorer ne prend pas en charge la révision du message de validation sans réviser également un ou plusieurs fichiers indexés.

Ligne de commande Git

1. Indexez vos nouvelles modifications, le cas échéant.

2. Utilisez la commande git commit avec l’option --amend et l’indicateur -m pour spécifier le nouveau message de validation.

git commit --amend -m "<new message>"

Étapes suivantes

Créer un travail dans les branches

Articles connexes

• Nouveautés dans les référentiels Git ? En savoir plus