Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Migration guide 2.7 #31597

Merged
merged 2 commits into from
Sep 16, 2022
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
4 changes: 2 additions & 2 deletions .github/workflows/binary-compatibility-checks.yml
Original file line number Diff line number Diff line change
Expand Up @@ -28,10 +28,10 @@ jobs:
# we don't know what commit the last tag was it's safer to get entire repo so previousStableVersion resolves
fetch-depth: 0

- name: Set up JDK 8
- name: Set up JDK 11
uses: olafurpg/setup-scala@v10
with:
java-version: adopt@1.8.0
java-version: adopt@1.11

- name: Cache Coursier cache
uses: coursier/cache-action@v6.2
Expand Down
8 changes: 4 additions & 4 deletions .github/workflows/build-test-prValidation.yml
Original file line number Diff line number Diff line change
Expand Up @@ -19,10 +19,10 @@ jobs:
# we don't know what commit the last tag was it's safer to get entire repo so previousStableVersion resolves
fetch-depth: 0

- name: Set up JDK 8
- name: Set up JDK 11
uses: olafurpg/setup-scala@v10
with:
java-version: adopt@1.8.0
java-version: adopt@1.11

- name: Cache Coursier cache
uses: coursier/cache-action@v6.2
Expand All @@ -44,10 +44,10 @@ jobs:
# we don't know what commit the last tag was it's safer to get entire repo so previousStableVersion resolves
fetch-depth: 0

- name: Set up JDK 8
- name: Set up JDK 11
uses: olafurpg/setup-scala@v10
with:
java-version: adopt@1.8.0
java-version: adopt@1.11
Copy link
Member Author

@patriknw patriknw Sep 15, 2022

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@johanandren seems like the latest Paradox doesn't work with JDK 8, so I switched to 11. We have builds with 8 in the nightlies. If that becomes a problem we could add an extra compile with 8 job for pr validation.


- name: Cache Coursier cache
uses: coursier/cache-action@v6.2
Expand Down
2 changes: 1 addition & 1 deletion akka-docs/src/main/paradox/additional/rolling-updates.md
Original file line number Diff line number Diff line change
Expand Up @@ -185,7 +185,7 @@ and are using PersistenceFSM with Cluster Sharding, a full shutdown is required
If you've migrated from classic remoting to Artery
which has a completely different protocol, a rolling update is not supported.
For more details on this migration
see @ref:[the migration guide](../project/migration-guide-2.5.x-2.6.x.md#migrating-from-classic-remoting-to-artery).
see [the migration guide](https://doc.akka.io/docs/akka/2.6/project/migration-guide-2.5.x-2.6.x.html#migrating-from-classic-remoting-to-artery).

### Changing remoting transport

Expand Down
820 changes: 2 additions & 818 deletions akka-docs/src/main/paradox/project/migration-guide-2.5.x-2.6.x.md

Large diffs are not rendered by default.

19 changes: 19 additions & 0 deletions akka-docs/src/main/paradox/project/migration-guide-2.6.x-2.7.x.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
---
project.description: Migrating to Akka 2.7.
---
# Migration Guide 2.6.x to 2.7.x

The license for using Akka in production has been changed to Business Source License v1.1.
[Why We Are Changing the License for Akka](https://www.lightbend.com/blog/why-we-are-changing-the-license-for-akka)
explains the reasons and a [detailed FAQ](https://www.lightbend.com/akka/license-faq) is available to answer many of
the questions that you may have about the license change.

Akka 2.7.x is binary backwards compatible with 2.6.x with the ordinary exceptions listed in the
@ref:[Binary Compatibility Rules](../common/binary-compatibility-rules.md).

No configuration changes are needed for updating an application from Akka 2.6.x to 2.7.x.

Rolling updates of Akka Cluster from Akka 2.6.x to 2.7.x is fully supported.

No deprecated features or APIs have been removed in Akka 2.7.x.

2 changes: 2 additions & 0 deletions akka-docs/src/main/paradox/project/migration-guide-old.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,8 @@

Migration from old versions:

* [2.5.x to 2.6.x](https://doc.akka.io/docs/akka/2.6/project/migration-guide-2.5.x-2.6.x.html)
* [2.4.x to 2.5.x](https://doc.akka.io/docs/akka/2.5/project/migration-guide-2.4.x-2.5.x.html)
* [2.3.x to 2.4.x](https://doc.akka.io/docs/akka/2.4/project/migration-guide-2.3.x-2.4.x.html)
* [2.2.x to 2.3.x](https://doc.akka.io/docs/akka/2.3/project/migration-guide-2.2.x-2.3.x.html)
* [2.1.x to 2.2.x](https://doc.akka.io/docs/akka/2.2/project/migration-guide-2.1.x-2.2.x.html)
Expand Down
2 changes: 1 addition & 1 deletion akka-docs/src/main/paradox/project/migration-guides.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,8 +7,8 @@ project.description: Akka version migration guides.

@@@ index

* [migration-guide-2.5.x-2.6.x](migration-guide-2.6.x-2.7.x.md)
* [migration-guide-2.5.x-2.6.x](migration-guide-2.5.x-2.6.x.md)
* [migration-guide-2.4.x-2.5.x](migration-guide-2.4.x-2.5.x.md)
* [migration-guide-old](migration-guide-old.md)

@@@
2 changes: 1 addition & 1 deletion akka-docs/src/main/paradox/remoting-artery.md
Original file line number Diff line number Diff line change
Expand Up @@ -148,7 +148,7 @@ officially supported. If you're on a Big Endian processor, such as Sparc, it is

## Migrating from classic remoting

See @ref:[migrating from classic remoting](project/migration-guide-2.5.x-2.6.x.md#classic-to-artery)
See [migrating from classic remoting](https://doc.akka.io/docs/akka/2.6/project/migration-guide-2.5.x-2.6.x.html#classic-to-artery)

## Canonical address

Expand Down
5 changes: 3 additions & 2 deletions project/Paradox.scala
Original file line number Diff line number Diff line change
Expand Up @@ -66,8 +66,9 @@ object Paradox {
"index.html",
// Page that recommends Alpakka:
"camel.html",
// TODO page not linked to
"fault-tolerance-sample.html"))
// not linked
"fault-tolerance-sample.html",
"project/migration-guide-2.4.x-2.5.x.html"))

// FIXME https://github.com/lightbend/paradox/issues/350
// Exclusions from direct compilation for includes dirs/files not belonging in a TOC
Expand Down
2 changes: 1 addition & 1 deletion project/plugins.sbt
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ addSbtPlugin("com.github.sbt" % "sbt-unidoc" % "0.5.0")
addSbtPlugin("com.thoughtworks.sbt-api-mappings" % "sbt-api-mappings" % "3.0.2")
addSbtPlugin("pl.project13.scala" % "sbt-jmh" % "0.4.3")
addSbtPlugin("io.spray" % "sbt-boilerplate" % "0.6.1")
addSbtPlugin("com.lightbend.akka" % "sbt-paradox-akka" % "0.44")
addSbtPlugin("com.lightbend.akka" % "sbt-paradox-akka" % "0.45")
addSbtPlugin("de.heikoseeberger" % "sbt-header" % "5.7.0")
addSbtPlugin("com.hpe.sbt" % "sbt-pull-request-validator" % "1.0.0")
addSbtPlugin("net.bzzt" % "sbt-reproducible-builds" % "0.30")
Expand Down