Skip to content

Latest commit

 

History

History
140 lines (111 loc) · 4.49 KB

BUILD.md

File metadata and controls

140 lines (111 loc) · 4.49 KB
Raw

Building the Vaadin platform

Generate BOMs

For running the project, you need to run the following script before any maven related commands:

scripts/generateBoms.sh

If you want to use snapshot versions of the platform dependencies run:

scripts/generateBoms.sh --useSnapshots

Release process

For releasing a new platform from CI servers the workflow should be:

  1. set the version to release in pom.xml file by running mvn versions:set -DnewVersion=n.n.n
  2. generate and update other pom.xml files by running ./scripts/generateBoms.sh script, if you want to use snapshots run ./scripts/generateBoms.sh --useSnapshots instead.
  3. package mvn package -Pjavadocs -DskipTests
  4. deploy mvn deploy -Pproduction,release,javadocs,flatten-pom -DskipTests -DshrinkWrap
  5. generate release notes node scripts/generator/generate.js --platform=n.n.n --versions=versions.json

NOTE: that deploy needs to correctly set the credentials and target maven repo

Installing in local repo

You can install the platform artifacts in your local maven cache by running the following command.

mvn clean install -DskipTests

Optionally you might need smoke tests package for running in servlet-containers tests, then you need to run

mvn clean install -DskipTests -Pproduction -Pnpm-it

Running tests

There are three modules with Integration Tests, for running each one you need to enable the corresponding profile.

In Addition, tests include Collaboration Engine, you need to provide a valid license to run it by setting a maven property e.g:

-Dce.license='{"content":{"key":"XXX","owner":"foo","quota":1000000,"endDate":"date"},"checksum":"XXX"}'

Run integration tests in Sauce Labs

  1. You need valid Sauce Labs credentials for running the tests
  2. For Smoke Integration Tests run:
mvn verify -Pproduction,npm-it \
  -Dsa.user=your_username -Dsa.key=your_key \
  -Dce.license=your_ce_license
  1. For Fusion Integration Tests run:
mvn verify -Pproduction,fusion-hybrid \
  -Dsauce.user=your_username -Dsauce.sauceAccessKey=your_key \
  -Dce.license=your_ce_license
  1. For Servlet Contaner Integration Tests need to run:
mvn install -Pproduction,npm-it -DskipTests
mvn verify -Pproduction,npm-it-servlet-containers \
  -Dsauce.user=your_username -Dsauce.sauceAccessKey=your_key \
  -Dce.license=your_ce_license
  1. For gradle module tests
cd vaadin-platform-gradle-test
./gradlew clean build \
  -Pvaadin.productionMode \
  -Dsauce.user=your_username -Dsauce.sauceAccessKey=your_key

Runing tests in selenium hub

  1. First you need to install docker in your local computer, and run the selenium standalone container
 docker run --name selenium-container -p 4444:4444 -p7900:7900 --rm selenium/standalone-chrome:latest
  1. Then run the smoke tests in other terminal
mvn verify -Pproduction,npm-it \
  -Dce.license=your_ce_license \
  -Dcom.vaadin.testbench.Parameters.hubHostname=localhost \
  -Dcom.vaadin.testbench.Parameters.testsInParallel=1

NOTE: when docker container is running you can visit to http://localhost:7900 to see browser output

Running integration tests in local computer

  1. For Flow Integration Tests run:
mvn verify -Pproduction,npm-it \
  -Dce.license=your_ce_license \
  -Dcom.vaadin.testbench.Parameters.testsInParallel=1

Note that the number of test in parallel can be increased if your computer has enough resources.

  1. For Fusion Integration Tests run:
mvn verify -Pproduction,fusion-hybrid \
  -Dce.license=your_ce_license
  -Dcom.vaadin.testbench.Parameters.testsInParallel=1
  1. For Servlet Contaner Integration Tests need to run:

First compile e install smoke tests if not done already:

mvn install -DskipTests -Pproduction,npm-it

Then run the tests:

mvn verify -Pproduction,npm-it-servlet-containers \
  -Dce.license=your_ce_license \
  -Dcom.vaadin.testbench.Parameters.testsInParallel=1
  1. For running gradle module tests
cd vaadin-platform-gradle-test
./gradlew clean build \
  -Pvaadin.productionMode \
  -Dcom.vaadin.testbench.Parameters.testsInParallel=1

Running the test application

Run test application in dev-mode

When in the vaadin-platform-test folder run mvn jetty:run, then connect to the http://localhost:8080 URL.

In the vaadin-platform-hybrid-test run mvn spring-boot:run, then point your browser to http://localhost:8080.

In the vaadin-platform-gradle-test run ./gradlew appRun, then go to http://localhost:8080.