Exercice : Initialiser un référentiel Git

5 minutes

Vous avez décidé que votre flux de travail pourrait tirer parti d’un système de contrôle de version, et vous allez essayer Git. Dans cet exercice, tous les éléments sont prêts pour que vous puissiez commencer à utiliser Git.

Pendant ce processus, vous allez :

Installer et configurer Git.
Créer et initialiser un référentiel Git.
Ajoutez un fichier Bicep au dossier du référentiel et observez comment l’état du référentiel change.

Notes

Visual Studio Code est un éditeur puissant et il offre de nombreuses façons différentes d’obtenir la même chose. Presque toutes les actions disposent de raccourcis clavier. Il existe souvent plusieurs façons d’effectuer des actions courantes à l’aide de l’interface utilisateur. Ce module vous guidera pour effectuer les actions à l’aide d’une approche. N’hésitez pas à utiliser une autre approche si vous le souhaitez.

Installer Git

Installer Git. Choisissez la version appropriée en fonction de votre système d’exploitation.
Si vous avez déjà Visual Studio Code ouverte, redémarrez-la pour qu’elle détecte votre installation Git.

Configurer Git

Vous devez exécuter quelques commandes pour configurer Git afin qu’il associe votre nom et votre adresse e-mail à votre activité. Cette identification vous aide quand vous utilisez Git pour collaborer avec d’autres utilisateurs. Si vous avez déjà configuré Git, vous pouvez ignorer ces étapes et passer à la section suivante.

Ouvrez Visual Studio Code.
Ouvrez une fenêtre de terminal Visual Studio Code en sélectionnant Terminal>Nouveau terminal. Elle s’ouvre généralement en bas de l’écran.
Pour vérifier que Git est maintenant installé, tapez la commande suivante :
```
git --version
```
Si une erreur s’affiche, vérifiez que vous avez installé Git, redémarrez Visual Studio Code, puis réessayez.
Définissez votre nom à l’aide de la commande suivante. Remplacez USER_NAME par le nom d’utilisateur que vous souhaitez utiliser. Utilisez votre prénom et votre nom pour que les membres de votre équipe sachent que c’est vous.
```
git config --global user.name "USER_NAME"
```
Définissez votre adresse de messagerie à l’aide de la commande suivante. Remplacez USER_EMAIL_ADDRESS par votre adresse e-mail.
```
git config --global user.email "USER_EMAIL_ADDRESS"
```
Exécutez la commande suivante pour vérifier que vos changements ont bien été effectués :
```
git config --list
```
Vérifiez que la sortie comprend deux lignes qui sont similaires à celles de l’exemple suivant. Votre nom et votre adresse e-mail seront différents de ce qui est montré dans l’exemple.
```
user.name=User Name
user.email=user-name@contoso.com
```

Créer et initialiser un référentiel Git

Dans le terminal Visual Studio Code, créez un nouveau dossier nommé toy-website :
```
mkdir toy-website
cd toy-website
```
À l’aide du terminal Visual Studio Code, exécutez la commande suivante pour rouvrir Visual Studio Code avec le dossier toy-website chargé :
```
code --reuse-window .
```
Visual Studio Code se recharge. Si vous êtes invité à approuver le dossier, sélectionnez Oui, j’ai confiance dans les auteurs.
Dans le terminal Visual Studio Code, exécutez la commande suivante pour initialiser un nouveau dépôt Git dans le dossier toy-website que vous avez créé :
```
git init
```
Git affiche un message confirmant qu’il a initialisé un référentiel Git vide.

Ajouter un fichier Bicep

Créez un sous-dossier nommé Déployer. Vous pouvez créer le dossier en utilisant Explorer dans Visual Studio Code, ou vous pouvez utiliser la commande suivante dans le terminal Visual Studio Code :
```
mkdir deploy
```
Dans le dossier Déployer, créez un fichier appelé main.bicep.
Ouvrez et enregistrez le fichier vide afin que Visual Studio Code charge les outils Bicep.

Vous pouvez sélectionner Fichier>Enregistrer sous ou sélectionner le raccourci clavier Ctrl + s pour Windows (⌘ + s pour macOS). Assurez-vous de bien noter l’emplacement où le fichier est enregistré. Vous pouvez par exemple créer un dossier scripts pour l’y enregistrer.

Copiez le code suivant dans main.bicep.

@description('The Azure region into which the resources should be deployed.')
param location string = resourceGroup().location

@description('The type of environment. This must be nonprod or prod.')
@allowed([
  'nonprod'
  'prod'
])
param environmentType string

Ce fichier Bicep contient deux paramètres, mais ne définit pas encore de ressources.

Enregistrez le fichier .

Notes

Même si vous avez enregistré le fichier dans le dossier de votre référentiel, Git ne le suit pas encore. Vous apprendrez comment Git effectue le suivi des fichiers dans l’unité suivante.

Inspecter l’état du référentiel à l’aide de l’interface CLI

Git surveille les modifications dans le dossier du référentiel. Vous pouvez interroger Git pour voir la liste des fichiers qui ont été modifiés. Cette fonctionnalité est utile pour voir ce que vous avez fait et pour vérifier que vous n’avez pas ajouté accidentellement des fichiers ou apporté des modifications que vous n’avez pas pu inclure. Vous pouvez utiliser l’interface de commande Git et Visual Studio Code pour afficher l’état de votre référentiel.

Dans le terminal Visual Studio Code, exécutez la commande suivante :
```
git status
```
Afficher les résultats. Ils sont semblables à l’exemple suivant :
```
On branch main

No commits yet

Untracked files:
  (use "git add <file>..." to include in what will be committed)
        deploy/

nothing added to commit but untracked files present (use "git add" to track)
```
Ce texte vous indique quatre éléments d’information :
- Vous êtes actuellement sur la branche main . Vous découvrirez les branches un peu plus loin.
- Aucune validation n’a été effectuée sur ce référentiel. Vous découvrirez les validations dans l’unité suivante.
- Il y a des fichiers non suivis dans le dossier de déploiement.
- Vous n’avez pas encore indiqué à Git d’ajouter des fichiers à suivre par le référentiel.
Examinez la première ligne de la sortie de l’étape précédente. Si elle affiche un nom de branche différent de main, exécutez la commande suivante pour renommer votre branche en main :
```
git branch -M main
```
Cette commande garantit que vous pouvez suivre les exercices restants dans ce module.

Inspectez l’état du référentiel à l’aide de Visual Studio Code

Visual Studio Code affiche les mêmes informations que celles git status fournies par la commande, mais intègre les informations dans l’interface Visual Studio Code.

Dans Visual Studio Code, sélectionnez Afficher>Contrôle de code source ou sélectionnez Ctrl+Maj+G sur le clavier.

Le Contrôle de code source s’ouvre.

Visual Studio Code indique que le fichier main.bicep dans le dossier de déploiement a changé. En outre, l’icône de Contrôle de code source comporte un badge qui indique le nombre 1, ce qui indique un fichier non suivi.
La barre d’état apparaît au bas de Visual Studio Code. Elle fournit des informations et des fonctionnalités utiles. Vers le côté gauche, la barre d’état affiche le mot main :

Ce mot indique que vous êtes actuellement dans la branche principale . Vous découvrirez les branches un peu plus loin.

L’état signalé par Git et Visual Studio Code est le même, car l’interface CLI Git et Visual Studio Code utilisent le même moteur Git. Vous pouvez mélanger et associer les outils que vous utilisez pour travailler avec vos référentiels. Vous pouvez utiliser différents outils en fonction de ce qui vous convient le mieux.