An umbrella project containing all Solace projects for Spring Cloud.
For information about Solace Projects that are only for Spring Boot, please visit the Solace Spring Boot project.
- Repository Contents
- Building Locally
- Release Process
- Samples
- Contributing
- Authors
- License
- Support
- Resources
The Solace Spring Cloud BOM is a POM file which defines the versions of Solace Spring Cloud projects that are compatible to a particular version of Spring Cloud.
Please consult the Spring Cloud Compatibility Table to determine which version of the BOM is compatible with your project.
These are the projects contained within this repository:
To build the artifacts locally, simply clone this repository and run mvn package
at the root of the project.
This will build everything.
git clone https://github.com/SolaceProducts/solace-spring-cloud.git
cd solace-spring-cloud
mvn package # or mvn install to install them locally
solace-spring-cloud-build (root)
<-- solace-spring-cloud-bom
<-- solace-spring-cloud-parent
<-- solace-spring-cloud-stream-starter [spring-cloud-starter-stream-solace]
<-- solace-spring-cloud-stream-binder-core [spring-cloud-stream-binder-solace-core]
<-- solace-spring-cloud-stream-binder [spring-cloud-stream-binder-solace]
Where <-- indicates the parent of the project
All sub-projects are included as modules of solace-spring-cloud-build
. Running mvn package
or mvn install
at the root of the project will package/install all sub-projects.
These projects are used to build the solace-spring-cloud
repository. They should not be used in your actual application.
- solace-spring-cloud-build
This POM defines build-related plugins and profiles that are inherited by the BOM as well as for each of the sub-projects. The version of this POM should match the version of Spring Cloud that the build will target.
Please do not put non-Solace-Spring-Cloud dependencies here - they belong in solace-spring-cloud-parent. The exception to this is naturally the version of Spring Cloud that this build targets. If it shouldn't be inherited by the BOM, it doesn't go here. - solace-spring-cloud-parent
This POM defines common properties and dependencies for the Solace Spring Cloud projects.
Run the following command to run all the unit and integration tests:
mvn clean verify
By default, the tests requires for Docker to be installed on the host machine so that they can auto-provision a PubSub+ broker. Otherwise, the following environment variables can be set to direct the tests to use an external broker:
SOLACE_JAVA_HOST=tcp://localhost:55555
SOLACE_JAVA_CLIENT_USERNAME=default
SOLACE_JAVA_CLIENT_PASSWORD=default
SOLACE_JAVA_MSG_VPN=default
TEST_SOLACE_MGMT_HOST=http://localhost:8080
TEST_SOLACE_MGMT_USERNAME=admin
TEST_SOLACE_MGMT_PASSWORD=admin
Parallel test execution is disabled by default. Add the -Djunit.jupiter.execution.parallel.enabled=true
option to your command to enable parallel test execution.
- Update
solace-spring-boot-bom
to latest released version - Release
mvn -B release:prepare
See solace-samples-spring repository for samples.
Please read CONTRIBUTING.md for details on the process for submitting pull requests to us.
See the list of contributors who participated in this project.
This project is licensed under the Apache License, Version 2.0. - See the LICENSE file for details.
Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.
For more information about Spring Boot Auto-Configuration and Starters try these resources:
- Spring Docs - Spring Boot Auto-Configuration
- Spring Docs - Developing Auto-Configuration
- GitHub Tutorial - Master Spring Boot Auto-Configuration
For more information about Cloud Foundry and the Solace PubSub+ service these resources:
- Solace PubSub+ for VMware Tanzu
- Cloud Foundry Documentation
- For an introduction to Cloud Foundry: https://www.cloudfoundry.org/
For more information about Spring Cloud try these resources:
- Spring Cloud
- Spring Cloud Stream Reference Guide
- Spring Cloud Stream Sample Applications
- Spring Cloud Stream Source Code
For more information about Solace technology for Spring Boot please visit these resources:
For more information about Solace technology in general please visit these resources:
- The Solace Developer Portal
- Ask the Solace community
- Checkout the Solace Blogs
.......................HELLO FROM THE OTTER SIDE...........
............................www.solace.com.................
...........................................................
...........................@@@@@@@@@@@@@@@@@@@.............
........................@@ @@...........
.....................@ # # @.........
....................@ # # @........
.....................@ @@@@@@@@@ @.........
......................@ @@@@@@@@@@@ @..........
.....................@ @@@@@@@ @.........
.....................@ @ @.........
.....................@ \_______/ \________/ @.........
......................@ | | @.........
.......................@ | | @..........
.......................@ \_____/ @...........
....@@@@@...............@ @...........
..@@ @...............@ @...........
..@ @@.............@ @...........
..@ @@............@ @...........
..@@ @............@ @...........
....@ @............@ @..........
.....@@ @...........@ @.........
.......@ @.........@ @........
........@ @........@ @.......
........@ @@@@@@ @......
.........@ @....
.........@ @...
..........@@ @...
............@ @...
.............@ @ @...
...............@ @ @...
.................@ @ @...
..................@ @ @...
...................@ @ @...
...................@ @ @...
...................@ @ @...
...................@ @ @....
..................@ @ @....
..................@ @ @.....
..................@ @ @.....
..................@ @ @@.....
..................@ @ @ @.....
..................@ @@@@@ @.....
..................@ @.....
..................@ @.....