Utiliser le contrôle des versions avec l'éditeur Cloud Shell

Cette page explique comment utiliser le contrôle des versions pour vos fichiers d'application grâce à la compatibilité de l'éditeur Cloud Shell avec Git.

Utiliser le contrôle des versions

En cliquant sur la vue "Contrôle des sources" dans la barre d'activité , vous pouvez accéder à vos dépôts Git (ou en créer un), afficher les modifications existantes et intermédiaires, et fusionner les modifications.

À partir de là, vous pouvez mettre en attente des modifications et annuler leur mise en attente, comparer l'état précédent et la version actuelle des fichiers, et valider les modifications, le tout depuis l'éditeur Cloud Shell.

S'authentifier avec Git

Pour extraire ou transférer des modifications vers votre dépôt Git, ou pour cloner votre dépôt comme vous le faites lors de l'importation d'un exemple personnalisé, vous devez vous authentifier avec Git. Cependant, si vous utilisez Cloud Source Repositories, Cloud Shell gère automatiquement l'authentification pour vous.

Lorsque vous effectuez une action nécessitant une authentification, Git vous invite à saisir un mot de passe. Saisissez un jeton d'accès personnel (PAT, une alternative plus sécurisée aux mots de passe Git). Pour en savoir plus sur la configuration de votre PAT, consultez le guide Créer un jeton d'accès personnel.

Pour améliorer l'efficacité de votre workflow et éviter d'avoir à saisir votre jeton plusieurs fois, activez l'assistant d'identification pour autoriser Git à mettre en cache votre jeton pendant 15 minutes:

1. Lancez le terminal de l'éditeur Cloud Shell en cliquant sur Terminal > Nouveau terminal.

2. Exécutez la commande ci-dessous.

   git config --global credential.helper cache
   

Pour plus d'options de personnalisation comme la modification de la durée du délai d'expiration et la spécification d'un chemin d'accès local pour le stockage des identifiants, consultez la documentation Outils Git pour le stockage des identifiants.

Basculer entre plusieurs dépôts

Vous pouvez travailler sur plusieurs dépôts Git avec l'éditeur Cloud Shell. Pour basculer entre vos dépôts, dans la barre d'état de l'éditeur Cloud Shell, cliquez sur le nom de votre dépôt. Dans le menu, sélectionnez le dépôt vers lequel vous souhaitez basculer votre champ d'application.

Cette opération met à jour votre panneau de contrôle source avec le contexte du dépôt sélectionné.

Afficher les modifications fonctionnelles

Lorsque vous ajoutez, modifiez et supprimez des fichiers, ces modifications sont répercutées dans la section "Modifications" du panneau de contrôle des sources. Vous pouvez choisir d'ouvrir le fichier sélectionné, de mettre en attente ces modifications, de les supprimer ou d'afficher les modifications apportées dans ce commit.

Activer l'affichage des différences

Dans le panneau de configuration des sources, vos fichiers modifiés sont répertoriés sous "Modifications". Si vous avez préparé vos fichiers modifiés, ils sont également répertoriés sous "Modifications par étapes". Cliquez sur l'un de ces fichiers pour afficher la vue des différences, montrant ce qui a changé entre l'état précédemment validé du fichier et l'état actuel.

Valider les modifications

Lorsque vous êtes prêt à archiver vos modifications, vous pouvez le faire directement dans Cloud Shell.

1. Exécutez les commandes Git suivantes à l'aide du terminal Cloud Shell :

   git config --global user.email [e-mail]
   git config --global user.name YourName
   

2. Pour vérifier votre modification, dans le panneau de contrôle des sources de l'éditeur Cloud Shell, rédigez un message de commit, puis cliquez sur Valider ou appuyez sur Cmd/Ctrl+Entrée.

Cloner un dépôt

Pour cloner un dépôt Git distant à utiliser dans l'éditeur Cloud Shell, procédez comme suit :

1. Récupérez l'URL du dépôt: pour les dépôts GitHub, ouvrez la page principale de votre dépôt, puis ouvrez la boîte de dialogue "Cloner" ou "Télécharger".
2. Lancez la palette de commandes (appuyez sur Ctrl/Cmd+Shift+P ou cliquez sur View > Command Palette (Affichage > Palette de commandes), puis exécutez Git: Clone.
3. Lorsque vous y êtes invité, saisissez l'emplacement du dépôt Git.

Créer des branches et passer d'une branche à une autre

Pour créer une branche ou basculer vers une branche existante, procédez comme suit :

1. Lancez la palette de commandes (appuyez sur Ctrl/Cmd+Shift+P ou cliquez sur View > Command Palette (Affichage > Palette de commandes), puis exécutez Git: Checkout.
2. Sélectionnez une branche dans la liste ou créez-en une nouvelle.

Barre d'état Git

La barre d'état Git permet de suivre votre branche actuelle et de passer à une autre branche avec l'indicateur de branche. Il fournit également l'action "Synchroniser les modifications" pour rechercher les modifications entre votre dépôt local et votre branche en amont. La synchronisation des modifications transfère les modifications locales vers votre branche en amont, puis extrait les modifications distantes dans votre dépôt local.

Si vous n'avez pas configuré de branche en amont, l'action "Publier" est disponible pour transférer vos modifications locales vers un dépôt distant.