n8n-nodes-azuredevops-advanced 0.1.0 → 0.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +595 -0
- package/package.json +1 -1
package/README.md
ADDED
|
@@ -0,0 +1,595 @@
|
|
|
1
|
+
# n8n-nodes-azuredevops-advanced
|
|
2
|
+
|
|
3
|
+
[](https://www.npmjs.com/package/n8n-nodes-azuredevops-advanced)
|
|
4
|
+
[](https://www.npmjs.com/package/n8n-nodes-azuredevops-advanced)
|
|
5
|
+
[](https://opensource.org/licenses/MIT)
|
|
6
|
+
[](https://docs.n8n.io/integrations/community-nodes/)
|
|
7
|
+
|
|
8
|
+
Azure DevOps için kapsamlı bir n8n community node paketi. Git, Pipeline, Work Items, Pull Requests, Test Plans, Boards, Wiki, Service Hooks, TFVC ve Artifacts kaynaklarını tek bir node üzerinden yönetmenizi sağlar.
|
|
9
|
+
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
## İçindekiler
|
|
13
|
+
|
|
14
|
+
- [Özellikler](#özellikler)
|
|
15
|
+
- [Kurulum](#kurulum)
|
|
16
|
+
- [Kimlik Bilgileri Yapılandırması](#kimlik-bilgileri-yapılandırması)
|
|
17
|
+
- [Kaynaklar ve Operasyonlar](#kaynaklar-ve-operasyonlar)
|
|
18
|
+
- [Git Repositories](#1-git-repositories)
|
|
19
|
+
- [Pipeline (CI/CD)](#2-pipeline-cicd)
|
|
20
|
+
- [Work Items](#3-work-items)
|
|
21
|
+
- [Pull Requests](#4-pull-requests)
|
|
22
|
+
- [Test Plans](#5-test-plans)
|
|
23
|
+
- [Boards](#6-boards)
|
|
24
|
+
- [Wiki](#7-wiki)
|
|
25
|
+
- [Service Hooks](#8-service-hooks)
|
|
26
|
+
- [TFVC](#9-tfvc)
|
|
27
|
+
- [Artifacts](#10-artifacts)
|
|
28
|
+
- [Kullanım Örnekleri](#kullanım-örnekleri)
|
|
29
|
+
- [Gereksinimler](#gereksinimler)
|
|
30
|
+
- [Katkıda Bulunma](#katkıda-bulunma)
|
|
31
|
+
- [Lisans](#lisans)
|
|
32
|
+
|
|
33
|
+
---
|
|
34
|
+
|
|
35
|
+
## Özellikler
|
|
36
|
+
|
|
37
|
+
- **10 farklı Azure DevOps kaynağı** tek node üzerinden
|
|
38
|
+
- **40+ operasyon** ile kapsamlı otomasyon
|
|
39
|
+
- Azure DevOps REST API **v7.1** desteği
|
|
40
|
+
- Personal Access Token (PAT) ile güvenli kimlik doğrulama
|
|
41
|
+
- n8n'nin hata yönetimi ve **continueOnFail** desteği
|
|
42
|
+
- TypeScript ile geliştirilmiş, tam tip güvenliği
|
|
43
|
+
|
|
44
|
+
### Desteklenen Kaynaklar
|
|
45
|
+
|
|
46
|
+
| Kaynak | Operasyon Sayısı | Açıklama |
|
|
47
|
+
|--------|-----------------|----------|
|
|
48
|
+
| Git Repositories | 4 | Repo listeleme, dosya okuma, branch oluşturma, commit push |
|
|
49
|
+
| Pipeline (CI/CD) | 4 | Pipeline listeleme, çalıştırma, log alma, iptal etme |
|
|
50
|
+
| Work Items | 6 | İş öğesi oluşturma, güncelleme, listeleme, kullanıcı ve etiket yönetimi |
|
|
51
|
+
| Pull Requests | 5 | PR oluşturma, güncelleme, listeleme, yorum okuma |
|
|
52
|
+
| Test Plans | 4 | Test planı, suite, case ve run listeleme |
|
|
53
|
+
| Boards | 3 | Board, kolon ve iterasyon (sprint) listeleme |
|
|
54
|
+
| Wiki | 4 | Wiki sayfası okuma, oluşturma, güncelleme |
|
|
55
|
+
| Service Hooks | 2 | Webhook abonelik listeleme ve oluşturma |
|
|
56
|
+
| TFVC | 2 | TFVC branch listeleme ve dosya okuma |
|
|
57
|
+
| Artifacts | 2 | Feed ve paket listeleme |
|
|
58
|
+
|
|
59
|
+
---
|
|
60
|
+
|
|
61
|
+
## Kurulum
|
|
62
|
+
|
|
63
|
+
### n8n Arayüzü Üzerinden (Önerilen)
|
|
64
|
+
|
|
65
|
+
1. n8n'de **Settings → Community Nodes** sayfasına gidin
|
|
66
|
+
2. **Install** butonuna tıklayın
|
|
67
|
+
3. Paket adını girin: `n8n-nodes-azuredevops-advanced`
|
|
68
|
+
4. **Install** butonuna tıklayın ve yeniden başlatmayı onaylayın
|
|
69
|
+
|
|
70
|
+
### npm ile Manuel Kurulum
|
|
71
|
+
|
|
72
|
+
Kendi barındırdığınız n8n ortamında:
|
|
73
|
+
|
|
74
|
+
```bash
|
|
75
|
+
npm install n8n-nodes-azuredevops-advanced
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
Docker ile çalışıyorsanız `n8n-custom-extensions` klasörüne ekleyin veya özel bir Docker image oluşturun:
|
|
79
|
+
|
|
80
|
+
```dockerfile
|
|
81
|
+
FROM n8nio/n8n
|
|
82
|
+
RUN cd /usr/local/lib/node_modules/n8n && npm install n8n-nodes-azuredevops-advanced
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
---
|
|
86
|
+
|
|
87
|
+
## Kimlik Bilgileri Yapılandırması
|
|
88
|
+
|
|
89
|
+
### Azure DevOps Personal Access Token (PAT) Oluşturma
|
|
90
|
+
|
|
91
|
+
1. [dev.azure.com](https://dev.azure.com) adresine gidin ve oturum açın
|
|
92
|
+
2. Sağ üst köşede kullanıcı ikonuna tıklayın → **Personal access tokens**
|
|
93
|
+
3. **New Token** butonuna tıklayın
|
|
94
|
+
4. Token için bir isim verin (örn. `n8n-integration`)
|
|
95
|
+
5. **Expiration** tarihini belirleyin
|
|
96
|
+
6. **Scopes** bölümünde ihtiyaçlarınıza göre izinleri seçin:
|
|
97
|
+
|
|
98
|
+
| Kapsam | İzin | Kullanılan Özellik |
|
|
99
|
+
|--------|------|-------------------|
|
|
100
|
+
| Code | Read & Write | Git, Pull Requests |
|
|
101
|
+
| Build | Read & Execute | Pipeline |
|
|
102
|
+
| Work Items | Read & Write | Work Items, Boards |
|
|
103
|
+
| Test Management | Read & Write | Test Plans |
|
|
104
|
+
| Wiki | Read & Write | Wiki |
|
|
105
|
+
| Service Hooks | Read, Write & Manage | Service Hooks |
|
|
106
|
+
| Packaging | Read | Artifacts |
|
|
107
|
+
|
|
108
|
+
7. **Create** butonuna tıklayın ve token'ı kopyalayın (bir daha gösterilmez!)
|
|
109
|
+
|
|
110
|
+
### n8n'de Credential Oluşturma
|
|
111
|
+
|
|
112
|
+
1. n8n'de **Credentials → Add Credential** sayfasına gidin
|
|
113
|
+
2. **Azure DevOps Advanced API** seçin
|
|
114
|
+
3. Aşağıdaki bilgileri girin:
|
|
115
|
+
|
|
116
|
+
| Alan | Açıklama | Örnek |
|
|
117
|
+
|------|----------|-------|
|
|
118
|
+
| Organization | Azure DevOps organizasyon adı | `mycompany` |
|
|
119
|
+
| Personal Access Token | Yukarıda oluşturulan PAT | `xxxxxxxxxxxxxxxxxxxx` |
|
|
120
|
+
|
|
121
|
+
4. **Save** butonuna tıklayın
|
|
122
|
+
|
|
123
|
+
> **Not:** Organization adını `dev.azure.com/{organization}` URL'sinden bulabilirsiniz.
|
|
124
|
+
|
|
125
|
+
---
|
|
126
|
+
|
|
127
|
+
## Kaynaklar ve Operasyonlar
|
|
128
|
+
|
|
129
|
+
### 1. Git Repositories
|
|
130
|
+
|
|
131
|
+
Azure DevOps Git depolarını yönetin.
|
|
132
|
+
|
|
133
|
+
#### Operasyonlar
|
|
134
|
+
|
|
135
|
+
| Operasyon | Açıklama | Zorunlu Parametreler |
|
|
136
|
+
|-----------|----------|---------------------|
|
|
137
|
+
| **List Repositories** | Projedeki tüm Git repolarını listele | Project |
|
|
138
|
+
| **Get File Content** | Belirtilen dosyanın içeriğini al | Project, Repository ID, File Path |
|
|
139
|
+
| **Create Branch** | Yeni bir branch oluştur (main'den) | Project, Repository ID, Branch Name |
|
|
140
|
+
| **Push Commit** | Dosya değişikliği commit et | Project, Repository ID, Branch Name, Commit Message |
|
|
141
|
+
|
|
142
|
+
#### Örnek: Dosya İçeriği Alma
|
|
143
|
+
|
|
144
|
+
```
|
|
145
|
+
Resource: Git Repositories
|
|
146
|
+
Operation: Get File Content
|
|
147
|
+
Project: MyProject
|
|
148
|
+
Repository ID: my-repo
|
|
149
|
+
File Path: /src/app.ts
|
|
150
|
+
```
|
|
151
|
+
|
|
152
|
+
#### Örnek: Branch Oluşturma
|
|
153
|
+
|
|
154
|
+
```
|
|
155
|
+
Resource: Git Repositories
|
|
156
|
+
Operation: Create Branch
|
|
157
|
+
Project: MyProject
|
|
158
|
+
Repository ID: my-repo
|
|
159
|
+
Branch Name: refs/heads/feature/new-feature
|
|
160
|
+
```
|
|
161
|
+
|
|
162
|
+
---
|
|
163
|
+
|
|
164
|
+
### 2. Pipeline (CI/CD)
|
|
165
|
+
|
|
166
|
+
Azure DevOps build ve release pipeline'larını otomatikleştirin.
|
|
167
|
+
|
|
168
|
+
#### Operasyonlar
|
|
169
|
+
|
|
170
|
+
| Operasyon | Açıklama | Zorunlu Parametreler |
|
|
171
|
+
|-----------|----------|---------------------|
|
|
172
|
+
| **List Pipelines** | Tüm pipeline'ları listele | Project |
|
|
173
|
+
| **Run Pipeline** | Pipeline'ı başlat | Project, Pipeline ID |
|
|
174
|
+
| **Get Build Logs** | Belirli bir run'ın loglarını al | Project, Pipeline ID, Run ID |
|
|
175
|
+
| **Cancel Run** | Çalışan pipeline'ı iptal et | Project, Pipeline ID, Run ID |
|
|
176
|
+
|
|
177
|
+
#### Örnek: Pipeline Tetikleme
|
|
178
|
+
|
|
179
|
+
```
|
|
180
|
+
Resource: Pipeline
|
|
181
|
+
Operation: Run Pipeline
|
|
182
|
+
Project: MyProject
|
|
183
|
+
Pipeline ID: 42
|
|
184
|
+
```
|
|
185
|
+
|
|
186
|
+
#### Örnek: Build Loglarını Alma
|
|
187
|
+
|
|
188
|
+
```
|
|
189
|
+
Resource: Pipeline
|
|
190
|
+
Operation: Get Build Logs
|
|
191
|
+
Project: MyProject
|
|
192
|
+
Pipeline ID: 42
|
|
193
|
+
Run ID: 1234
|
|
194
|
+
```
|
|
195
|
+
|
|
196
|
+
---
|
|
197
|
+
|
|
198
|
+
### 3. Work Items
|
|
199
|
+
|
|
200
|
+
Azure DevOps iş öğelerini (Task, Bug, Epic, Feature, User Story) yönetin.
|
|
201
|
+
|
|
202
|
+
#### Operasyonlar
|
|
203
|
+
|
|
204
|
+
| Operasyon | Açıklama | Zorunlu Parametreler |
|
|
205
|
+
|-----------|----------|---------------------|
|
|
206
|
+
| **Get Work Item** | Tek bir iş öğesini getir | Project, Work Item ID |
|
|
207
|
+
| **List All Work Items** | WIQL sorgusuyla tüm iş öğelerini listele | Project |
|
|
208
|
+
| **Create Work Item** | Yeni iş öğesi oluştur | Project, Work Item Type, Title |
|
|
209
|
+
| **Update Work Item** | Mevcut iş öğesini güncelle | Project, Work Item ID |
|
|
210
|
+
| **List Users** | Organizasyon kullanıcılarını listele | - |
|
|
211
|
+
| **List Tags** | Projedeki tüm etiketleri listele | Project |
|
|
212
|
+
|
|
213
|
+
#### Desteklenen İş Öğesi Türleri
|
|
214
|
+
|
|
215
|
+
- Task
|
|
216
|
+
- Bug
|
|
217
|
+
- Epic
|
|
218
|
+
- Feature
|
|
219
|
+
- User Story
|
|
220
|
+
- Issue
|
|
221
|
+
- Test Case
|
|
222
|
+
|
|
223
|
+
#### Desteklenen İş Öğesi Durumları
|
|
224
|
+
|
|
225
|
+
- New / To Do
|
|
226
|
+
- Active / Doing
|
|
227
|
+
- Resolved
|
|
228
|
+
- Closed / Done
|
|
229
|
+
- Removed
|
|
230
|
+
|
|
231
|
+
#### Ek Alanlar (Opsiyonel)
|
|
232
|
+
|
|
233
|
+
Work Item oluştururken veya güncellerken kullanılabilecek ek alanlar:
|
|
234
|
+
|
|
235
|
+
| Alan Adı | Açıklama |
|
|
236
|
+
|----------|----------|
|
|
237
|
+
| `System.Description` | İş öğesi açıklaması (HTML destekli) |
|
|
238
|
+
| `System.AssignedTo` | Atanan kullanıcı adı veya e-posta |
|
|
239
|
+
| `System.State` | Durum (New, Active, Resolved, Closed) |
|
|
240
|
+
| `Microsoft.VSTS.Common.Priority` | Öncelik (1=En Yüksek, 4=En Düşük) |
|
|
241
|
+
| `System.Tags` | Etiketler (noktalı virgülle ayrılmış) |
|
|
242
|
+
| `Custom.FieldName` | Özel alanlar |
|
|
243
|
+
|
|
244
|
+
#### Örnek: Bug Oluşturma
|
|
245
|
+
|
|
246
|
+
```
|
|
247
|
+
Resource: Work Items
|
|
248
|
+
Operation: Create Work Item
|
|
249
|
+
Project: MyProject
|
|
250
|
+
Work Item Type: Bug
|
|
251
|
+
Title: Login button not working
|
|
252
|
+
Additional Fields:
|
|
253
|
+
- System.Description: Steps to reproduce...
|
|
254
|
+
- System.AssignedTo: john.doe@company.com
|
|
255
|
+
- Microsoft.VSTS.Common.Priority: 1
|
|
256
|
+
```
|
|
257
|
+
|
|
258
|
+
---
|
|
259
|
+
|
|
260
|
+
### 4. Pull Requests
|
|
261
|
+
|
|
262
|
+
Git pull request iş akışlarını otomatikleştirin.
|
|
263
|
+
|
|
264
|
+
#### Operasyonlar
|
|
265
|
+
|
|
266
|
+
| Operasyon | Açıklama | Zorunlu Parametreler |
|
|
267
|
+
|-----------|----------|---------------------|
|
|
268
|
+
| **Get Pull Request** | Tek PR'ı getir | Project, Repository ID, PR ID |
|
|
269
|
+
| **List Pull Requests** | Filtrelenmiş PR listesi | Project, Repository ID |
|
|
270
|
+
| **Create Pull Request** | Yeni PR oluştur | Project, Repository ID, Source Branch, Target Branch, Title |
|
|
271
|
+
| **Update Pull Request** | PR'ı güncelle veya merge et | Project, Repository ID, PR ID |
|
|
272
|
+
| **Get Comments** | PR yorum thread'lerini getir | Project, Repository ID, PR ID |
|
|
273
|
+
|
|
274
|
+
#### PR Listeleme Filtreleri
|
|
275
|
+
|
|
276
|
+
| Filtre | Seçenekler |
|
|
277
|
+
|--------|-----------|
|
|
278
|
+
| Status | active, abandoned, completed, all |
|
|
279
|
+
| Source Branch | Kaynak branch adı |
|
|
280
|
+
| Target Branch | Hedef branch adı |
|
|
281
|
+
| Limit | Maksimum sonuç sayısı |
|
|
282
|
+
|
|
283
|
+
#### Merge Stratejileri
|
|
284
|
+
|
|
285
|
+
PR güncellerken kullanılabilecek merge stratejileri:
|
|
286
|
+
|
|
287
|
+
| Strateji | Açıklama |
|
|
288
|
+
|----------|----------|
|
|
289
|
+
| `noFastForward` | Merge commit oluştur |
|
|
290
|
+
| `rebase` | Rebasing ile merge et |
|
|
291
|
+
| `rebaseMerge` | Rebase ve merge commit |
|
|
292
|
+
| `squash` | Tüm commitleri tek commit'e sıkıştır |
|
|
293
|
+
|
|
294
|
+
#### Örnek: PR Oluşturma
|
|
295
|
+
|
|
296
|
+
```
|
|
297
|
+
Resource: Pull Requests
|
|
298
|
+
Operation: Create Pull Request
|
|
299
|
+
Project: MyProject
|
|
300
|
+
Repository ID: my-repo
|
|
301
|
+
Source Branch: refs/heads/feature/new-feature
|
|
302
|
+
Target Branch: refs/heads/main
|
|
303
|
+
Title: Add new authentication feature
|
|
304
|
+
Additional Fields:
|
|
305
|
+
- Description: This PR adds OAuth2 support
|
|
306
|
+
- isDraft: false
|
|
307
|
+
- Reviewers: user-id-1,user-id-2
|
|
308
|
+
```
|
|
309
|
+
|
|
310
|
+
---
|
|
311
|
+
|
|
312
|
+
### 5. Test Plans
|
|
313
|
+
|
|
314
|
+
Azure DevOps test yönetimini otomatikleştirin.
|
|
315
|
+
|
|
316
|
+
#### Operasyonlar
|
|
317
|
+
|
|
318
|
+
| Operasyon | Açıklama | Zorunlu Parametreler |
|
|
319
|
+
|-----------|----------|---------------------|
|
|
320
|
+
| **List Test Plans** | Tüm test planlarını listele | Project |
|
|
321
|
+
| **List Test Suites** | Bir plan içindeki suite'leri listele | Project, Plan ID |
|
|
322
|
+
| **List Test Cases** | Bir suite içindeki test case'leri listele | Project, Plan ID, Suite ID |
|
|
323
|
+
| **List Test Runs** | Tüm test run'larını listele | Project |
|
|
324
|
+
|
|
325
|
+
#### Örnek: Test Case Listeleme
|
|
326
|
+
|
|
327
|
+
```
|
|
328
|
+
Resource: Test Plans
|
|
329
|
+
Operation: List Test Cases
|
|
330
|
+
Project: MyProject
|
|
331
|
+
Plan ID: 10
|
|
332
|
+
Suite ID: 25
|
|
333
|
+
```
|
|
334
|
+
|
|
335
|
+
---
|
|
336
|
+
|
|
337
|
+
### 6. Boards
|
|
338
|
+
|
|
339
|
+
Agile board ve sprint yönetimi.
|
|
340
|
+
|
|
341
|
+
#### Operasyonlar
|
|
342
|
+
|
|
343
|
+
| Operasyon | Açıklama | Zorunlu Parametreler |
|
|
344
|
+
|-----------|----------|---------------------|
|
|
345
|
+
| **List Boards** | Takım board'larını listele | Project, Team |
|
|
346
|
+
| **List Board Columns** | Board kolonlarını listele | Project, Team, Board ID |
|
|
347
|
+
| **List Iterations** | Sprint/iterasyon listesini al | Project, Team |
|
|
348
|
+
|
|
349
|
+
#### Örnek: Sprint Listesi Alma
|
|
350
|
+
|
|
351
|
+
```
|
|
352
|
+
Resource: Boards
|
|
353
|
+
Operation: List Iterations
|
|
354
|
+
Project: MyProject
|
|
355
|
+
Team: MyProject Team
|
|
356
|
+
```
|
|
357
|
+
|
|
358
|
+
#### Yaygın Board ID'leri
|
|
359
|
+
|
|
360
|
+
- `Epics`
|
|
361
|
+
- `Features`
|
|
362
|
+
- `Stories`
|
|
363
|
+
- `Backlog items`
|
|
364
|
+
|
|
365
|
+
---
|
|
366
|
+
|
|
367
|
+
### 7. Wiki
|
|
368
|
+
|
|
369
|
+
Azure DevOps wiki sayfalarını yönetin.
|
|
370
|
+
|
|
371
|
+
#### Operasyonlar
|
|
372
|
+
|
|
373
|
+
| Operasyon | Açıklama | Zorunlu Parametreler |
|
|
374
|
+
|-----------|----------|---------------------|
|
|
375
|
+
| **List Wikis** | Projedeki tüm wiki'leri listele | Project |
|
|
376
|
+
| **Get Page** | Wiki sayfasını getir | Project, Wiki Identifier, Page Path |
|
|
377
|
+
| **Create Page** | Yeni wiki sayfası oluştur | Project, Wiki Identifier, Page Path, Content |
|
|
378
|
+
| **Update Page** | Mevcut wiki sayfasını güncelle | Project, Wiki Identifier, Page Path, Content |
|
|
379
|
+
|
|
380
|
+
#### Örnek: Wiki Sayfası Oluşturma
|
|
381
|
+
|
|
382
|
+
```
|
|
383
|
+
Resource: Wiki
|
|
384
|
+
Operation: Create Page
|
|
385
|
+
Project: MyProject
|
|
386
|
+
Wiki Identifier: MyProject.wiki
|
|
387
|
+
Page Path: /Documentation/API-Guide
|
|
388
|
+
Content: # API Guide\n\nBu sayfa API rehberini içerir...
|
|
389
|
+
```
|
|
390
|
+
|
|
391
|
+
> **Not:** Content alanı Markdown formatını destekler.
|
|
392
|
+
|
|
393
|
+
---
|
|
394
|
+
|
|
395
|
+
### 8. Service Hooks
|
|
396
|
+
|
|
397
|
+
Azure DevOps event'leri için webhook abonelikleri yönetin.
|
|
398
|
+
|
|
399
|
+
#### Operasyonlar
|
|
400
|
+
|
|
401
|
+
| Operasyon | Açıklama | Zorunlu Parametreler |
|
|
402
|
+
|-----------|----------|---------------------|
|
|
403
|
+
| **List Subscriptions** | Tüm webhook aboneliklerini listele | - |
|
|
404
|
+
| **Create Subscription** | Yeni webhook aboneliği oluştur | Project, Event Type, Consumer URL |
|
|
405
|
+
|
|
406
|
+
#### Desteklenen Event Türleri
|
|
407
|
+
|
|
408
|
+
| Event Türü | Açıklama |
|
|
409
|
+
|-----------|----------|
|
|
410
|
+
| `build.complete` | Build tamamlandı |
|
|
411
|
+
| `git.push` | Kod push edildi |
|
|
412
|
+
| `git.pullrequest.created` | Pull Request oluşturuldu |
|
|
413
|
+
| `git.pullrequest.merged` | Pull Request merge edildi |
|
|
414
|
+
| `workitem.created` | İş öğesi oluşturuldu |
|
|
415
|
+
| `workitem.updated` | İş öğesi güncellendi |
|
|
416
|
+
| `ms.vss-release.release-created-event` | Release oluşturuldu |
|
|
417
|
+
|
|
418
|
+
#### Örnek: Webhook Aboneliği Oluşturma
|
|
419
|
+
|
|
420
|
+
```
|
|
421
|
+
Resource: Service Hooks
|
|
422
|
+
Operation: Create Subscription
|
|
423
|
+
Project: MyProject
|
|
424
|
+
Event Type: git.push
|
|
425
|
+
Consumer URL: https://your-n8n-instance.com/webhook/xyz
|
|
426
|
+
```
|
|
427
|
+
|
|
428
|
+
> **İpucu:** Consumer URL olarak n8n Webhook node'unun URL'sini kullanarak Azure DevOps event'lerini n8n workflow'larına bağlayabilirsiniz.
|
|
429
|
+
|
|
430
|
+
---
|
|
431
|
+
|
|
432
|
+
### 9. TFVC
|
|
433
|
+
|
|
434
|
+
Team Foundation Version Control (eski versiyon kontrol sistemi) desteği.
|
|
435
|
+
|
|
436
|
+
#### Operasyonlar
|
|
437
|
+
|
|
438
|
+
| Operasyon | Açıklama | Zorunlu Parametreler |
|
|
439
|
+
|-----------|----------|---------------------|
|
|
440
|
+
| **List Branches** | TFVC branch ve klasörlerini listele | Project |
|
|
441
|
+
| **Get File Content** | TFVC'den dosya içeriği al | Project, File Path |
|
|
442
|
+
|
|
443
|
+
#### Örnek: TFVC Dosyası Okuma
|
|
444
|
+
|
|
445
|
+
```
|
|
446
|
+
Resource: TFVC
|
|
447
|
+
Operation: Get File Content
|
|
448
|
+
Project: MyProject
|
|
449
|
+
File Path: $/MyProject/src/main.cs
|
|
450
|
+
```
|
|
451
|
+
|
|
452
|
+
> **Not:** TFVC yolları `$/` ile başlar.
|
|
453
|
+
|
|
454
|
+
---
|
|
455
|
+
|
|
456
|
+
### 10. Artifacts
|
|
457
|
+
|
|
458
|
+
Azure Artifacts paket feed yönetimi.
|
|
459
|
+
|
|
460
|
+
#### Operasyonlar
|
|
461
|
+
|
|
462
|
+
| Operasyon | Açıklama | Zorunlu Parametreler |
|
|
463
|
+
|-----------|----------|---------------------|
|
|
464
|
+
| **List Feeds** | Tüm artifact feed'lerini listele | Project |
|
|
465
|
+
| **List Packages** | Feed içindeki paketleri listele | Project, Feed ID |
|
|
466
|
+
|
|
467
|
+
#### Örnek: Paket Listeleme
|
|
468
|
+
|
|
469
|
+
```
|
|
470
|
+
Resource: Artifacts
|
|
471
|
+
Operation: List Packages
|
|
472
|
+
Project: MyProject
|
|
473
|
+
Feed ID: my-nuget-feed
|
|
474
|
+
```
|
|
475
|
+
|
|
476
|
+
---
|
|
477
|
+
|
|
478
|
+
## Kullanım Örnekleri
|
|
479
|
+
|
|
480
|
+
### Örnek 1: Otomatik PR Oluşturma Workflow'u
|
|
481
|
+
|
|
482
|
+
Bu workflow, bir GitHub event'inde Azure DevOps'ta otomatik PR oluşturur:
|
|
483
|
+
|
|
484
|
+
1. **Webhook Trigger** → GitHub push event alır
|
|
485
|
+
2. **Azure DevOps Advanced** (Git: Create Branch) → Yeni branch oluşturur
|
|
486
|
+
3. **Azure DevOps Advanced** (Pull Requests: Create) → PR açar
|
|
487
|
+
4. **Slack** → Ekibe bildirim gönderir
|
|
488
|
+
|
|
489
|
+
### Örnek 2: Work Item Otomasyonu
|
|
490
|
+
|
|
491
|
+
Jira'dan Azure DevOps'a iş öğesi senkronizasyonu:
|
|
492
|
+
|
|
493
|
+
1. **Schedule Trigger** → Her saat çalışır
|
|
494
|
+
2. **Jira** → Yeni issue'ları listeler
|
|
495
|
+
3. **IF** → Azure DevOps'ta mevcut değilse filtreler
|
|
496
|
+
4. **Azure DevOps Advanced** (Work Items: Create) → Task oluşturur
|
|
497
|
+
5. **Jira** → Issue'yu günceller
|
|
498
|
+
|
|
499
|
+
### Örnek 3: Build Monitoring
|
|
500
|
+
|
|
501
|
+
Pipeline başarısız olduğunda uyarı gönderme:
|
|
502
|
+
|
|
503
|
+
1. **Azure DevOps Advanced** (Service Hooks: Create Subscription) → Build event'e abone olur
|
|
504
|
+
2. **Webhook** → Build complete event alır
|
|
505
|
+
3. **IF** → Build başarısız mı kontrol eder
|
|
506
|
+
4. **Azure DevOps Advanced** (Pipeline: Get Build Logs) → Hata loglarını alır
|
|
507
|
+
5. **Email / Slack** → Detaylı hata bildirimi gönderir
|
|
508
|
+
|
|
509
|
+
---
|
|
510
|
+
|
|
511
|
+
## Gereksinimler
|
|
512
|
+
|
|
513
|
+
- **n8n** >= 1.0.0
|
|
514
|
+
- **Node.js** >= 18.x
|
|
515
|
+
- Azure DevOps hesabı ve organizasyon
|
|
516
|
+
- Yeterli izinlere sahip Personal Access Token (PAT)
|
|
517
|
+
|
|
518
|
+
---
|
|
519
|
+
|
|
520
|
+
## Geliştirme
|
|
521
|
+
|
|
522
|
+
Projeyi yerel ortamda çalıştırmak için:
|
|
523
|
+
|
|
524
|
+
```bash
|
|
525
|
+
# Repoyu klonlayın
|
|
526
|
+
git clone https://github.com/ertekinozturgut/n8n-nodes-azuredevops-advanced.git
|
|
527
|
+
cd n8n-nodes-azuredevops-advanced
|
|
528
|
+
|
|
529
|
+
# Bağımlılıkları yükleyin
|
|
530
|
+
npm install
|
|
531
|
+
|
|
532
|
+
# TypeScript derleme (watch mode)
|
|
533
|
+
npm run dev
|
|
534
|
+
|
|
535
|
+
# Üretim derlemesi
|
|
536
|
+
npm run build
|
|
537
|
+
```
|
|
538
|
+
|
|
539
|
+
### Proje Yapısı
|
|
540
|
+
|
|
541
|
+
```
|
|
542
|
+
n8n-nodes-azuredevops-advanced/
|
|
543
|
+
├── nodes/
|
|
544
|
+
│ └── AzureDevOpsAdvanced/
|
|
545
|
+
│ ├── AzureDevOpsAdvanced.node.ts # Ana node implementasyonu
|
|
546
|
+
│ ├── GenericFunctions.ts # API istek yardımcısı
|
|
547
|
+
│ ├── azureDevOps.svg # Node ikonu
|
|
548
|
+
│ └── descriptions/
|
|
549
|
+
│ ├── GitDescription.ts
|
|
550
|
+
│ ├── PipelineDescription.ts
|
|
551
|
+
│ ├── WorkItemDescription.ts
|
|
552
|
+
│ ├── PullRequestDescription.ts
|
|
553
|
+
│ ├── TestPlanDescription.ts
|
|
554
|
+
│ ├── BoardDescription.ts
|
|
555
|
+
│ ├── WikiDescription.ts
|
|
556
|
+
│ ├── ServiceHookDescription.ts
|
|
557
|
+
│ ├── TfvcDescription.ts
|
|
558
|
+
│ └── ArtifactsDescription.ts
|
|
559
|
+
├── credentials/
|
|
560
|
+
│ └── AzureDevOpsAdvancedApi.credentials.ts
|
|
561
|
+
├── dist/ # Derlenmiş JavaScript
|
|
562
|
+
├── package.json
|
|
563
|
+
└── tsconfig.json
|
|
564
|
+
```
|
|
565
|
+
|
|
566
|
+
---
|
|
567
|
+
|
|
568
|
+
## Katkıda Bulunma
|
|
569
|
+
|
|
570
|
+
Katkılarınızı bekliyoruz! Lütfen şu adımları takip edin:
|
|
571
|
+
|
|
572
|
+
1. Repoyu fork edin
|
|
573
|
+
2. Feature branch oluşturun (`git checkout -b feature/amazing-feature`)
|
|
574
|
+
3. Değişikliklerinizi commit edin (`git commit -m 'Add amazing feature'`)
|
|
575
|
+
4. Branch'i push edin (`git push origin feature/amazing-feature`)
|
|
576
|
+
5. Pull Request açın
|
|
577
|
+
|
|
578
|
+
### Bug Bildirimi
|
|
579
|
+
|
|
580
|
+
[GitHub Issues](https://github.com/ertekinozturgut/n8n-nodes-azuredevops-advanced/issues) sayfasından bug bildirebilir veya özellik talebinde bulunabilirsiniz.
|
|
581
|
+
|
|
582
|
+
---
|
|
583
|
+
|
|
584
|
+
## Lisans
|
|
585
|
+
|
|
586
|
+
Bu proje [MIT License](LICENSE) altında lisanslanmıştır.
|
|
587
|
+
|
|
588
|
+
---
|
|
589
|
+
|
|
590
|
+
## Bağlantılar
|
|
591
|
+
|
|
592
|
+
- [npm Paketi](https://www.npmjs.com/package/n8n-nodes-azuredevops-advanced)
|
|
593
|
+
- [GitHub Reposu](https://github.com/ertekinozturgut/n8n-nodes-azuredevops-advanced)
|
|
594
|
+
- [Azure DevOps REST API Dokümantasyonu](https://docs.microsoft.com/en-us/rest/api/azure/devops/)
|
|
595
|
+
- [n8n Community Nodes Rehberi](https://docs.n8n.io/integrations/community-nodes/)
|
package/package.json
CHANGED