Over the three units of this bootcamp you will learn how to create fully-functional, real-world programs using Akka.NET actors and many other parts of the core Akka.NET framework!
We will start with some basic actors and have you progressively work your way up to larger, more sophisticated examples.
The course is self-directed learning. You can do it at whatever pace you wish. You can sign up here to have one Akka.NET Bootcamp lesson emailed to you daily if you'd like a little help pacing yourself throughout the course.
NOTE: F# support is in progress (see the FSharp branch). We will happily accept F# pull requests. Feel free to send them in.
What will you learn?
In Akka.NET Bootcamp you will learn how to use Akka.NET actors to build reactive, concurrent applications.
You will learn how to build types of applications that may have seemed impossible or really, really hard to make prior to learning Akka.NET. You will walk away from this bootcamp with the confidence to handle bigger and harder problems than ever before!
In Unit 1, we will learn the fundamentals of how the actor model and Akka.NET work.
*NIX systems have the
tail command built-in to monitor changes to a file (such as tailing log files), whereas Windows does not. We will recreate
tail for Windows and use the process to learn the fundamentals.
In Unit 1 you will learn:
- How to create your own
- How to send messages actors and how to handle different types of messages;
- How to use
IActorRefs to build loosely coupled systems.
- How to use actor paths, addresses, and
ActorSelectionto send messages to actors.
- How to create child actors and actor hierarchies, and how to supervise children with
- How to use the Actor lifecycle to control actor startup, shutdown, and restart behavior.
In Unit 2, we're going to get into some more of the intermediate Akka.NET features to build a more sophisticated application than what we accomplished at the end of unit 1.
In Unit 2 you will learn:
- How to use HOCON configuration to configure your actors via App.config and Web.config;
- How to configure your actor's Dispatcher to run on the Windows Forms UI thread, so actors can make operations directly on UI elements without needing to change contexts;
- How to handle more sophisticated types of pattern matching using
- How to use the
Schedulerto send recurring messages to actors;
- How to use the Publish-subscribe (pub-sub) pattern between actors;
- How and why to switch actor's behavior at run-time; and
- How to
Stashmessages for deferred processing.
In Unit 3, we will learn how to use actors for parallelism and scale-out using Octokit and data from Github repos!
In Unit 3 you will learn:
- How to perform work asynchronously inside your actors using
- How to use
Askto wait inline for actors to respond to your messages;
- How to use
ReceiveTimeoutto time out replies from other actors;
- How to use
Grouprouters to divide work among your actors;
- How to use
Poolrouters to automatically create and manage pools of actors; and
- How to use HOCON to configure your routers.
How to get started
Here's how Akka.NET bootcamp works!
Use Github to Make Life Easy
This Github repository contains Visual Studio solution files and other assets you will need to complete the bootcamp.
Thus, if you want to follow the bootcamp we recommend doing the following:
- Sign up for Github, if you haven't already.
- Fork this repository and clone your fork to your local machine.
- As you go through the project, keep a web browser tab open to the Akka.NET Bootcamp ReadMe so you can read all of the instructions clearly and easily.
Akka.NET Bootcamp consists of three modules:
- Unit 1 - Beginning Akka.NET
- Unit 2 - Intermediate Akka.NET
- Unit 3 - Advanced Akka.NET
Each module contains the following structure (using Unit 1 as an example:)
src\Unit1\README.MD - table of contents and instructions for the module src\Unit1\DoThis\ - contains the .SLN and project files that you will use through all lessons -- lesson 1 src\Unit1\Lesson1\README.MD - README explaining lesson1 src\Unit1\Lesson1\DoThis\ - C# classes, etc... src\Unit1\Lesson1\Completed\ - "Expected" output after completing lesson -- repeat for all lessons
Start with the first lesson in each unit and follow the links through their README files on Github. We're going to begin with Unit 1, Lesson 1.
Each Akka.NET Bootcamp lesson contains a README which explains the following:
- The Akka.NET concepts and tools you will be applying in the lesson, along with links to any relevant documentation or examples
- Step-by-step instructions on how to modify the .NET project inside the
Unit-[Num]/DoThis/to match the expected output at the end of each lesson.
- If you get stuck following the step-by-step instructions, each lesson contains its own
/Completed/folder that shows the full source code that will produce the expected output. You can compare this against your own code and see what you need to do differently.
When you're doing the lessons...
A few things to bear in mind when you're following the step-by-step instructions:
- Don't just copy and paste the code shown in the lesson's README. You'll retain and learn all of the built-in Akka.NET functions if you type out the code as it's shown.
- You might be required to fill in some blanks during individual lessons. Part of helping you learn Akka.NET involves leaving some parts of the exercise up to you - if you ever feel lost, always check the contents of the
/Completedfolder for that lesson.
- Don't be afraid to ask questions. You can reach the Petabridge team and other Akka.NET users in our Gitter chat here.
We will provide explanations of all key concepts throughout each lesson, but of course, you should bookmark (and feel free to use!) the Akka.NET docs.
Tools / prerequisites
This course expects the following:
- You have some programming experience and familiarity with C#
- A Github account and basic knowledge of Git.
- You are using a version of Visual Studio (it's free now!)
- These lessons are designed to run on Windows only due to the limitation of the WindowsForms framework.
Enough talk, let's go!
Petabridge is a company dedicated to making it easier for .NET developers to build distributed applications.
Copyright 2015-2020 Petabridge, LLC