GitHub Actions - Java-Projekte bauen und testen

in  Builds & Tests , , ,

GitHub Actions - Java-Projekte bauen und testen

Nachdem im letzten Artikel gezeigt wurde, mit welchen Mitteln sich in GitHub Actions Projekte auf Basis von PHP verarbeiten lassen, schauen wir nun auch einmal kurz in die Java-Welt.

Werkzeuge für das Build-Management

In Java ist es gang und gebe, die Builds mit spezifischen Tools zu beschreiben, hier sind als gängigste Beispiele Maven, Gradle oder auch Ant zu nennen. Das ist insoweit hilfreich, als dass viele Abhängigkeiten darüber verwaltet werden.

Das allgemeine Vorgehen für Java-Projekte sieht daher wie folgt aus:

  1. Sources aus Git auschecken.
  2. Das benötigte JDK verfügbar machen.
  3. Maven, Gradle, etc. starten.

Java einrichten

Die wichtigste Action zum Start ist setup-java. Hiermit lässt sich die gewünsche Java-Version problemlos bereitstellen. Auch Matrix-Builds für unterschiedliche Java-Versionen werden unterstützt.

Build starten

Sobald Java eingerichtet worden ist, können die gewünschten Tools direkt mit den dazugehörigen Befehlen gestartet werden, indem z. B. mvn oder gradle verwendet wird.

Abweichende Versionen nutzen

Per Standard werden immer die Werkzeuge verwendet, die auf dem verwendeten Runner installiert sind. Die Versionen können jederzeit in der Doku nachgeschlagen werden.

Meine Workflows laufen in der Regel auf dem neuen Ubuntu (runs-on: ubuntu-latest). Dort kommen gegenwärtig Gradle 6.3 und Maven in der Version 3.6.3 zum Einsatz.

In manchen Fällen kann es jedoch vorkommen, dass man explizit eine bestimmte Version nutzen möchte. Dann kann man sich damit behelfen, diese Version einfach händisch in einem vorgelagerten Workflow-Schritt bereitzustellen:

1
2
3
4
5
- name: Download specific Maven
    run: |
    wget -q https://archive.apache.org/dist/maven/maven-3/3.6.1/binaries/apache-maven-3.6.1-bin.tar.gz
    tar xzf apache-maven-3.6.1-bin.tar.gz && rm apache-maven-3.6.1-bin.tar.gz
    mv apache-maven-3.6.1 maven    

Das Tool wird dann natürlich nicht mit mvn, sondern durch maven/bin/mvn angesprochen.

Ausführlicheres Lesematerial

Mittlerweile gibt es in der Dokumentation für GitHub Actions einen eigenen Bereich, in dem gezeigt wird, wie sich Workflows für Java-Projekte aufbauen lassen. Es lohnt sich, zum Einstieg einen Blick darauf zu werfen.

Ausblick

Im nächsten Artikel gehen wir weg von den allgemeinen Punkten und kommen dafür mehr auf spezifische Aspekte zu sprechen, mit denen man unweigerlich konfrontiert werden wird, sobald man komplexere Build-Systeme mit GitHub Actions realisiert und beispielsweise mehrere Projekte miteinander verketten möchte.

Weitere Beiträge in Kategorie Builds & Tests

GitHub integriert Code Security Scanner
- Im offiziellen GitHub Changelog werden regelmäßig Beiträge über unterschiedliche Neuerungen und Innovationen auf der GitHub Plattform veröffentlicht, zum Beispiel in Bezug auf Funktionen in der …
GitHub Actions - Eine Aktion zum Bauen und Testen von Zikula-Modulen
- Vor ein paar Wochen haben wir unsere generator-action vorgestellt, welche die einfache Generierung von Zikula-Erweiterungen mit dem Standalone Generator von ModuleStudio erlaubt. Diese Action wird als …
GitHub Actions - Eine Aktion zum Generieren von Zikula-Modulen
- Der Standalone-Generator ModuleStudio bietet einen Standalone-Generator, mit dem sich jederzeit eine Anwendung über die Kommandozeile generieren lässt. Einige allgemeine Informationen hierzu sind der …
GitHub Actions - Programmatische Trigger, Build Pipelines, Dashboard
- In diesem Beitrag geht es darum, mehrere und unterschiedliche Build Jobs miteinander zu verknüpfen. Je größer eine Build Infrastruktur wird, desto häufiger wird man mit solchen Anforderungen …
GitHub Actions - PHP-Projekte bauen und testen
- Eine Aktion zur PHP-Einrichtung Für die wichtigsten Punkte, die notwendig sind, um ein auf PHP basierendes Projekt zu testen, gibt es die Action setup-php. Diese bietet unter anderem folgende …