Nie wspominasz o języku skryptowym, którego chcesz używać, więc porozmawiam konkretnie o żądaniach HTTP do interfejsu API BitBucket:
Założenia
Jeśli masz repozytorium BitBucket, w którym znajdują się trzy zatwierdzenia, pierwszy i ostatni nie dają kompilacji, środek mija:
- 4768815 ❌
- 49d7110 ✅
- 42d357f ❌
Uzyskaj listę zatwierdzeń
Możesz uzyskać listę zatwierdzeń, wywołując następującą metodę API:
https://api.bitbucket.org/2.0/repositories/{{owner}}/{{repo_slug}}/commits
owner: RichardSlaterrepo_slug: greencommitproofofconcept
Odpowiedź wygląda następująco:
{
"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",
...
}
]
}
Jeśli przeanalizujesz JSON i zapętlisz odpowiedzi, możesz wyodrębnić statusy z:
values[n].links.statuses.href
Gdzie njest indeks, czyli 0, 1czy 2w powyższym przykładzie. Jeśli miałbyś to zbudować od zera, byłby w następującym formacie.
Pobierz listę statusów z zatwierdzenia
https://api.bitbucket.org/2.0/repositories/{{owner}}/{{repo_slug}}/commit/{{sha}}/statuses"
owner: RichardSlaterrepo_slug: greencommitproofofconceptsha: 4768815fdc27abf4be17096e7c460f7f68f5d39b
Uwaga: jest to interfejs API Hypermedia, co oznacza, że adresy URL mogą się zmieniać, dlatego zalecałbym używanie linków z poprzedniej odpowiedzi, zamiast próbować wygenerować je od zera.
Odpowiedź z powyższego żądania HTTP będzie wyglądać następująco:
{
"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
}
Z tej odpowiedzi możesz wyodrębnić za statepomocą:
values[n].state
Znowu gdzie njest status- może być ich wiele, jeśli jedno zatwierdzenie spowoduje wiele kompilacji.
Jeśli stan kompilacji, na którym ci zależy, to SUCCESSFULmasz odpowiedź i możesz natychmiast zwrócić shazatwierdzenie.
Zapętlaj wszystkie zatwierdzenia z pierwszej fazy, jeśli zabraknie zatwierdzeń, postępuj zgodnie ze nextstroną linkzawartą w wywołaniu do /commits.
Kompletny schemat przepływu
Na wysokim poziomie przepływ będzie wyglądał następująco:
Nie zapominaj, że jest to interfejs API Hypermedia, więc w miarę możliwości kod powinien podążać za linkami w interfejsie API, zamiast próbować je „odgadnąć”.
