You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@pekko.apache.org by GitBox <gi...@apache.org> on 2023/01/17 16:45:34 UTC
[GitHub] [incubator-pekko] kw217 opened a new issue, #109: Create a migration guide to migrate from Akka to Pekko
kw217 opened a new issue, #109:
URL: https://github.com/apache/incubator-pekko/issues/109
Create a migration guide explaining to a user of Akka how to migrate their project to Pekko.
We hope to automate as much of this as possible under #22 but first we need to determine the steps and lay them out so early adopters can follow them and gain experience.
This should be documented in `docs/src/main/paradox/project/migration-guide-akka-pekko.md`, linked from `migration-guides.md` in the same location, and also linked prominently from the GitHub homepage `README.md` and the project homepage `docs/src/main/paradox/index.md`.
Steps include:
* adapting Akka dependencies `"com.typesafe.akka"` -> `"org.apache.pekko"`
* adapting imports `import akka.actor` -> `import org.apache.pekko; import pekko.actor` - see #58
* adapting class names `Akka*` to `Pekko*` - see #67
* adapting packages and corresponding paths `akka` -> `org.apache.pekko`, if the codebase inserts code into the Akka namespace
* updating third-party dependencies to versions that depend on Pekko
* adapting configuration to use the `pekko` key - see #63
* discussion of how to approach Akka remote applications
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@pekko.apache.org.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@pekko.apache.org
For additional commands, e-mail: notifications-help@pekko.apache.org
[GitHub] [incubator-pekko] kw217 commented on issue #109: Create a migration guide to migrate from Akka to Pekko
Posted by "kw217 (via GitHub)" <gi...@apache.org>.
kw217 commented on issue #109:
URL: https://github.com/apache/incubator-pekko/issues/109#issuecomment-1415994921
Example migration (thanks @pjfanning): https://github.com/pjfanning/micrometer-akka/pull/3
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@pekko.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@pekko.apache.org
For additional commands, e-mail: notifications-help@pekko.apache.org
[GitHub] [incubator-pekko] kw217 commented on issue #109: Create a migration guide to migrate from Akka to Pekko
Posted by GitBox <gi...@apache.org>.
kw217 commented on issue #109:
URL: https://github.com/apache/incubator-pekko/issues/109#issuecomment-1386729045
Cool, thanks - added that to the description.
Docs location - presumably you're referring to https://github.com/apache/incubator-pekko/blob/main/docs/src/main/paradox/project/migration-guides.md which just got updated? Perfect. Should we just put the migration guide in that doc, rather than a separate doc linked from there?
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@pekko.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@pekko.apache.org
For additional commands, e-mail: notifications-help@pekko.apache.org
[GitHub] [incubator-pekko] sam-byng commented on issue #109: Create a migration guide to migrate from Akka to Pekko
Posted by "sam-byng (via GitHub)" <gi...@apache.org>.
sam-byng commented on issue #109:
URL: https://github.com/apache/incubator-pekko/issues/109#issuecomment-1460586229
Just reviewing the status of this issue, I think that the next steps on this card are to complete the following TODOs:
- Flesh out existing parts of migration guide with more details.
- Address the final three bullets are still not covered in issue description.
- Add clear linking from GitHub homepage.
- Add clear linking from the project website homepage: The migration guide is on the homepage (index.html) but the link is buried down in the Project Information subheading. Since the large proportion of PEKKO users will initially be migrating from AKKA I think that it is important that we place this in a clearer location e.g. the docs 'Getting Started' Guide.
- Add at link to a clean example migration to this migration guide OR copy snippets of it into the migration guide subsections when we flesh it out.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@pekko.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@pekko.apache.org
For additional commands, e-mail: notifications-help@pekko.apache.org
[GitHub] [incubator-pekko] pjfanning commented on issue #109: Create a migration guide to migrate from Akka to Pekko
Posted by GitBox <gi...@apache.org>.
pjfanning commented on issue #109:
URL: https://github.com/apache/incubator-pekko/issues/109#issuecomment-1386055908
* don't forget the pekko name in the jars (akka-actor becomes pekko-actor, etc.)
* the guide will go into the docs - there is a placeholder for the migration section in there (or at least once an inflight PR is merged)
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@pekko.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@pekko.apache.org
For additional commands, e-mail: notifications-help@pekko.apache.org
[GitHub] [incubator-pekko] pjfanning commented on issue #109: Create a migration guide to migrate from Akka to Pekko
Posted by "pjfanning (via GitHub)" <gi...@apache.org>.
pjfanning commented on issue #109:
URL: https://github.com/apache/incubator-pekko/issues/109#issuecomment-1566071560
We have a migration guide. It's not perfect but we can adjust it. Please raise PRs if you want to suggest changes - or comment on this issue.
Removing the milestone as I want to not have open issues in it.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@pekko.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@pekko.apache.org
For additional commands, e-mail: notifications-help@pekko.apache.org