How does it handle scheduled tasks?

It integrates with akka-reminders for durable scheduling and utilizes ITimeProvider to allow for deterministic testing of time-based actor logic.

Can I use this for production cluster sharding?

Yes, the skill includes patterns to toggle between LocalTest mode for development and Clustered mode using ShardRegions for production environments.

What is the GenericChildPerEntityParent pattern?

It is a lightweight parent actor that routes messages to child entities based on IDs, mimicking Akka Cluster Sharding semantics for local testing without requiring a full cluster.

Is this compatible with standard Akka.Hosting?

Yes, it is built on top of Akka.Hosting extension methods and utilizes the ActorRegistry for clean dependency injection and actor discovery.

Do I need to write different code for tests and production?

No, the core principle is execution mode abstraction, allowing you to run the same actor logic locally or in a cluster by changing a single configuration setting.

Akka.Hosting Actor Patterns

Name: Akka.Hosting Actor Patterns
Author: Aaronontheweb

byAaronontheweb

•

423

•

API Development

Provides standardized patterns and extension methods for building testable, sharded entity actors using Akka.NET and Akka.Hosting.

This skill streamlines the development of entity-based actors in .NET by providing reusable patterns for message extraction, cluster sharding, and local testing. It introduces the GenericChildPerEntityParent pattern to mimic sharding behavior in non-clustered environments, ensuring code consistency between unit tests and production deployments. With built-in support for ITimeProvider for testable scheduling and akka-reminders for durable tasks, it helps developers build robust, scalable distributed systems that are maintainable and easy to verify.

Key Features

01GenericChildPerEntityParent for sharding-like behavior in unit tests

02423 GitHub stars

03Execution mode abstraction for seamless local vs. clustered switching

04Standardized IMessageExtractor implementations for consistent routing

05Fluent Akka.Hosting extension methods for clean actor registration

06Testable time-based logic via ITimeProvider and ActorSystem.Scheduler

Use Cases

01Implementing durable scheduled tasks that persist across service restarts using Akka Reminders and PostgreSQL

02Creating unit tests for actor-based systems without the overhead of setting up a full Akka Cluster

03Building scalable domain entity actors like Orders or Users that require cluster sharding in production

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add aaronontheweb/dotnet-skills akka-hosting-actor-patterns

For use in Claude.ai and ChatGPT

Download Skill