Nachdem ich in meinem bislang jüngsten Github-Projekt meine Liebe zu Badges entdeckt habe, wollte ich versuchen, das in meinem lokalen Gitlab ebenfalls zu nutzen
In Github ist es - aus meiner Sicht - sehr einfach, schnell große Mengen an Badges zu erzeugen. Trotz der offenen Tickets wegen der mangelhaften Dokumentation des Features hat sich in der Beziehung noch nicht sehr viel getan. Daher musste ich in den sauren Apfel beißen und experimentieren. Die unten angehängten Links zu dem Thema sind nur ein kleiner Auszug aus den vielen Ressourcen, die ich auf der Suche nach einer Anleitung für Badges in Gitlab besucht habe.
Mein erster Versuch war, die in der Gitlab-Dokumentation erwähnte Möglichkeit nachzuvollziehen, ein Badge für den Pipeline-Status einzubauen. Das funktionierte tatsächlich so, wie in der Dokumentation angegeben - Bei mir sieht die URL zum Zugriff auf den Badge also so aus:
http://<gitlab-host>/%{project_path}/badges/%{default_branch}/pipeline.svg
Der nächste Schritt war es, eigene Badges zu erzeugen und sie in den Settings zu registrieren. Ich wollte zunächst mit einem statischen Badge beginnen - dynamische Inhalte sollten dann den Abschluss und die Krönung meiner Forschungen darstellen. Ich fand eine für mich ausreichende Möglichkeit der Erstellung von Badges im Projekt anybadge. Aber natürlich gibt es noch deutlich mehr Möglichkeiten - etwa die üblichen Verdächtigen shields.io.
Nachdem das geklärt war - wie erzeugt man nun im CI/CD-Prozess einen Badge, der als Project-Badge in Gitlab funktioniert? Ich habe hier mal das Beispiel abgebildet, das den in der anybadge-Dokumentation gezeigten Badge erstellt, so dass ich ihn in Gitlab als Project-Badge nutzen kann. Dazu ist folgener Job in die Pipeline aufzunehmen:
badges_before:
stage: start
script:
- mkdir -p badges
- anybadge -l pylint -v 2.22 -f badges/pylint_${CI_COMMIT_REF_NAME}.svg 2=red 4=orange 8=yellow 10=green
artifacts:
paths:
- badges/*.svg
Auf diese Weise entsteht ein Badge, der dann in den Settings wie folgt eingetragen werden kann:
http://<gitlab-host>/%{project_path}/-/jobs/artifacts/%{default_branch}/raw/badges/pylint_%{default_branch}.svg?job=badges_before
Wichtig ist hier vor allem der Name des Jobs am Ende! Nun da das geklärt ist - zum bereits angekündigten Sahnehäubchen: Dem dynamischen Erzeugen von Badges. Dies geschah wieder in zwei Schritten: Schritt eins umfasste die Extraktion von Daten aus Dateien im Repository - das sah bei mir zum Beispiel wie folgt aus:
badges_before:
stage: start
script:
- mkdir -p badges
- anybadge -m "%s" -l sQLshell -v `more de/elbosso/db/prg/version.properties |grep version.program.number|cut -d '=' -f2` -f badges/sQLshell_${CI_COMMIT_REF_NAME}.svg 2=red 4=orange 8=yellow 10=green
artifacts:
paths:
- badges/*.svg
So erhalte ich einen Badge mit der aktuellen Version der sQLshell, den ich dann meinen Project-Badges wie folgt hinzufügen kann:
http://<gitlab-host>/%{project_path}/-/jobs/artifacts/%{default_branch}/raw/badges/sQLshell_%{default_branch}.svg?job=badges_after
Im zweiten und letzten Schritt setzte ich dem Ganzen noch die Krone auf - jetzt wollte ich es wissen und wirklich die gleiche Funktionalität wie bei Github erreichen: Ich wollte über die API Informationen extrahieren und diese mittels Project-Badges visualisieren. Als Thema suchte ich mir dazu die Anzahl der offenen/geschlossenen Issues aus. Dieses Thema konnte ich leider nicht mehr in .gitlab-ci.yml umsetzen - da scheint entweder der YAML-Parser einen Bug zu haben oder ich den YAML-Parser noch nicht verstanden zu haben. Also erstellte ich ein Script, das letztlich den darzustellenden Wert ermittelt - im Beispiel open_issues.sh:
#!/bin/bash
curl -i --header "Private-Token: xxxx-xxxx-xxxxxxxxxx" "http://<gitlab-host>/api/v4/projects/1/issues?state=opened&scope=all" 2>/dev/null|grep "X-Total:"|cut -d ':' -f 2
Wichtig dabei ist hier der korrekte Wert für die Project-ID (bei mir: 1) und der eigene für das Access-Token. Dieses Skript kann ich dann wie oben gesehen in .gitlab-ci.yml verwenden um den Badge zu erzeugen:
badges_before:
stage: start
script:
- mkdir -p badges
- anybadge -m "%d" -l "open issues" -v `/bin/bash ci/open_issues.sh` -f badges/open_issues_${CI_COMMIT_REF_NAME}.svg 2=red 4=orange 8=yellow 10=green
artifacts:
paths:
- badges/*.svg
Damit erhalte ich einen Badge, den ich dann wiederum als Project-Badge deklarieren kann:
http://<gitlab-host>/%{project_path}/-/jobs/artifacts/%{default_branch}/raw/badges/open_issues_%{default_branch}.svg?job=badges_before
Project badges API
Badges
Gitlab CI using Badges for each job
Default location for CI-created custom-badges
shields.io
anybadge
Feature git lab api4badges
GitLab Continuous Integration, -Delivery/Deloyment (GitLab CI/CD)
GitLab CI/CD Variables
Add examples to badges docs
GitLab API
Concise, consistent, and legible badges in SVG and raster format https://shields.io
How do I use the 'logo' option in shields.io badges?
Show HTTP response header using curl
07.12.2019
Die in den vorhergegangenen Artikeln beschriebene Idee, Badges für Gitlab zu erzeugen mündete nun endlich in ein Github-Projekt...
21.02.2019
In einem früheren Artikel habe ich eine Möglichkeit vorgestellt, echt dynamische Badges für Gitlab zu erstellen. diese Herangehensweise hat aber einen großen Nachteil
16.02.2019
In einem früheren Artikel untersuchte ich bereits verschiedene Möglichkeiten, Badges in Gitlab zu erzeugen - allerdings stellte mich die gefundene Lösung noch nicht endgültig zufrieden - bis jetzt...
Testdatengeneratoren als Microservices mit Docker
02.11.2019
Ich habe die verschiedenen Testdatengeneratoren mittels Microservices über HTTP zugänglich gemacht, um sie unabhängig von der verwendeten Programmiersprache und/ oder Version (Java 11) verwenden zu können.
Weiterlesen...Android Basteln C und C++ Chaos Datenbanken Docker dWb+ ESP Wifi Garten Geo Git(lab|hub) Go GUI Gui Hardware Java Jupyter Komponenten Links Linux Markdown Markup Music Numerik PKI-X.509-CA Python QBrowser Rants Raspi Revisited Security Software-Test sQLshell TeleGrafana Verschiedenes Video Virtualisierung Windows Upcoming...
Nachdem es nun bereits seit einiger Zeit ein wenig stiller um meine diversen Generatoren für Testdaten geworden ist, habe ich über den Feiertag in Thüringen einen neuen begonnen.
Weiterlesen...Ich wurde über einen Post auf Mastodon auf ein Projekt aufmerksam, das mir so interessant erschien, dass ich daraus meine neueste Fingerübung machte...
Weiterlesen...Eine neue Version der sQLshell ist verfügbar!
Weiterlesen...Manche nennen es Blog, manche Web-Seite - ich schreibe hier hin und wieder über meine Erlebnisse, Rückschläge und Erleuchtungen bei meinen Hobbies.
Wer daran teilhaben und eventuell sogar davon profitieren möchte, muß damit leben, daß ich hin und wieder kleine Ausflüge in Bereiche mache, die nichts mit IT, Administration oder Softwareentwicklung zu tun haben.
Ich wünsche allen Lesern viel Spaß und hin und wieder einen kleinen AHA!-Effekt...
PS: Meine öffentlichen GitHub-Repositories findet man hier - meine öffentlichen GitLab-Repositories finden sich dagegen hier.