GitHub Actions - Eine Aktion zum Bauen und Testen von Zikula-Modulen

in  Builds & Tests , , , , ,

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 Docker Image bereitgestellt und kann auch losgelöst von GitHub Actions verwendet werden.

Die zikula-action

Analog dazu steht auch eine weitere GitHub Action zur Verfügung: die zikula-action. Dieses Docker Image basiert auf der ebenfalls bereits vorgestellten phpqa-Toolbox und hat somit Zugriff auf zahlreiche Tools rund um Analyse, Tests und Qualitätssicherung.

Die Idee besteht darin, dass man die gewünschte Zikula-Version auswählt und die Liste der gewünschten Tools und Prüfungen angibt, die ausgeführt werden sollen. Es war eine bewusste Entscheidung, hier auf Einstellbarkeit im Detail zu verzichten und dafür die Dinge schnell und einfach steuern zu können (convention over configuration). Denn so lassen sich Änderungen zentral in der Action vornehmen und werden von dort aus auf alle möglichen Extensions angewendet.

Was steckt drin?

Grundsätzlich führt die zikula-action folgende Schritte aus:

  1. Ausführen von Composer zur Installation von Abhängigkeiten des entsprechenden Moduls.
  2. Herunterladen der gewünschten Zikula Core Version (entweder Releases oder Entwicklungsversionen von Git)
  3. Ausführen von Composer zur Installation von Abhängigkeiten des Cores (nur bei Entwicklungsversionen).
  4. CLI-basierte Installation von Zikula.
  5. CLI-basierte Installation des Moduls.
  6. Ausführen diverser Tools (einstellbar): Linter, Coding Style, PHPUnit, Sicherheitsprüfungen, Infos über diverse Metriken, andere Checks bzgl. Deprecations, Code Smells etc.
  7. Paketierung des Moduls inklusive erneuter Installation der Abhängigkeiten (ohne Entwicklungsswerkzeugen).

Ein Workflow als Beispiel

Damit die Installation von Zikula funktioniert, muss eine Datenbank bereitgestellt werden. Das geht zum Glück mit GitHub Actions sehr einfach. Hier ein Beispiel für einen kompletten Workflow. Am Ende wird dann das Verzeichnis mit den Release-Archiven als Artefakt hochgeladen.

Weitere Beiträge in Kategorie Builds & Tests

Abhängigkeiten automatisch aktualisieren mit Renovate
- Um Dependencies aktuell zu halten, wird bei GitHub oft und gerne der Dependabot eingesetzt. Mit Renovate existiert allerdings eine äußerst flexible Alternative, die im Folgenden kurz vorgestellt wird. …
Symfony-Projekte im Monorepo mit Nx bauen
- Mit dem Build-System Nx lassen sich beliebige Projekte in einem Monorepo auf einheitliche Weise testen und bauen. Es bedient sich verschiedener npm-Plugins, um dies für unterschiedliche Technologien …
Abhängigkeiten automatisch aktualisieren mit Dependabot
- Vor knapp eineinhalb Jahren haben wir gezeigt, wie man die Aktualisierung verwendeter Drittkomponenten mit GitHub Actions automatisieren kann. Zwischenzeitlich sind wir hierbei auf den Dependabot …
Hugo-Seiten im Netzwerk entwickeln und testen
- Hugo ist ein Generator für statische Seiten, welcher auf der Programmiersprache Go basiert. Die Inhalte werden mit Markdown verwaltet und dynamisch in HTML umgewandelt. Dies ist für die meisten …
SensioLabs Security Checker wurde eingestellt
- Zu den grundlegenden Aufgaben automatisierter Builds zählen unterschiedliche Prüfungen: so bietet es sich an, die Einhaltung der Coding-Styles zu überwachen, Qualitätsmetriken zu erheben und die …