© Boyko.Pictures/Shutterstock.com
Mit einfachen Mitteln eine Web-App samt API und Docker-Container aufsetzen

Am Ende landet alles im Container


Ob nun für einen Prototyp, für den Start eines neuen Green-Field-Projekts oder einfach nur, um dem Kunden die Möglichkeiten einer Funktion aufzuzeigen – eine Web-App samt API und einer Containerumgebung hochziehen zu können, sollte in jedem Team zum Grundwissen gehören. In den folgenden Abschnitten erfahren Sie, wie man förmlich in Minuten eine App aus dem Boden stampft.

Die Zeiten von reinen Backend-Entwicklern sind vorbei. Das soll nicht heißen, dass wir uns nur noch oberflächlich Fachwissen aneignen. Es bleibt weiter dabei, dass der Eine mehr ein Faible für das Frontend und der Andere für reinen Backend-Code hat. Doch wir sollten wissen, wie die anderen Teile funktionieren und im Team alle Aufgaben lösen können, die eine Applikation an uns stellt.

Darum will ich Ihnen hier einen kompletten Durchstich vom Frontend über das Backend bis hin zu der Idee einer Containerumgebung aufzeigen. Eine solche Web-App wird unweigerlich deutlich mehr Frontend-Anteile beinhalten, weil wir in diesem Bereich mehr Geschwindigkeit und Freiraum in die Entwicklung der eigentlichen Funktion bekommen. Komplexere Features, wie zum Beispiel die Bestellstrecke in einem Shop, die Führung durch einen Workflow, wie wir ihn früher in Formularketten kannten, oder einfach nur der Ersatz einer Administrationsoberfläche, können durch eine Single-Page-Applikation deutlich einfacher umgesetzt werden. Selten ist die Aufgabe so geradlinig, dass man sie in einfachen, in Request-Response-basierten Anwendungen umsetzen kann. Administrationsoberflächen fallen immer wieder in einen CRUD-Ansatz zurück, der in den seltensten Fällen das gewünschte Verhalten widerspiegelt. Ich würde sogar so weit gehen, dass ich eine kleine Singular-App einem Wireframe vorziehe, wenn es darum geht, einen Prozess zu skizzieren, denn Code lässt sich einfacher schreiben als das umständliche Klicken durch eine Anwendung.

Die App

Viele Tutorials fangen mit einer Art To-do-App an. Dieser langen Liste möchte ich mich ungern anschließen. Damit Sie als Leser direkt sinnvolle Beispiele vor sich haben, möchte ich kurz Emma [1] vorstellen. Hierbei geht es um den Rewrite der Emma [2]. Bei der App handelt es sich um Unterstützung für die ehrenamtlichen Helfer der Tafel in Duisburg, die vielen Sprachen und Kulturen gegenüberstehen. Natürlich könnte man hier in Echtzeit Phrasen und Textblöcke aufnehmen und übersetzen lassen, doch hier soll es um eine einfache Lösung gehen. Darum haben mein Kollege Roland Golla und ich die ursprüngliche App-Idee wieder aufgegriffen und mit aktuellen Techniken versehen.

Um solch ein Unterfangen schnell auf die Beine stellen zu können, greife ich immer auf ein Framework zurück. Auch wenn solche Entscheidungen meist kontrovers diskutiert werden, sollte man sich hier immer zunächst auf den Use Case konzentrieren. Ein zweiter Punkt ist das Know-how im Team. Wenn hier schon Grundwissen vorhanden ist, kann das zur Beschleunigung der Prozesse beitragen. Ich entscheide mich bei vollständigen Applikationen immer wieder für Angular, das inzwischen in der Version 6 zur Verfügung steht. Für ein Projekt dieser Art beginne ich mit folgender Ordnerstruktur:

├── my-app
│   ├── src
│   │ ├── backend
│   │ └── frontend
│   └── docker-compose.yml

Da die meisten Tools, die wir hier verwenden, die Ordner selbständig anlegen, reicht es, den Ordner für src/ anzulegen. Tools? Ja genau, wir werden im Folgenden einige CLI-Anwendungen kennenlernen, die uns die Arbeit erleichtern. Alles, was wir dazu am Anfang benötigen, ist ein Node.js samt npm und PHP. Am Ende kann uns das auch der Container liefern, sodass wir lokal nur Docker brauchen.

Das erste Tool wird ng sein. Bei ng handelt es sich um einen CLI-Helper für Angular-Applikationen. Man bekommt diesen über npm:

npm install -g @angular/cli

Da man diesen global installieren muss – zumindest um meinen Codebeispielen zu folgen – kann es vorkommen, dass man dafür Root-Rechte benötigt. Mit dem CLI-Tool ausgestattet, befinden wir uns nun in unserem Projektordner und führen aus:

cd src/
ng new frontend

Damit wird im Ordner src/frontend/ die Angular App komplett lauffähig zusammengebaut. Um einen Überblick darüber zu erlangen, hilft ein Blick auf die Ordnerstruktur:

├── frontend
│   ├── e2e
│   ├── node_modules
│   ├── src
│   ├── angular.json
│   ├── karma.conf.js
│   ├── package.json
│   ├── protractor.conf.js
│   ├── README.md
│   ├── tsconfig.json
│   ├── tslint.json

Das mag auf den ersten Blick etwas umfangreich wirken. Die „Installation“ einer Angular Applikation mithilfe der CLI bringt einige Tools mit, die uns beim Entwickeln behilflich sind. Ein geübtes JS-Auge erkennt hier sofort Karma als Runner für Unittests, die hier in Jasmine geschrieben werden. Weiterhin finden wir die Konfigurationsdateien für das TypeScript und dessen Linting. Für die sogenannten End-to-end-Tests wird hier auf Protractor zurückgegriffen. Natürlich liegt im Root-Verzeichnis auch die package.json, wo wir die definierten Abhängigkeiten vorfinden. Doch zuallererst werfen wir einen Blick auf die vordefinierten Skripte, die in der package.json zu finden sind:

"scripts": {
  "ng": "ng",
  "start": "ng serve",
  "build": "ng build --prod",
  "test": "ng test",
  "lint": "ng lint",
  "e2e": "ng e2e"
}

Was wir hier sehen, soll uns für den Anfang den Start erleichtern. Der Entwickler braucht sich nämlich um das Tooling nicht zu kümmern, sondern muss nur wissen, welches Kommando er aufruft:

  • npn test – startet die Unittests mit einem Watcher

  • npm run build – baut die Applikation unter prod-Umgebung in den Ordner dist/

  • npm run start – liefert die Applikation zum Entwickeln (hier würde ich noch ein -o anhängen – damit öffnet die App gleich im Browser) mit einem Watcher aus

  • npm run lint – startet den Linter – diesen sollte man eigentlich gleich in seine IDE integrieren

  • npm run e2e – startet die End-to-end-Tests mit Watcher

Einige Funktionen starten mit einem Watcher. Das bedeutet, wir können im Code arbeiten, während der Test oder der Build einfach wieder anläuft, sobald wir Änderungen speichern. Das gilt auch für die App, die neben meiner IDE im Browser läuft. Dieser Umstand ist sehr komfortabel, da ich schon mit einem Zwei-Monitor-Set-up einen sehr guten Überblick über meine Applikation bekomme. Dem geübten JavaScript-Entwickler...

headline from sands settings