Documentation / Collaboration et intégrations

Jira, Jenkins, CloudBees et Mes tâches

Vos tickets, vos pipelines et vos déploiements dans l’IDE. L’agent lit ce dont il a besoin et chaque écriture attend votre approbation.

Yuli relie l’IDE à Jira, Jenkins et CloudBees CD/RO. Vous voyez vos tickets, vos builds et vos déploiements sans quitter l’éditeur, et l’agent les utilise comme des outils : il peut lire librement, mais tout ce qui modifie quelque chose attend votre approbation.

Où le configurer

Service Où
Jira Une entrée dans Serveurs MCP.
Jenkins Une entrée dans Serveurs MCP pour l’agent, et dans Connexions CI pour voir les pipelines.
CloudBees CD/RO Connexions CI, avec un token d’API ou votre nom d’utilisateur et votre mot de passe (utilisés uniquement en lecture).
Réglages du projet .ai/devops.json : format des branches, job Jenkins et périmètre CloudBees.

Connexions CI regroupe Jenkins, GitLab CI, GitHub Actions et CloudBees. Les identifiants sont conservés dans le trousseau du système.

Jira

Yuli fonctionne avec Jira Cloud (e-mail et token d’API) et Data Center (Personal Access Token).

Outil Rôle Approbation
jira.search_issues Recherche des tickets. Non
jira.get_issue Lit un ticket. Non
jira.list_projects Liste les projets. Non
jira.list_boards Liste les tableaux. Non
jira.list_sprints Liste les sprints. Non
jira.list_transitions Liste les statuts vers lesquels un ticket peut passer. Non
jira.create_issue Crée un ticket. Oui
jira.update_issue Modifie un ticket. Oui
jira.transition_issue Change le statut d’un ticket. Oui
jira.add_comment Commente un ticket. Oui
jira.attach_branch Associe une branche à un ticket. Oui

Lorsque l’agent associe une branche sans indiquer le projet, Yuli utilise le projet sur lequel l’agent travaille.

Une branche à partir d’un ticket

Dans le panneau Git, Mes tickets Jira liste vos tickets. Créer une branche depuis le ticket crée la branche au format du projet et vous propose de passer le ticket au statut en cours.

Le format est défini dans .ai/devops.json, versionné avec l’équipe :

json
{
  "branchFormat": "{prefix}/{key}-{slug}",
  "typePrefixes": { "bug": "bugfix", "hotfix": "hotfix" },
  "defaultPrefix": "feature",
  "maxSlugLength": 40
}
Marqueur Remplacé par
{prefix} Le préfixe selon le type du ticket (bugfix pour un bug, hotfix pour un incident ; feature pour le reste).
{key} La clé du ticket, par exemple PAY-214.
{slug} Le titre du ticket en minuscules, avec des tirets.
{type} Le type du ticket.
{project} Le projet Jira.

Avec le format par défaut, la story PAY-214 « Validar importe » donne la branche feature/PAY-214-validar-importe. Le slug supprime les accents et les signes : « Añadir inicio de sesión con SSO (Azure) » devient anadir-inicio-de-sesion-con-sso-azure.

Jenkins

Outil Rôle Approbation
jenkins.list_jobs Liste les jobs. Non
jenkins.get_job Lit un job. Non
jenkins.get_build Lit un build. Non
jenkins.get_console_log Lit la console d’un build. Non
jenkins.get_queue Lit la file d’attente. Non
jenkins.trigger_build Lance un build. Oui

Demandez par exemple à l’agent : « Pourquoi le dernier build de cette branche a-t-il échoué ? ». Il lira la console et vous en donnera la cause.

CloudBees CD/RO

L’agent dispose d’un seul outil en lecture seule, cloudbees. Il lui permet de voir les exécutions des pipelines avec leurs étapes et leurs tâches, les jobs (étapes, erreurs et logs), la configuration (avec les secrets masqués) et les pods du workload Kubernetes du projet.

Le périmètre est celui que vous avez configuré dans .ai/devops.json → cloudbees : les pipelines, les environnements et le workload de votre projet. L’agent ne peut rien lancer, approuver ni modifier : il vous dit quoi faire.

Dans l’IDE, vous le retrouvez dans Déploiements (CloudBees).

Mes tâches

Mes tâches réunit dans une seule liste vos tickets Jira, les issues de votre forge et vos pull requests ou merge requests (GitHub, GitLab, Bitbucket et Azure). Ouvrez-le avec la commande Mes tâches (groupe Git) ou depuis la barre d’état, dans Tâche de la branche :.

Filtre Options
Périmètre Les miens dans le sprint, Sprint actif (équipe)
Origine Tout, Issues, Pull requests
Action Rôle
Commencer Crée la branche de la tâche et, si vous le souhaitez, déplace le ticket.
Passer à sa branche Bascule sur la branche de cette tâche.

Si rien n’est connecté, Mes tâches vous propose de connecter Jira (dans Serveurs MCP) ou un compte GitHub ou GitLab.

Voir aussi Git et CI/CD et Yuli comme serveur MCP.