akka-hosting-actor-patterns

Host Akka.NET entity actors with local testing and cluster deployment patterns.

Updated Feb 10, 2026
One-click install
npx skills add https://github.com/tientt010/Dotnet-JiraLite-Microservices --skill akka-hosting-actor-patterns-tientt010
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: akka-hosting-actor-patterns
Source: https://github.com/tientt010/Dotnet-JiraLite-Microservices/tree/main/.github/skills/akka-hosting-actor-patterns
Command: npx skills add https://github.com/tientt010/Dotnet-JiraLite-Microservices --skill akka-hosting-actor-patterns-tientt010

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Patterns for building scalable entity actors with Akka.Hosting, enabling local testing and clustered production modes using GenericChildPerEntityParent, message extractors, cluster sharding abstractions, akka-reminders, and ITimeProvider.

Core Features & Use Cases

  • LocalTest and Clustered execution modes to run in unit tests or production clusters.
  • GenericChildPerEntityParent for local routing of messages to per-entity actors without a cluster.
  • IMessageExtractor-based routing and strongly-typed IDs for safe message delivery.
  • Akka.Hosting extension methods for fluent, composable actor configuration.
  • ITimeProvider integration to allow testable time-based logic instead of DateTime.Now.
  • Akka.Reminders integration for durable scheduling (PostgreSQL and in-memory options).
  • Marker types and registry patterns to reference shard regions and parent actors clearly.

Quick Start

Enable the akka-hosting-actor-patterns by wiring your Akka configuration and choose LocalTest or Clustered execution mode to run tests or deploy to a cluster.

Frequently Asked Questions about akka-hosting-actor-patterns

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I test Akka.NET cluster sharding locally without deploying a full cluster?

You can test Akka.NET cluster sharding locally by using the LocalTest execution mode combined with GenericChildPerEntityParent. This setup routes messages to per-entity actors in unit tests, eliminating the need for a production cluster deployment.

How does ITimeProvider work for testing time-based logic in Akka.NET actors?

ITimeProvider abstracts time-based logic in Akka.NET actors by replacing direct DateTime.Now calls. This integration allows you to inject controlled time values during unit tests, ensuring predictable timing behavior for scheduled actor messages.

What is the best way to route messages to entity actors using Akka.Hosting?

The best way to route messages is using IMessageExtractor-based routing with strongly-typed IDs. Akka.Hosting provides fluent extension methods to configure these message extractors and shard regions for safe message delivery to your entity actors.

Can I use Akka.Reminders for durable scheduling with PostgreSQL in an actor system?

Yes, you can use Akka.Reminders for durable scheduling with PostgreSQL or in-memory options. This integration works with Akka.Hosting and cluster sharding to provide persistent, reliable scheduling for your domain-driven entity actors.

Do I need Akka.Cluster.Sharding to use these actor hosting patterns?

Akka.Cluster.Sharding is required for the Clustered execution mode to enable scalable production behavior with shard regions. However, you can bypass it using the LocalTest mode for unit testing without cluster dependencies.