Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/eventuate-tram/eventuate-upgrade-scripts


https://github.com/eventuate-tram/eventuate-upgrade-scripts

Last synced: 11 days ago
JSON representation

Awesome Lists containing this project

README

        

= eventuate-upgrade-scripts

The latest versions of https://github.com/eventuate-local/eventuate-local[Eventuate Local] and https://github.com/eventuate-tram/eventuate-tram-core[Eventuate Tram] now support both Spring Boot and https://micronaut.io/[Micronaut].
Adding support for Micronaut required changing the names of both Maven artifacts and packages.
As a result, in order to upgrade to these versions, you must edit your source code.

== Automating editing with replace_dependencies.py

`replace_dependencies.py` is a python script that makes the necessary changes for you.
It edits the following files:

* Maven `pom.xml` and `build.gradle` - changes artifact names
* `gradle.properties` - updates the artifact versions, assuming they use the same naming conventions as the Eventuate example applications
* `*.java` - renames imported packages and classes

=== What it doesn't handle:

The script cannot replace the removed `eventuate-jpa-sagas-framework` artifact.
Depending on the role the service plays in a saga, it should be replaced manually by one or both of the following:

* `eventuate-tram-sagas--orchestration`
* `eventuate-tram-sagas--participant`

If that dependency found during dependency replacements, the script prints a warning.

=== How to use

To update a Spring Boot-based application, perform the following steps:

. `git clone https://github.com/eventuate-tram/eventuate-upgrade-scripts.git`
. `cd `
. `python /replace_dependencies.py`

`replace_dependencies.py` can also update Eventuate/Micronaut applications by passing MICRONAUT option.
To update micronaut application step 3 should be changed to:

`python /replace_dependencies.py MICRONAUT`