feat: WIP

Author: nilshartmann96

README.md

@@ -21,7 +21,7 @@ Gleichzeitig starten im Jenkins automatisch Build-Prozesse, die die vier Service
 
 Schaue im Jenkins nach, ob alle Pipelines durchgelaufen sind.
 
-Wenn die vier Services deployed sind, kann die Swagger-UI des Customer Services auf dem Testsystem
+Wenn die vier Services deployt sind, kann die Swagger-UI des Customer Services auf dem Testsystem
 über folgende URL erreicht werden: [Customer-Service](http://localhost:8281)
 
 ## Übung 1 - Verwendung des Pact-Brokers
@@ -30,7 +30,7 @@ Der Pact Broker ist bisher (außer eines Sample Contracts) leer.
 
 Wir wollen jetzt, dass die Services ihre Contracts via Pact austauschen.
 Dazu muss in allen vier Services der Branch `pact-broker`
-in den Branch `develop` gemerged werden.
+in den Branch `develop` gemergt werden.
 Gehe auf den Git-Server und erstelle zunächst im `customer-service`
 einen Pull-Request mit dem Base-Branch `develop`
 und dem Vergleichs-Branch `pact-broker` und führe diese dann zusammen.
@@ -47,7 +47,7 @@ Dazu erstellen wir wieder, wie oben beschrieben, einen Pull-Request
 und führen ihn zusammen.
 
 Nachdem wir beobachtet haben, dass der Billing Service gebaut
-und deployed wurde, können wir im Pact Broker sehen,
+und deployt wurde, können wir im Pact Broker sehen,
 dass der Billing Service den Contract des Customer Services verifiziert hat.
 
 Wir mergen nun analog den Delivery Service und beobachten auch hier,
@@ -63,7 +63,7 @@ und beobachten auch hier die Verifizierung.
 
 ## Übung 2 - Nur deployen, wenn der Branch verifiziert ist.
 
-Es wäre wünschenswert, dass ein Service nur deployed wird,
+Es wäre wünschenswert, dass ein Service nur deployt wird,
 wenn seine Contracts auch von den jeweiligen Providern verifiziert wurden.
 Um das zu erreichen, müssen wir die Pipelines so umbauen,
 dass die Consumer die Pipelines der Provider immer dann antriggern,
@@ -90,22 +90,22 @@ als auch der Build des Delivery Services angestoßen wird.
 Um sicherzustellen, dass alle Versionen einer Stage zusammenpassen,
 gibt es in Pact das Konzept der Tags.
 
-Sobald ein Service in einer Version auf einer Stage deployed worden ist,
+Sobald ein Service in einer Version auf einer Stage deployt worden ist,
 kann diese Version im Pact-Broker mit einem Tag der Stage versehen werden.
 
-Wir können das sehen, indem wir sowowhl im Address-Validation Service
+Wir können das sehen, indem wir sowohl im Address-Validation Service
 als auch im Billing Service jeweils den Branch `pact-tags` in den Branch `develop` mergen.
-Nach erfolgreichem Deployment sind die jeweiligen Versionen im Pact Broker getagged.
+Nach erfolgreichem Deployment sind die jeweiligen Versionen im Pact Broker getaggt.
 
 Wenn wir nun im Delivery Service den Branch `pact-tags` in `develop` mergen,
 können wir beobachten, dass der Address-Validation Service beim Verifizieren
-des Contracts die Version verwendet, die auch auf der Stage deployed ist,
+des Contracts die Version verwendet, die auch auf der Stage deployt ist,
 auf die der Delivery Service deployen möchte (in diesem Fall die Test-Stage).
 Um zu signalisieren, dass die gerade getestete Version des Delivery Services
-noch nicht auf der Stage vorhanden ist, aber auf die Stage deployed werden soll,
-tagged der Delivery Service seinen Contract zunächst mit `pending-test`.
-Der Address Validation Service validiert dann alle Contracts, die mit `pending-test` getagged sind.
-Nach erfolgreichem Deployment des Delivery Services, tagged dieser den Contract
+noch nicht auf der Stage vorhanden ist, aber auf die Stage deployt werden soll,
+taggt der Delivery Service seinen Contract zunächst mit `pending-test`.
+Der Address Validation Service validiert dann alle Contracts, die mit `pending-test` getaggt sind.
+Nach erfolgreichem Deployment des Delivery Services, taggt dieser den Contract
 mit dem Tag `test`.
 
 Dasselbe können wir erneut beim Customer Service beobachten,
@@ -121,19 +121,23 @@ sogar auf unterschiedlichen Build-Servern laufen,
 werden andere Mechanismen benötigt, um die Verifikation von Contracts anzustoßen.
 
 Der Pact Broker bietet hierzu die Möglichkeit,
-zwei Arten von Web-Hooks zu registrieren.
+zwei Arten von Webhooks zu registrieren.
 Einerseits kann man einen Webhook registrieren,
 der aufgerufen wird, wenn ein Contract hochgeladen wird.
-Diesen werden wir dazu verwenden, die Verifikation anzustoßen.
+Andererseits kann man einen Webhook registrieren,
+der aufgerufen wird, wenn ein Contract verifiziert
+und das Ergebnis hochgeladen wurde.
+Ersteren werden wir verwenden, um die Verifikation anzustoßen.
 
 Wir können die Webhooks registrieren, indem wir im Pact-Broker rechts oben
 auf den `API Browser` gehen.
 Dort suchen wir die Ressource `pb:webhooks` und klicken auf `Perform non-GET request`.
 Das ist das gelb unterlegte `!`.
 
-Insgesamt wollen wir fünf Webhooks anlegen: Drei zum Antriggern der Verifikation
+Insgesamt wollen wir fünf Webhooks anlegen:
+zunächst einmal drei zum Antriggern der Verifikation
 (nämlich für den Billing Service, den Delivery Service und den Address Validation Service).
-Dafür führen wir drei POST-Requests aus mit den folgenden Bodys:
+Dazu führen wir drei POST-Requests mit den folgenden Bodys aus:
 
 ```
 {
@@ -214,7 +218,7 @@ Dafür führen wir drei POST-Requests aus mit den folgenden Bodys:
 ```
 
 Außerdem legen wir mit weiteren POST-Requests noch zwei Webhooks an, die getriggert werden, wenn eine Verifikation erfolgreich war
-und der Service auf die Stage deployen kann. Diese brauchen wir für den Customer Service und den Delivery Service:
+und der Service auf die Stage deployen kann. Diese brauchen wir für den Customer Service und den Delivery Service.
 
 ```
 {

address-validation-service/Jenkinsfile

@@ -16,7 +16,7 @@ pipeline {
         PERFORM_RELEASE = "${env.SNAPSHOT_VERSION.contains('-SNAPSHOT') && env.BRANCH_NAME == 'main' && !env.LAST_COMMIT_MESSAGE.startsWith('update version to ')}"
         RELEASE_VERSION = "${env.SNAPSHOT_VERSION.contains('-SNAPSHOT') ? env.SNAPSHOT_VERSION.substring(0, env.SNAPSHOT_VERSION.lastIndexOf('-SNAPSHOT')) : SNAPSHOT_VERSION}"
         VERSION = "${env.BRANCH_NAME == 'main' && !env.LAST_COMMIT_MESSAGE.startsWith('update version to ') ? env.RELEASE_VERSION : env.SNAPSHOT_VERSION}"
-        PACT_VERSION = "${env.RELEASE_VERSION}+${env.GIT_COMMIT}"
+        PACT_VERSION = "${env.BRANCH_NAME == 'main' ? env.RELEASE_VERSION : env.RELEASE_VERSION + '+' + env.GIT_COMMIT}"
         ROOT_DIRECTORY = "${params.verifyPacts == true && env.BRANCH_NAME == 'main' && env.SNAPSHOT_VERSION.endsWith("-SNAPSHOT") ? 'target/checkout' : '.'}"
         STAGE = "${env.BRANCH_NAME == 'main' ? 'production' : 'test'}"
     }

billing-service/Jenkinsfile

@@ -16,7 +16,7 @@ pipeline {
         PERFORM_RELEASE = "${env.SNAPSHOT_VERSION.contains('-SNAPSHOT') && env.BRANCH_NAME == 'main' && !env.LAST_COMMIT_MESSAGE.startsWith('update version to ')}"
         RELEASE_VERSION = "${env.SNAPSHOT_VERSION.contains('-SNAPSHOT') ? env.SNAPSHOT_VERSION.substring(0, env.SNAPSHOT_VERSION.lastIndexOf('-SNAPSHOT')) : SNAPSHOT_VERSION}"
         VERSION = "${env.BRANCH_NAME == 'main' && !env.LAST_COMMIT_MESSAGE.startsWith('update version to ') ? env.RELEASE_VERSION : env.SNAPSHOT_VERSION}"
-        PACT_VERSION = "${env.RELEASE_VERSION}+${env.GIT_COMMIT}"
+        PACT_VERSION = "${env.BRANCH_NAME == 'main' ? env.RELEASE_VERSION : env.RELEASE_VERSION + '+' + env.GIT_COMMIT}"
         ROOT_DIRECTORY = "${params.verifyPacts == true && env.BRANCH_NAME == 'main' && env.SNAPSHOT_VERSION.endsWith("-SNAPSHOT") ? 'target/checkout' : '.'}"
         STAGE = "${env.BRANCH_NAME == 'main' ? 'production' : 'test'}"
     }

customer-service/Jenkinsfile

@@ -17,7 +17,7 @@ pipeline {
         PERFORM_RELEASE = "${env.SNAPSHOT_VERSION.contains('-SNAPSHOT') && env.BRANCH_NAME == 'main' && !env.LAST_COMMIT_MESSAGE.startsWith('update version to ')}"
         RELEASE_VERSION = "${env.SNAPSHOT_VERSION.contains('-SNAPSHOT') ? env.SNAPSHOT_VERSION.substring(0, env.SNAPSHOT_VERSION.lastIndexOf('-SNAPSHOT')) : SNAPSHOT_VERSION}"
         VERSION = "${env.BRANCH_NAME == 'main' && !env.LAST_COMMIT_MESSAGE.startsWith('update version to ') ? env.RELEASE_VERSION : env.SNAPSHOT_VERSION}"
-        PACT_VERSION = "${env.RELEASE_VERSION}+${env.GIT_COMMIT}"
+        PACT_VERSION = "${env.BRANCH_NAME == 'main' ? env.RELEASE_VERSION : env.RELEASE_VERSION + '+' + env.GIT_COMMIT}"
         STAGE = "${env.BRANCH_NAME == 'main' ? 'production' : 'test'}"
         DEPLOYMENT_VERSION = "${params.deploymentVersion != 'latest' ? params.deploymentVersion : env.VERSION}"
     }

delivery-service/Jenkinsfile

@@ -18,7 +18,7 @@ pipeline {
         PERFORM_RELEASE = "${env.SNAPSHOT_VERSION.contains('-SNAPSHOT') && env.BRANCH_NAME == 'main' && !env.LAST_COMMIT_MESSAGE.startsWith('update version to ')}"
         RELEASE_VERSION = "${env.SNAPSHOT_VERSION.contains('-SNAPSHOT') ? env.SNAPSHOT_VERSION.substring(0, env.SNAPSHOT_VERSION.lastIndexOf('-SNAPSHOT')) : SNAPSHOT_VERSION}"
         VERSION = "${env.BRANCH_NAME == 'main' && !env.LAST_COMMIT_MESSAGE.startsWith('update version to ') ? env.RELEASE_VERSION : env.SNAPSHOT_VERSION}"
-        PACT_VERSION = "${env.RELEASE_VERSION}+${env.GIT_COMMIT}"
+        PACT_VERSION = "${env.BRANCH_NAME == 'main' ? env.RELEASE_VERSION : env.RELEASE_VERSION + '+' + env.GIT_COMMIT}"
         ROOT_DIRECTORY = "${params.verifyPacts == true && env.BRANCH_NAME == 'main' && env.SNAPSHOT_VERSION.endsWith("-SNAPSHOT") ? 'target/checkout' : '.'}"
         STAGE = "${env.BRANCH_NAME == 'main' ? 'production' : 'test'}"
         DEPLOYMENT_VERSION = "${params.deploymentVersion != 'latest' ? params.deploymentVersion : env.VERSION}"