Tutorial zu Integrationstests mit Bitbucket Pipelines
Sten Pittet
Gastautor
Erfahre, wie du Integrationstests mit Bitbucket Pipelines durchführen kannst, indem du mehrere Services in separaten Docker-Containern innerhalb der Pipeline ausführst.
Testen ist ein wichtiger Teil der Continuous Integration und der Continuous Delivery. Und bei der Anwendung des Continuous Deployments ist es die allerletzte Möglichkeit, gegen Bugs vorzugehen, bevor die Änderungen für deine Kunden veröffentlicht werden. Unit-Tests validieren einzelne Methoden und Klassen und sind ein guter Anfang, um Probleme zu vermeiden. Aber du solltest auch Integrationstests durchführen, um sicherzustellen, dass die unterschiedlichen Module deiner Anwendung (Anwendungsserver, Datenbank, Cache) korrekt miteinander interagieren. In diesem Tutorial werden wir sehen, wie du mit Bitbucket Pipelines Integrationstests durchführen kannst, indem du mehrere Dienste in separaten Docker-Containern in einer Pipeline laufen lässt.
Uhrzeit
30 Minuten
Zielpublikum
Continuous Integration und/oder Bitbucket Pipelines sind neu für dich
Voraussetzungen
- Ein Bitbucket-Konto
-
Node v4.6 oder höher zum Ausführen der Anwendung
-
Docker Community Edition v17.03 oder höher zum Ausführen von MongoDB auf Ihrem lokalen Rechner
- Ein Terminal zum Ausführen von Bash-Befehlen
-
Git zum Verwalten des Repositorys und für Push-Übermittlungen zurück an Bitbucket Cloud
Schritt 1: Lokales Ausführen der Beispielanwendung
Wir verwenden eine grundlegende Node.js‑Anwendung, die eine Meldung auf der Startseite anzeigt und Besuche in einer Datenbank protokolliert. Um dich auf die Konfiguration von Bitbucket Pipelines zu konzentrieren, kannst du die Anwendung von deinem Terminal aus einfach klonen.
git clone git@bitbucket.org:spittet/bitbucket-pipelines-services-tutorial.gitGehe jetzt zu deinem lokalen Repository und führe npm install aus, um die von der Anwendung benötigten Abhängigkeiten zu installieren.
cd bitbucket-pipelines-services-tutorial
npm installBevor wir die Anwendung ausführen, müssen wir eine neue MongoDB-Instanz starten. Dank Docker kannst du das ganz einfach von deinem Terminal aus tun.
docker run --name mongodb -d -p 27017:27017 mongoStarte dann deine Anwendung und gehe zu http://localhost:3000, um sie in Aktion zu sehen.
npm start
Du kannst zu http://localhost:3000/visits gehen, um sicherzustellen, dass ein Besuch korrekt in der Datenbank protokolliert wurde.
Abschließend vergewissern wir uns, dass die Tests lokal erfolgreich abgeschlossen werden. Dazu verwenden wir den Befehl "npm test". Nach Ausführung dieses Befehls solltest du sehen können, dass zwei Tests abgeschlossen werden.
npm test
Diese Beispielanwendung führt zwei unterschiedliche Tests aus:
- Einen Test, der bestätigt, dass die Anwendung "Hello World" auf der Startseite anzeigt.
- Einen Test, der bestätigt, dass ein neuer Besuch in der Datenbank protokolliert wird, wenn jemand auf die Startseite zugreift.
Der erste Test wird auch dann bestehen, wenn die Datenbank ausgefallen ist, aber der zweite Test ist ein Integrationstest, der überprüft, ob die Webanwendung ordnungsgemäß mit dem Datenbankserver interagiert. Er könnte auch als Funktionstest verstanden werden, da er einige der Geschäftsanforderungen der Anwendung überprüft. In unserem Benutzerhandbuch erfährst du mehr über die verschiedenen Testtypen.
Sehen wir uns jetzt an, wie du Bitbucket Pipelines für die Automatisierung deiner Anwendungstests nutzen kannst und wie du es für die erfolgreiche Verwendung mit einer Datenbank konfigurierst.
Schritt 2: Automatisches Ausführen von Tests mit Bitbucket Pipelines
Beginne mit der Erstellung eines neuen Repositorys in deinem Bitbucket-Konto und update die Remote-URL, sodass origin auf dein Bitbucket-Repository verweist.
git remote add bitbucket git@bitbucket.org:<account name>/<repository name>.git
git branch -m mainline
git push -u bitbucket mainlineGehe zum Pipelines-Abschnitt deines Repositorys, um Bitbucket Pipelines zu aktivieren.
Du kannst die standardmäßige Javascript-Vorlage im nächsten Bildschirm verwenden. Sie enthält bereits die Befehle "npm install" und "npm test", die du brauchst, um Abhängigkeiten zu installieren und die Testsuite aufzuführen.
Die bitbucket-pipelines.yml-Datei sollte ungefähr so aussehen.
image: node:16
pipelines:
default:
- parallel:
- step:
name: Build and Test
caches:
- node
script:
- npm install
- npm testDer Datenbankdienst fehlt, aber wir werden ihn später hinzufügen.
Sobald du deine Datei committest, wirst du zum Pipelines-Abschnitt deines Repositorys weitergeleitet, wo du deine erste Pipeline in Bearbeitung sehen kannst. Deine Pipeline wird fehlschlagen, da der zweite Test ohne Datenbankverbindung nicht korrekt durchgeführt werden kann. Wenn du durch deine Pipeline klickst, müsstest du einen ähnlichen Bildschirm wie unten sehen, der mitteilt, dass 1 Test bestanden wurde und 1 Test fehlgeschlagen ist.
Im nächsten Abschnitt werden wir dieses Problem beheben, indem wir deiner Pipelines-Konfiguration eine neue Dienstdefinition hinzufügen.
Schritt 3: Hinzufügen einer Dienstdefinition für die Datenbank
Mit Bitbucket Pipelines kannst du bis zu drei zusätzliche Docker-Container auf der Hauptanwendung, die in einer Pipeline läuft, ausführen. Du kannst diese Container nutzen, um Dienste wie einen Datenspeicher, ein Analysetool oder einen beliebigen Drittanbieterdienst auszuführen, den deine Anwendung möglicherweise zur Vervollständigung der Pipeline benötigt. In unserem Fall verwenden wir einen separaten Service-Container, um MongoDB auszuführen.
Gehe zum Quellbereich deines Repositorys, um die Liste der Dateien zu sehen.
Klicke auf die Konfigurationsdatei bitbucket-pipelines.yml, um darauf zuzugreifen. In der oberen rechten Ecke findest du eine Schaltfläche "Bearbeiten", mit der du die Datei bearbeiten und direkt aus deinem Browser heraus committen kannst.
Am Ende der Konfigurationsdatei müssen wir eine Dienstdefinition für unsere Datenbank hinzufügen.
bitbucket-pipelines.yml
image: node:16
pipelines:
default:
- step:
script:
- npm install
- npm test
definitions:
services:
database:
image: mongoIm Fall von MongoDB benötigen wir keine zusätzlichen Einstellungen in der Image-Definition, aber bei manchen Docker-Images für Datenspeicher und -Dienste musst du möglicherweise einige Umgebungsvariablen angeben. Eine Liste von Datenbankbeispielen findest du in der Dokumentation zu Bitbucket Pipelines.
Bevor du die Datei committest, musst du den neuen Dienst zu dem Schritt hinzufügen, der die Tests ausführt. Die endgültige Pipelines-Konfiguration sollte wie der folgende Code aussehen.
bitbucket-pipelines.yml
image: node:16
pipelines:
default:
- step:
script:
- npm install
- npm test
services:
- database
definitions:
services:
database:
image: mongoGehe nach dem Committen der Datei zu deinem Pipelines-Abschnitt, um die Pipeline in Bearbeitung zu sehen. Sie sollte normalerweise erfolgreich abgeschlossen werden.
Du kannst im Protokoll-Panel auf die Registerkarte "Datenbank" klicken, um die Protokolle des MongoDB-Containers zu sehen.
Das war's! Du weißt jetzt, wie du deiner Pipeline Dienste hinzufügst, um Integrationstests durchzuführen. Denk daran, die Dokumentation zu lesen, um mehr über die Verwendung dieser Dienste zu erfahren.
Diesen Artikel teilen
Nächstes Thema
Lesenswert
Füge diese Ressourcen deinen Lesezeichen hinzu, um mehr über DevOps-Teams und fortlaufende Updates zu DevOps bei Atlassian zu erfahren.
DevOps-Community
DevOps-Lernpfad
