Ви не згадуєте мову сценаріїв, яку хочете використовувати, тому я конкретно розповім про HTTP-запити до BitBucket API:
Припущення
Якщо у вас є сховище BitBucket, в якому є три коміти, перший і останній не вдаються до збірки, середина проходить:
- 4768815 ❌
- 49d7110 ✅
- 42d357f ❌
Отримайте список комітетів
Ви можете отримати список комітетів, зателефонувавши за таким методом API:
https://api.bitbucket.org/2.0/repositories/{{owner}}/{{repo_slug}}/commits
owner
: РічардСлатер
repo_slug
: greencommitproofofconcept
Відповідь виглядає приблизно так:
{
"pagelen": 30,
"values": [
{
"hash": "4768815fdc27abf4be17096e7c460f7f68f5d39b",
"repository": { ... },
"links": {
...
"statuses": {
"href": "https://api.bitbucket.org/2.0/repositories/RichardSlater/greencommitproofofconcept/commit/4768815fdc27abf4be17096e7c460f7f68f5d39b/statuses"
}
},
"author": { ... },
"parents": [ ... ],
"date": "2017-04-10T11:38:18+00:00",
"message": "README.md edited online with Bitbucket",
"type": "commit"
},
{
"hash": "49d7110b98616358d16055960a4abdf2926b890d",
...
},
{
"hash": "42d357f1df7a7d7bcf1f10a9f3a5a40d85d5b11c",
...
}
]
}
Якщо проаналізувати JSON і перетворити цикл на відповіді, ви можете отримати статуси з:
values[n].links.statuses.href
Де n
індекс, тобто 0
, 1
або 2
у наведеному вище прикладі. Якби ви будували це з нуля, це було б у наступному форматі.
Отримайте список статусів від комітету
https://api.bitbucket.org/2.0/repositories/{{owner}}/{{repo_slug}}/commit/{{sha}}/statuses"
owner
: РічардСлатер
repo_slug
: greencommitproofofconcept
sha
: 4768815fdc27abf4be17096e7c460f7f68f5d39b
Примітка. Це Hypermedia API, що означає, що URL-адреси можуть змінюватися, тому я рекомендую використовувати посилання з попередньої відповіді, а не намагатися генерувати їх з нуля.
Відповідь на вищезазначений запит HTTP буде приблизно таким:
{
"pagelen": 10,
"values": [
{
"key": "POC-01",
"name": "Build #1",
"repository": { ... },
"url": "http://devops.stackexchange.com/q/809/397",
"links": { ... },
"refname": null,
"state": "FAILED",
"created_on": "2017-04-10T13:04:28.261734+00:00",
"updated_on": "2017-04-10T13:04:28.261759+00:00",
"type": "build",
"description": "Changes by Richard Slater"
}
],
"page": 1,
"size": 1
}
З цієї відповіді можна витягнути, state
використовуючи:
values[n].state
Знову ж, де n
це status
- їх може бути багато, якби один вчинок призвів до багатьох складових.
Якщо стан будівництва, про яке ви піклуєтеся, SUCCESSFUL
то у вас є відповідь, і ви можете негайно повернути sha
зобов'язання.
Переведіть цикл на всі комітети з першої фази, якщо у вас закінчується кількість комітетів, перейдіть на next
сторінку, link
яка включена у виклик /commits
.
Повна діаграма потоку
На високому рівні потік буде виглядати приблизно так:
Не забувайте, що це API Hypermedia, тому, коли це можливо, ваш код слід переходити за посиланнями в API, а не намагатися "відгадати їх".