Contrôle des versions avec Cloud Workstations

Cette page explique comment utiliser le contrôle des versions pour les fichiers de votre application avec la compatibilité Git de l'éditeur de base Cloud Workstations.

Cliquez sur  Contrôle des sources dans la barre des tâches pour créer un dépôt Git, accéder à vos dépôts Git existants, afficher les modifications existantes et en attente, ou 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 de base.

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.

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), qui est plus sécurisé plutôt que les 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 de base Cloud Workstations en cliquant sur Terminal > Nouveau terminal.
  2. Exécutez la commande suivante :

    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 la Éditeur de base Cloud Workstations Pour passer d'un dépôt à un autre, dans la Dans la barre d'état de l'éditeur de base Cloud Workstations, 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 action met à jour le panneau "Contrôle des sources : Git" avec le contexte du dépôt choisi.

Afficher les modifications en cours

Lorsque vous ajoutez, modifiez et supprimez des fichiers, ces modifications sont répercutées dans la section "Changes" (Modifications) du panneau "Source Control: Git" (Contrôle des sources : Git). 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 Contrôle des sources: Git, les 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 "Préproduction". Modifications. Cliquez sur l'un de ces fichiers pour afficher leur vue des différences, ce qui vous montre ce qui a changé entre l'état du fichier validé précédemment et l'état actuel.

Valider les modifications

Lorsque vous êtes prêt à vérifier vos modifications, vous pouvez le faire directement dans Cloud Workstations.

  1. Exécutez les commandes Git suivantes à l'aide du terminal Cloud Workstations. Veillez à mettre à jour l'adresse e-mail et le nom avec vos données:

    git config --global user.email alex@example.com
    git config --global user.name Alex
    
  2. Pour archiver votre modification, dans le panneau "Source Control: Git" (Contrôle des sources : Git) de l'éditeur de base, rédigez un message de commit, puis cliquez sur check_boxCommit (Archiver) ou appuyez sur Ctrl+Entrée (ou Cmd+Entrée sur Mac OS).

Cloner un dépôt

Pour cloner un dépôt Git distant à utiliser dans l'éditeur de base Cloud Workstations :

  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. Pour ouvrir la palette de commandes, appuyez sur Ctrl+Maj+P (ou Cmd+Maj+P sous macOS), ou cliquez sur Affichage > Palette de commandes.
  3. Exécutez Git : Cloner.
  4. Lorsque vous y êtes invité, saisissez l'emplacement du dépôt Git.

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

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

  1. Pour ouvrir la palette de commandes, appuyez sur Ctrl+Maj+P (ou Cmd+Maj+P sous macOS, ou cliquez sur Affichage > Palette de commandes.
  2. Exécutez Git: Checkout.
  3. 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.