PLC/vPLC>> EcommerceApp>> 返回
项目作者： teixeira-fernando

项目描述 ：
QA Strategy for microservices with Synchronous and Asynchronous communication
高级语言： Java
项目地址: git://github.com/teixeira-fernando/EcommerceApp.git
创建时间： 2020-09-11T22:55:08Z
项目社区：https://github.com/teixeira-fernando/EcommerceApp
开源协议：Apache License 2.0
下载



Coverage
Bugs
Technical Debt

Can I Deploy - Inventory

Quality gate

E-commerce App - Exploring QA strategies for microservices with Synchronous and Asynchronous communication

The initial objective of this project was to further study the differences in the development and implementation of quality strategies for microservices with synchronous and asynchronous communication. I decided to do all the development of the application and the tests from scratch to be able to better observe some details in practice.

Microservices

  • Shop
  • Inventory
  • Shipment

alt text

Requirements to run it locally

To run it locally, you have two options:

  • To Run it using Docker, you need only Docker and Docker compose installed on your machine
  • To run using your IDE, you need Java 17 and Maven configured on your machine

Instructions to run the project

The docker-compose file contains the pre-requisites to run the application: MongoDB and Kafka

It’s also necessary to generate some dependencies jars from the modules:

  1. mvn clean install

Now, you can bring up the docker-compose: 

  1. docker-compose up -d

Or you can also run each application module individually:

Run Inventory:

  1. mvn -f inventory/ spring-boot:run

Run Shop:

  1. mvn -f shop/ spring-boot:run

Run Shipment:

  1. mvn -f shipment/ spring-boot:run

QA Strategy

  • Unit Tests: Junit5 and Mockito
  • Integration tests: Spring Boot Test, WireMock and EmbeddedKafka (when testing asynchronous events)
  • Quality Metrics:
    • Mutation Tests/Mutation Coverage: PITest
    • Code Coverage: Jacoco
    • Technical Debt, Code Smells and other complementary metrics : Sonar Cloud
  • Contract tests: Pact framework
  • Continuous Integration: This project uses Github Action for Continuous Integration, where it executes all the tests and Sonar Cloud Analysis for every pull request, making easier the process of integration of every new code, also facilitating the process of Code Review.

Development technology stack

  • Development:
    • Spring Boot
    • Java 17
    • Maven
  • Kafka
  • MongoDB
  • Github Actions
  • Docker

Pipeline configuration

This repository includes 2 pipelines.

  • PR_Pipeline: Runs a build for every created PR, executing the different test suites of the project and validating the code quality of the introduced changes
  • release-pipeline: Run after every merge to master branch. It does the release process, including creating and publishing docker images for every project module, tagging the pacts, etc.

Instructions for contract tests with Pact

This project contains contract tests using Pact. You need to setup your PactFlow account in order to use it.

PS: Be aware of some environment variables you may need to run some of the commands below and also the pipeline:

  • PACT_BROKER_URL
    • Correspond to the url of your personal pact flow account
  • PACT_BROKER_TOKEN
    • Correspond to the token from your pact flow account with full rights to read and write
  • PACT_BROKER_HOST
    • Correspond to the host value of your Pact flow account

Running the pact tests locally

Besides the CI configuration where the tests are configured to run. You can also run them locally. You need first to also set some of the variables mentioned above.

Then you can go to the producer module and execute the contract tests, to generate the contracts. The pact files will be
written in the target/pact folder. It is configured to automatically publish the pacts into the pact broker.

  1. mvn -f {folder}/ -Dtest=**/contract/*ConsumerPact test

If you want to manually publish the pacts into the pact broker, you can execute the following command:

  1. mvn pact:publish

Then you can run the contract tests in the provider side, where it is already configured to get it from the pact broker

  1. mvn -f {folder}/ -Dtest=**/contract/*ProviderPact test

Other info and Utilities

  • Check code Style:
  1. mvn spotless::check (in the sub-module directory)
  • Apply code Style:
  1. mvn spotless::apply (in the sub-module directory)

Articles with more info related to this project

https://medium.com/assertqualityassurance/creating-a-test-strategy-for-asynchronous-microservices-applications-1397f7755e85