Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
Chargez des tâches de pipeline personnalisées ou standard dans votre organisation Azure DevOps ou votre collection de projets Azure DevOps Server à l’aide du CLI Node de Azure DevOps (tfx-cli).
Important
Lorsque vous chargez des tâches intégrées dans une instance azure DevOps Server, certaines fonctionnalités de tâche peuvent ne pas être prises en charge en raison de la version de l’agent ou de l’absence de prise en charge côté serveur.
Pour plus d’informations sur tfx-cli, veuillez consulter la section Node CLI pour Azure DevOps sur GitHub.
Conditions préalables
| Catégorie | Spécifications |
|---|---|
| Permissions | Appartenance au groupe Administrateurs du pool d’agents au niveau de l’organisation ou du regroupement. Consultez groupes de sécurité, comptes de service et autorisations. |
| Jetons | Un jeton d'accès personnel (PAT) ayant pour étendue pools d’agents (lecture et gestion), ou un jeton Microsoft Entra. Les jetons Entra sont recommandés plutôt que les PAT pour une meilleure sécurité. |
| Outils |
Dernière version de Node.js et tfx-cli installée globalement : npm install -g tfx-cli |
Se connecter avec tfx-cli
Connectez-vous à Azure DevOps à l’aide de tfx-cli avant de charger des tâches. Pour plus d’options d’authentification, consultez l’authentification CLI multiplateforme pour Azure DevOps.
Exécutez la commande suivante et fournissez l’URL du service et le mot de passe lorsque vous y êtes invité :
tfx login
Utilisez l’URL du service qui correspond à votre environnement :
| Environnement | Format d’URL |
|---|---|
| Azure DevOps Services | https://dev.azure.com/{organization} |
| Serveur Azure DevOps | http://{server}:{port}/DefaultCollection |
Charger des tâches
Conseil
Si vous devez mettre à jour les tâches de pipeline intégrées, vous pouvez cloner le référentiel azure-pipelines-tasks. Ensuite, générez les tâches requises en suivant les instructions : comment générer des tâches.
Chargez une tâche à l’aide de tfx-cli:
tfx build tasks upload --task-path <PATH_TO_TASK>
PATH_TO_TASK est le chemin d’accès au dossier qui contient la tâche compilée, y compris task.json.
Important
Les agents de pipeline mettent en cache les tâches par version. Si vous modifiez une tâche et que vous la rechargez avec le même numéro de version, les agents continuent d’utiliser la copie mise en cache. Incrémentez toujours au moins la version task.json du correctif avant de télécharger une tâche mise à jour.
Vérifier le chargement
Vérifiez que votre tâche a été chargée correctement :
tfx build tasks list
La sortie répertorie toutes les tâches sur le serveur, y compris le id, nameet version de chaque tâche.
Supprimer une tâche
Supprimez une tâche chargée en spécifiant son ID. Obtenez l’ID de tâche à partir de la tfx build tasks list sortie.
tfx build tasks delete --task-id <TASK_ID>
Avertissement
La suppression d’une tâche la supprime du serveur. Tout pipeline qui référence la tâche supprimée échoue lors de l’exécution suivante.
Résolution des problèmes
| Error | La cause | Réparer |
|---|---|---|
| 401 Non autorisé | PAT a expiré, a été révoqué ou manque le périmètre des pools d’agents (Lecture et gestion). | Créez un nouveau PAT avec l’étendue correcte. |
| 403 Interdit | Votre compte n’est pas dans le groupe Administrateurs du pool d’agents . | Demandez à un administrateur d’organisation de vous ajouter. |
| La tâche existe déjà | Charge la même version que celle déjà sur le serveur. | Mettez à jour la version du correctif dans task.json et téléchargez à nouveau. |
Pour plus d’informations sur tfx-cli, consultez la documentation Node CLI pour Azure DevOps.