doc-locale/fr-fr/editor_extensions/visual_studio_code/setup.md
Pour utiliser l'extension GitLab pour VS Code, installez l'extension, connectez-vous à GitLab, puis configurez-la selon vos besoins.
Choisissez la méthode d'installation qui correspond à vos besoins :
Pour une sécurité renforcée, configurez l'extension et utilisez GitLab Duo dans un environnement de développement conteneurisé à l'aide des VS Code Dev Containers.
Prérequis :
Pour installer l'extension dans un VS Code Dev Container :
Exécutez la commande Dev Containers : Add Dev Container Configuration Files depuis la palette de commandes.
Ajoutez l'extension GitLab au fichier de configuration :
// .devcontainer/devcontainer.json
{
"name": "My Project",
"image": "mcr.microsoft.com/devcontainers/base:ubuntu",
"customizations": {
"vscode": {
"extensions": [
"GitLab.gitlab-workflow"
]
}
}
}
Exécutez la commande Dev Containers : Open Folder in Container pour ouvrir votre projet dans un VS Code Dev Container. VS Code installe automatiquement l'extension dans le conteneur.
Après avoir installé l'extension, authentifiez-vous, puis connectez votre projet à un dépôt sur GitLab.
{{< history >}}
{{< /history >}}
{{< tabs >}}
{{< tab title="GitLab.com" >}}
Prérequis :
api.Pour s'authentifier avec GitLab :
GitLab: Authenticate et appuyez sur <kbd>Enter</kbd>.http:// ou https://. Appuyez sur <kbd>Enter</kbd> pour confirmer.{{< /tab >}}
{{< tab title="GitLab Self-Managed et GitLab Dedicated" >}}
Prérequis :
api.Pour utiliser OAuth, configurez d'abord la connexion de l'application OAuth :
Preferences: Open User Settings et appuyez sur <kbd>Enter</kbd>.Pour s'authentifier avec GitLab :
GitLab: Authenticate et appuyez sur <kbd>Enter</kbd>.http:// ou https://. Appuyez sur <kbd>Enter</kbd> pour confirmer.{{< /tab >}}
{{< /tabs >}}
L'extension associe l'URL distante de votre dépôt Git à l'URL de l'instance GitLab que vous avez spécifiée pour votre jeton. Si vous avez plusieurs comptes ou projets, vous pouvez choisir celui que vous souhaitez utiliser.
[!note] Si votre instance GitLab ou votre réseau utilise une configuration SSL personnalisée, vous pouvez configurer l'extension pour prendre en charge les certificats auto-signés. Pour plus d'informations, consultez utiliser l'extension avec des certificats auto-signés.
Pour vous connecter à votre dépôt GitLab depuis VS Code :
Dans VS Code, dans le menu supérieur, sélectionnez Terminal > New Terminal.
Clonez votre dépôt : git clone <repository>.
Accédez au répertoire dans lequel votre dépôt a été cloné et extrayez votre branche : git checkout <branch_name>.
Assurez-vous que votre projet est sélectionné :
Dans le terminal, vérifiez que votre dépôt est configuré avec un distant : git remote -v. Les résultats devraient ressembler à :
origin [email protected]:gitlab-org/gitlab.git (fetch)
origin [email protected]:gitlab-org/gitlab.git (push)
Si aucun distant n'est défini, ou si vous avez plusieurs distants :
L'extension affiche des informations dans la barre d'état VS Code si les deux conditions suivantes sont remplies :
Pour configurer les paramètres, accédez à Paramètres > Extensions > GitLab.
Après vous être authentifié et connecté à votre dépôt, l'extension associe automatiquement votre compte GitLab et votre projet en fonction de la configuration de votre dépôt Git.
Dans certains environnements, une configuration supplémentaire peut être nécessaire pour conserver vos identifiants.
Si vous supprimez souvent votre stockage VS Code, par exemple dans des conteneurs Gitpod, stockez vos jetons d'authentification dans des variables d'environnement VS Code. Les variables d'environnement persistent lorsque vous supprimez votre stockage VS Code.
Définissez ces variables avant de démarrer VS Code :
GITLAB_WORKFLOW_INSTANCE_URL : L'URL de votre instance GitLab. Par exemple, https://gitlab.com.GITLAB_WORKFLOW_TOKEN : Votre jeton d'accès personnel.Si vous configurez un jeton pour la même instance GitLab dans l'extension, le jeton de l'extension remplace la variable d'environnement.
L'extension utilise un compte pour chaque workspace VS Code (fenêtre). Elle sélectionne automatiquement le compte dans les cas suivants :
git remote.Si plusieurs comptes GitLab existent et que l'extension ne peut pas déterminer quel compte utiliser, elle ajoute Multiple GitLab Accounts ({{< icon name="question-o" >}}) à la barre d'état. Pour sélectionner un compte GitLab, sélectionnez l'élément de la barre d'état et suivez les invites.
Vous pouvez également utiliser la palette de commandes :
GitLab: Select Account for this Workspace.L'extension utilise le distant de votre dépôt Git pour déterminer quel projet GitLab associer à votre workspace VS Code.
Lorsque votre dépôt Git possède plusieurs distants pointant vers différents projets GitLab, l'extension ne peut pas déterminer lequel utiliser. Par exemple :
origin : [email protected]:gitlab-org/gitlab-vscode-extension.gitpersonal-fork : [email protected]:myusername/gitlab-vscode-extension.gitDans ces cas, l'extension ajoute un label (multiple projects) à la barre d'état.
Pour sélectionner un projet :
La liste Tickets et requêtes de fusion est mise à jour avec les informations du projet sélectionné.
Pour modifier la sélection de votre projet :
Les fonctionnalités GitLab Duo sont activées par défaut dans VS Code lorsque vous remplissez les prérequis :
Pour approuver les outils Agentic Chat une fois par session plutôt qu'individuellement, consultez les approbations d'outils.
Pour désactiver les fonctionnalités GitLab Duo dans VS Code :
GitLab pour VS Code utilise les paramètres de télémétrie de Visual Studio Code pour envoyer des informations sur l'utilisation et les erreurs à GitLab. Pour activer ou personnaliser la télémétrie dans Visual Studio Code :
all : Envoie des données d'utilisation, la télémétrie d'erreurs générales et des rapports de plantage.error : Envoie la télémétrie d'erreurs générales et des rapports de plantage.crash : Envoie des rapports de plantage au niveau du système d'exploitation.off : Désactive toutes les données de télémétrie dans Visual Studio Code.