Belgeler / İşbirliği ve entegrasyonlar
Jira, Jenkins, CloudBees ve Görevlerim
Ticket'larınız, pipeline'larınız ve dağıtımlarınız IDE'nin içinde. Ajan ihtiyacı olanı okur ve her yazma işlemi onayınızı bekler.
Yuli, IDE'yi Jira, Jenkins ve CloudBees CD/RO ile bağlar. Ticket'larınızı, build'lerinizi ve dağıtımlarınızı düzenleyiciden çıkmadan görürsünüz; ajan da bunları araç olarak kullanır: serbestçe okuyabilir, ancak bir şeyi değiştiren her işlem onayınızı bekler.
Nerede yapılandırılır
| Hizmet | Nerede |
|---|---|
| Jira | MCP sunucuları içinde bir kayıt. |
| Jenkins | Ajan için MCP sunucuları içinde bir kayıt; pipeline'ları görmek için CI bağlantıları içinde. |
| CloudBees CD/RO | CI bağlantıları; bir API token'ı veya kullanıcı adınız ve parolanızla (yalnızca okumak için kullanılır). |
| Proje ayarları | .ai/devops.json: dal biçimi, Jenkins job'ı ve CloudBees kapsamı. |
CI bağlantıları Jenkins, GitLab CI, GitHub Actions ve CloudBees'i bir araya getirir. Kimlik bilgileri sistem anahtarlığında saklanır.
Jira
Yuli, Jira Cloud (e-posta ve API token'ı) ve Data Center (Personal Access Token) ile çalışır.
| Araç | Ne yapar | Onay |
|---|---|---|
jira.search_issues |
Ticket arar. | Hayır |
jira.get_issue |
Bir ticket'ı okur. | Hayır |
jira.list_projects |
Projeleri listeler. | Hayır |
jira.list_boards |
Panoları listeler. | Hayır |
jira.list_sprints |
Sprint'leri listeler. | Hayır |
jira.list_transitions |
Bir ticket'ın geçebileceği durumları listeler. | Hayır |
jira.create_issue |
Bir ticket oluşturur. | Evet |
jira.update_issue |
Bir ticket'ı değiştirir. | Evet |
jira.transition_issue |
Bir ticket'ın durumunu değiştirir. | Evet |
jira.add_comment |
Bir ticket'a yorum ekler. | Evet |
jira.attach_branch |
Bir dalı bir ticket ile ilişkilendirir. | Evet |
Ajan bir dalı proje belirtmeden ilişkilendirdiğinde Yuli, ajanın üzerinde çalıştığı projeyi kullanır.
Bir ticket'tan dal oluşturma
Git panelinde Jira ticket'larım ticket'larınızı listeler. Ticket'tan dal oluştur, dalı projenin biçimiyle oluşturur ve ticket'ı devam eden durumuna taşımayı önerir.
Biçim, ekiple birlikte sürümlenen .ai/devops.json dosyasında tanımlanır:
{
"branchFormat": "{prefix}/{key}-{slug}",
"typePrefixes": { "bug": "bugfix", "hotfix": "hotfix" },
"defaultPrefix": "feature",
"maxSlugLength": 40
}| Yer tutucu | Yerine gelen |
|---|---|
{prefix} |
Ticket türüne göre ön ek (hata için bugfix, olay için hotfix; geri kalanı için feature). |
{key} |
Ticket anahtarı, örneğin PAY-214. |
{slug} |
Ticket başlığının küçük harfli ve tireli hali. |
{type} |
Ticket türü. |
{project} |
Jira projesi. |
Varsayılan biçimle, «Validar importe» başlıklı PAY-214 hikâyesi feature/PAY-214-validar-importe dalını verir. Slug, aksanları ve işaretleri kaldırır: «Añadir inicio de sesión con SSO (Azure)» başlığı anadir-inicio-de-sesion-con-sso-azure olur.
Jenkins
| Araç | Ne yapar | Onay |
|---|---|---|
jenkins.list_jobs |
Job'ları listeler. | Hayır |
jenkins.get_job |
Bir job'ı okur. | Hayır |
jenkins.get_build |
Bir build'i okur. | Hayır |
jenkins.get_console_log |
Bir build'in konsolunu okur. | Hayır |
jenkins.get_queue |
Kuyruğu okur. | Hayır |
jenkins.trigger_build |
Bir build başlatır. | Evet |
Ajandan örneğin şunu isteyin: «Bu dalın son build'i neden başarısız oldu?». Konsolu okur ve size nedenini söyler.
CloudBees CD/RO
Ajanın salt okunur tek bir aracı vardır: cloudbees. Bu araçla pipeline çalıştırmalarını aşamaları ve görevleriyle, job'ları (adımlar, hatalar ve loglar), yapılandırmayı (gizli bilgiler maskelenmiş olarak) ve projenin Kubernetes workload'ındaki pod'ları görür.
Kapsam, .ai/devops.json → cloudbees içinde yapılandırdığınız kapsamdır: projenizin pipeline'ları, ortamları ve workload'ı. Ajan hiçbir şeyi başlatamaz, onaylayamaz veya değiştiremez: size ne yapmanız gerektiğini söyler.
IDE'de bunu Dağıtımlar (CloudBees) içinde görürsünüz.
Görevlerim
Görevlerim, Jira ticket'larınızı, kod barındırma platformunuzdaki issue'ları ve pull request'lerinizi veya merge request'lerinizi (GitHub, GitLab, Bitbucket ve Azure) tek bir listede toplar. Görevlerim komutuyla (Git grubu) veya durum çubuğundaki Dalın görevi: alanından açın.
| Filtre | Seçenekler |
|---|---|
| Kapsam | Sprint'teki benimkiler, Etkin sprint (ekip) |
| Kaynak | Tümü, Issue'lar, Pull request'ler |
| Eylem | Ne yapar |
|---|---|
| Başla | Görevin dalını oluşturur ve isterseniz ticket'ı taşır. |
| Dalına geç | O görevin dalına geçer. |
Hiçbir şey bağlı değilse Görevlerim, Jira'yı (MCP sunucuları içinde) ya da bir GitHub veya GitLab hesabını bağlamanızı ister.
Ayrıca bkz. Git ve CI/CD ve MCP sunucusu olarak Yuli.