From 9074b434c26ae3dc7ffea7331a83ff2be0ea9a5b Mon Sep 17 00:00:00 2001 From: Patrik Nordwall Date: Tue, 8 Sep 2020 08:29:28 +0200 Subject: [PATCH] minor doc updates for replicated event sourcing (#29561) * also link to Projections in cqrs page --- akka-docs/src/main/paradox/common/may-change.md | 1 + akka-docs/src/main/paradox/common/other-modules.md | 11 +++++------ akka-docs/src/main/paradox/project/examples.md | 8 ++++++-- akka-docs/src/main/paradox/typed/cqrs.md | 6 +----- 4 files changed, 13 insertions(+), 13 deletions(-) diff --git a/akka-docs/src/main/paradox/common/may-change.md b/akka-docs/src/main/paradox/common/may-change.md index 1930f3dfe9..79b9c7cfd2 100644 --- a/akka-docs/src/main/paradox/common/may-change.md +++ b/akka-docs/src/main/paradox/common/may-change.md @@ -31,5 +31,6 @@ These are the current complete modules marked as **may change**: * @ref:[Multi Node Testing](../multi-node-testing.md) * @ref:[Reliable Delivery](../typed/reliable-delivery.md) * @ref:[Sharded Daemon Process](../typed/cluster-sharded-daemon-process.md) +* @ref:[Replicated Event Sourcing](../typed/replicated-eventsourcing.md) diff --git a/akka-docs/src/main/paradox/common/other-modules.md b/akka-docs/src/main/paradox/common/other-modules.md index a1d5f41b0c..872ed5d317 100644 --- a/akka-docs/src/main/paradox/common/other-modules.md +++ b/akka-docs/src/main/paradox/common/other-modules.md @@ -4,6 +4,10 @@ A full server- and client-side HTTP stack on top of akka-actor and akka-stream. +## [Akka gRPC](https://doc.akka.io/docs/akka-grpc/current/) + +Akka gRPC provides support for building streaming gRPC servers and clients on top of Akka Streams. + ## [Alpakka](https://doc.akka.io/docs/alpakka/current/) Alpakka is a Reactive Enterprise Integration library for Java and Scala, based on Reactive Streams and Akka. @@ -13,7 +17,7 @@ Alpakka is a Reactive Enterprise Integration library for Java and Scala, based o The Alpakka Kafka Connector connects Apache Kafka with Akka Streams. -## [Akka Projection](https://doc.akka.io/docs/akka-projection/current/) +## [Akka Projections](https://doc.akka.io/docs/akka-projection/current/) Akka Projections let you process a stream of events or records from a source to a projected model or external system. @@ -45,10 +49,6 @@ Use [Google Cloud Spanner](https://cloud.google.com/spanner/) as Akka Persistenc * [Akka Discovery for Kubernetes, Consul, Marathon, and AWS](https://doc.akka.io/docs/akka-management/current/discovery/) * [Kubernetes Lease](https://doc.akka.io/docs/akka-management/current/kubernetes-lease.html) -## [Akka gRPC](https://doc.akka.io/docs/akka-grpc/current/) - -Akka gRPC provides support for building streaming gRPC servers and clients on top of Akka Streams. - ## Akka Resilience Enhancements * [Akka Thread Starvation Detector](https://doc.akka.io/docs/akka-enhancements/current/starvation-detector.html) @@ -57,7 +57,6 @@ Akka gRPC provides support for building streaming gRPC servers and clients on to ## Akka Persistence Enhancements -* [Akka Multi-DC Persistence](https://doc.akka.io/docs/akka-enhancements/current/persistence-dc/index.html) * [Akka GDPR for Persistence](https://doc.akka.io/docs/akka-enhancements/current/gdpr/index.html) ## Community Projects diff --git a/akka-docs/src/main/paradox/project/examples.md b/akka-docs/src/main/paradox/project/examples.md index d108262df8..2a663fbf25 100644 --- a/akka-docs/src/main/paradox/project/examples.md +++ b/akka-docs/src/main/paradox/project/examples.md @@ -59,9 +59,13 @@ This project contains a Shopping Cart sample illustrating how to use Akka Persis The events are tagged to be consumed by even processors to build other representations from the events, or publish the events to other services. -## Multi-DC Persistence +## Replicated Event Sourcing -This commercial feature has now been superseded by @ref[Replicated Event Sourcing](../typed/replicated-eventsourcing.md) +@java[@extref[Multi-DC Persistence example project](samples:akka-samples-persistence-dc-java)] +@scala[@extref[Multi-DC Persistence example project](samples:akka-samples-persistence-dc-scala)] + +Illustrates how to use @ref:[Replicated Event Sourcing](../typed/replicated-eventsourcing.md) that supports +active-active persistent entities across data centers. ## Cluster with Docker diff --git a/akka-docs/src/main/paradox/typed/cqrs.md b/akka-docs/src/main/paradox/typed/cqrs.md index e99417b8ed..ed908acc8a 100644 --- a/akka-docs/src/main/paradox/typed/cqrs.md +++ b/akka-docs/src/main/paradox/typed/cqrs.md @@ -1,11 +1,7 @@ # CQRS -@ref:[EventSourcedBehavior](persistence.md)s along with @ref:[Persistence Query](../persistence-query.md)'s `EventsByTag` query can be used to implement +@ref:[EventSourcedBehavior](persistence.md)s along with [Akka Projections](https://doc.akka.io/docs/akka-projection/current/) can be used to implement Command Query Responsibility Segregation (CQRS). - -The [CQRS with Akka 2.6 video](https://akka.io/blog/news/2020/02/05/akka-cqrs-video) is a good starting point for -learning how to use `eventsByTag` to implement CQRS with Akka. Also, watch the introduction to -[Event Sourcing with Akka 2.6 video](https://akka.io/blog/news/2020/01/07/akka-event-sourcing-video). The @java[@extref[CQRS example project](samples:akka-samples-cqrs-java)]@scala[@extref[CQRS example project](samples:akka-samples-cqrs-scala)] shows how to do this, including scaling read side processors for building projections.