Andreas Bruns

Softwareentwicklung für Oldenburg und Bremen

11. November 2018
von bruno
Kommentare deaktiviert für Schnittstellen-Dokumentation mit Swagger

Schnittstellen-Dokumentation mit Swagger

Bei der Erstellung von Schnittstellen (API: Application Programming Interface) für externe Systeme stellt sich meistens die Frage, wie die Schnittstellen dokumentiert werden sollen. Für REST-Schnittstellen hat Swagger die Dokumentation maßgeblich geprägt, sodass sich mittlerweise aus der ursprünglichen Swagger-Specification die OpenAPI-Specification (Github) in der Version 3 entwickelt hat. Eine Schnittstellen-Spezifikation (z.B. YAML-Datei) lässt sich auf zwei Arten konzipieren:

  • Contract/API First: Spezifikation wird mit Werkzeug oder manuell erzeugt
  • Code First: Schnittstelle wird programmiert und daraus Spezifikation generiert

Swagger bietet eine Reihe von lokalen und cloud-basierten Werkzeugen zur Erzeugung und Bereitstellung von Schnittsstellen-Dokumentationen:

  • Swagger UI: Dokumentation und REST-Interaktion für Schnittstellen-Konsumenten
  • Swagger Editor: Schnittstellen-Dokumentation erstellen und bearbeiten
  • Swagger Codegen: Generierung von Code aus Schnittstellen-Dokumentation
  • Swagger Inspector: Online-Werkzeug zum Testen von APIs
  • SwaggerHub: Software as a Service, das die Swagger-Werkzeuge (Codegen, Editor, UI) vereinigt

Weiterlesen →

14. Juli 2018
von bruno
Kommentare deaktiviert für Neues Release von Spring Boot – jetzt upgraden auf Version 2

Neues Release von Spring Boot – jetzt upgraden auf Version 2

Vor einigen Monaten ist die 2. Version von Spring Boot erschienen. Mit Spring Boot lassen sich einfach Spring-Anwendungen entwickeln, die bereits mit den benötigten Bibliotheken für den jeweiligen Anwendungszweck ausgestattet sind.

Eine Anwendung auf Basis von Spring Boot zu erstellen, bietet einige Vorzüge:

  • einfaches ‚bootstrapen‘ einer Spring-Anwendung (Version 5) per Spring Initializr
  • Vielzahl von ‚Spring Boot Starters‘ (z.B. Security, Reactive Web, JPA, MongoDB, Hystrix)
  • große Anzahl von Guides für den produktiven Einsatz
  • Generierung einer passenden Build-Konfiguration für Gradle oder Maven
  • Unterstützung von reaktiver Webprogrammierung
  • einfache Konfiguration der Anwendung, z.B. per Property-Dateien und Environment-Variablen

Spring Boot Initializr

Spring Boot Initializr

Weiterlesen →

4. Mai 2018
von bruno
Kommentare deaktiviert für Codey Rocky der neue fahrende Coding-Begleiter

Codey Rocky der neue fahrende Coding-Begleiter

Meine letzte Crowdfunding-Unterstützung bei Kickstarter hat sich gelohnt, denn mein neuer Coding-Begleiter „Codey Rocky – Your new coding companion“ ist endlich eingetroffen. Der Codey Rocky von Makeblock ist ein Programmierroboter, der mit Lego-Bausteinen erweiterbar ist, und aus zwei Teilen besteht:

  • einer niedlichen Zentraleinheit mit LED-Display, Sensoren und Knöpfen (Codey)
  • einem fahrbaren Untersatz für Codey, der ebenfalls einige Sensoren enthält (Rocky)

Rocky, Codey und ein Bluetooth-Stick

Der Codey-Rockey bietet einen leichten Einstieg in die Programmierung, indem man mit wenigen Befehlen das Display, die Motoren und die Sensoren ansprechen kann. Sobald das Programm fertig geschrieben ist, wird es per Bluetooth auf Codey übertragen und ausgeführt. Codey steuert sein Rocky entsprechend, weicht Hindernissen aus, gibt Töne von sich, reagiert auf Tasten und stellt Zeichen auf dem Display dar.

Freie Fahrt für Codey Rocky

Weiterlesen →

16. März 2018
von bruno
Kommentare deaktiviert für Einfaches Server-Monitoring mit Datadog

Einfaches Server-Monitoring mit Datadog

Für den stabilen Betrieb einer Server-Anwendung ist ein entsprechendes Monitoring von System-Kennzahlen erforderlich (z.B. verwendeter Arbeitsspeicher, freier Festplattenplatz, Anzahl von Datenbank-Verbindungen, Netzwerkauslastung). Wenn dabei die Daten aus unterschiedlichsten Quellen zusammengeführt werden, sie gemeinsam visualisiert werden und auch eine fachliche Analyse (z.B. Page Impressions, Newsletter-Conversion, Anzahl abgeschlossener Bestellungen) stattfindet, sprechen wir bereits von APM (Application Performance Management).

Lange Zeit galt die eigene Installation von Zappix oder Nagios (mit Check_MK) als das Mittel der Wahl. Mittlerweise bietet mein Lieblings-Werkzeug GitLab Unterstützung für Monitoring und es existieren viele SAAS-Lösungen in der Cloud. Ein weit verbreiteter Internetdienst mit sehr umfangreichen Monitoring- und Alarm-Funktionen ist Datadog.

Datadog: Vorgefertigtes Überblick-Dashboard

Weiterlesen →

5. Februar 2018
von bruno
Kommentare deaktiviert für Kalender-Server im Haushalt mit Radicale

Kalender-Server im Haushalt mit Radicale

Vor drei Jahren habe ich meinen Banana Pi mit der OwnCloud ausgestattet. Da der Einplatinencomputer als OwnCloud-Server doch etwas langsam agierte, bin ich bei der Datei-Verwaltung auf ein performanteres System umgestiegen. Für die Kalenderfunktionen habe ich mit Radicale (A Free and Open-Source CalDAV and CardDAV Server) auch einen einfachen, leichtgewichtigen Ersatz gefunden.

Radicales Eigenschaften sind vollkommen ausreichend für meinen Anwendungsbereich als Familienkalender und passen hervorragend zu dem eher leistungsschwachen Banana Pi:

  • Kalender-Anbindung von Clients über CalDAV, WebDAV und HTTP
  • Adressbuch-Anbindung von Clients über CardDAV, WebDAV und HTTP
  • kaum Installation und Konfiguration notwendig
  • arbeitet mit Dateien und benötigt keine Datenbank
  • implementiert nur die wichtigsten Spezifikationen
  • Unterstütung von Authentifizierung

Weiterlesen →

8. Januar 2018
von bruno
Kommentare deaktiviert für 34C3 – Chaos Communication Congress in Leipzig

34C3 – Chaos Communication Congress in Leipzig

Zwischen Weihnachten und Neujahr fand wieder der Chaos Communication Congress statt. Mit 15000 Teilnehmern kam das CCH in Hamburg nicht mehr als Austragungsort in Frage und so wurde die Veranstaltung auf das Leipziger-Messegelände verlegt.

Viele der spannenden 34C3 – Vorträge aus Technik, Politik, Kultur und Gesellschaft sind als Stream verfügbar, wobei man einige Vortragenden aus dem Internet und Fernsehen kennt:

Weiterlesen →

29. November 2017
von bruno
Kommentare deaktiviert für Schwachstellen finden dank Dependency-Check der OWASP

Schwachstellen finden dank Dependency-Check der OWASP

Diese Woche veröffentlichte die Non-Profit-Organisation OWASP (Open Web Application Security Project) nach vier Jahren Ihre neueste Version der OWASP Top Ten. Die OWASP widmet sich der Sicherheit von Web-Anwendungen und weist mit ihren Top Ten auf die gravierendsten Sicherheitsschwachstellen in Web-Anwendungen hin. Damit stärkt sie das Sicherheitsbewusstsein von Unternehmen und Entwicklern und gibt Hilfestellung bei der Entwicklung von sicheren Web-Anwendungen.

Neben der Erstellung von Security-Dokumenten und Security-Empfehlungen entwickelt OWASP auch freie Security-Werkzeuge. Mit ihrem Flagship-Projekt OWASP Dependency Check gehen sie die Nummer Neun der Top Ten an: Nutzung von Komponenten mit bekannten Schwachstellen (Using Components with Known Vulnerabilities). Eingesetzte Bibliotheken können mit dem Werkzeug auf Sicherheitsschwachstellen geprüft werden, die bei der National Vulnerability Database (NVD) dokumentiert sind. Weiterlesen →

11. August 2017
von bruno
Kommentare deaktiviert für Open Space – Zwei Tage durchgehende Kaffepausen

Open Space – Zwei Tage durchgehende Kaffepausen

In meinem aktuellen Projekt hatte ich das Vergnügen an einem Open Space teilzunehmen, zu dem mein Kunde in Stuttgart mehr als 50 Entwickler aus ganz Deutschland für zwei Tage eingeladen hatte. Aus verschiedenen Gründen war ein Austausch zwischen allen Entwicklern nach einem Jahr Entwicklungsarbeit sinnvoll:

  • die Entwickler konnten sich persönlich kennenlernen, während sie zuvor größtenteils nur Kontakt über Kollaborationswerkzeuge hatten (z.B. Confluence, Jira, Slack)
  • entwickelte Software sollte bald in Produktion gehen und der Betrieb ist von den Entwicklern zu leisten (DevOps-Ansatz)
  • unterschiedliche Projektteams müssen teilweise ähnliche Herausforderungen meistern und konnten sich dazu direkt austauschen

Das Konzept des Open Spaces wurde in den 80er-Jahren entwickelt. Teilnehmer betonten bei einer normalen Konferenz in einem abschließenden Austausch, dass die Gespräche in den Kaffeepausen noch spannender waren als die organisierten Vorträge. Daraus ergab sich die Idee, dass sich die Teilnehmer größtenteils selber organisieren sollten, um einen möglichst großen Ideen-Austauch zu unterstützen – fast wie durchgehende Kaffeepausen 🙂 . Es haben sich Regeln und Begriffe für einen Open Space etabliert, die Teilnehmer zu Beginn der Veranstaltung kennenlernen (Gesetz der zwei Füße, Schmetterlinge, Hummeln). Weiterlesen →

14. Mai 2017
von bruno
Kommentare deaktiviert für Offenes WLAN in Harpstedt mit den Freifunkern

Offenes WLAN in Harpstedt mit den Freifunkern

Am Donnerstag fand eine interessante Veranstaltung zu dem Thema „Offenes WLAN und Freifunk“ im Harpstedter Hotel „Zur Wasserburg“ statt. Der Bremer-Freifunker Simon Stößer stellte nach Einladung von den Jusos (vertreten durch Daniel Helms) die Freifunker-Community und deren Konzepte vor. In der Kreiszeitung ist dazu ein aufschlussreicher Artikel erschienen: „Freifunk Bremen“ strebt nicht nach Profit

Auf der Webseite der Freifunker und Wikipedia erfährt man die Hintergründe und die Ziele/Visionen der Freifunker:

  • Aufklärung und Sensibilisierung zum Thema Kommunikations- und Informationsfreiheit
  • Verminderung der digitalen Spaltung
  • Ungehinderte Verbreitung von Wissen und Ressourcen
  • Menschen dazu befähigen, eigene Netze aufzubauen und zu betreiben
  • Vorhandene und neue Sozialstrukturen fördern und vernetzen

Freifunk verbindet! from Philipp Seefeldt on Vimeo.

Weiterlesen →

29. April 2017
von bruno
Kommentare deaktiviert für GitLab – AllInOne-Werkzeug für Clean Code Developer

GitLab – AllInOne-Werkzeug für Clean Code Developer

Die Initiative Clean Code Developer (CCD) möchte mit Bewusstheit und Prinzipien die Professionalität im Software-Entwicklungsprozess stärken. Die Entwicklung soll durch den Einsatz der passenden Werkzeuge unterstützt werden:

In einem vorherigen Artikel habe ich SonarQube vorgestellt, mit dem wir Code Coverage Analyse und Metriken der statischen Codeanalyse abgedeckt haben. Für die anderen Werkzeuge können wir die passende Software installieren oder entsprechende Internet-Services nutzen: Git (Datei-Versionskontrolle), Redmine oder Trello (Issue-Tracking), Travis-CI oder Jenkins (Continuous-Integration, Continuous-Delivery)

Der bei Entwicklern beliebte Internetdienst GitHub vereinigt schon viele der Werkzeuge. Das zur Zeit noch weniger bekannte GitLab bietet uns sogar noch einen größeren Funktionsumfang, der die meisten Werkzeuge des Clean Code Developers umfasst. Wer seine Projektdaten keinem Cloud-Service anvertrauen kann oder möchte, der kann sich GitLab selber installieren und behält die volle Kontrolle über seine Daten.

GitLab Projekte

GitLab Projekte

Weiterlesen →