Apache Pekko Documentation Getting Started Guide
Type to start searching
    apache/incubator-pekko
    apache/incubator-pekko
    • Security Announcements
      • Receiving Security Advisories
      • Reporting Vulnerabilities
      • Security Related Documentation
    • Release Notes
      • 1.0.1
      • 1.0.0
    • Getting Started Guide
      • Introduction to Apache Pekko
      • Why modern systems need a new programming model
      • How the Actor Model Meets the Needs of Modern, Distributed Systems
      • Overview of Apache Pekko libraries and modules
      • Introduction to the Example
      • Part 1: Actor Architecture
      • Part 2: Creating the First Actor
      • Part 3: Working with Device Actors
      • Part 4: Working with Device Groups
      • Part 5: Querying Device Groups
    • General Concepts
      • Terminology, Concepts
      • Actor Systems
      • What is an Actor?
      • Supervision and Monitoring
      • Actor References, Paths and Addresses
      • Location Transparency
      • Apache Pekko and the Java Memory Model
      • Message Delivery Reliability
      • Configuration
      • Default configuration
    • Actors
      • Introduction to Actors
      • Actor lifecycle
      • Interaction Patterns
      • Fault Tolerance
      • Actor discovery
      • Routers
      • Stash
      • Behaviors as finite state machines
      • Coordinated Shutdown
      • Dispatchers
      • Mailboxes
      • Testing
      • Coexistence
      • Style guide
      • Learning Pekko Typed from Classic
    • Cluster
      • Cluster Usage
      • Cluster Specification
      • Cluster Membership Service
      • Phi Accrual Failure Detector
      • Distributed Data
      • Cluster Singleton
      • Cluster Sharding
      • Cluster Sharding concepts
      • Sharded Daemon Process
      • Multi-DC Cluster
      • Distributed Publish Subscribe in Cluster
      • Reliable delivery
      • Serialization
      • Serialization with Jackson
      • Multi JVM Testing
      • Multi Node Testing
      • Artery Remoting
      • Classic Remoting (Deprecated)
      • Split Brain Resolver
      • Coordination
      • Choosing Pekko Cluster
    • Persistence (Event Sourcing)
      • Event Sourcing
      • Replicated Event Sourcing
      • CQRS
      • Style Guide
      • Snapshotting
      • Testing
      • EventSourced behaviors as finite state machines
      • Schema Evolution for Event Sourced Actors
      • Apache Persistence Query
      • Persistence Query for LevelDB
      • Persistence Plugins
      • Persistence - Building a storage backend
      • Replicated Event Sourcing Examples
    • Persistence (Durable State)
      • Durable State
      • Style Guide
      • CQRS
      • Persistence Query
    • Streams
      • Module info
      • Introduction
      • Streams Quickstart Guide
      • Design Principles behind Apache Pekko Streams
      • Basics and working with Flows
      • Working with Graphs
      • Modularity, Composition and Hierarchy
      • Buffers and working with rate
      • Context Propagation
      • Dynamic stream handling
      • Custom stream processing
      • Futures interop
      • Actors interop
      • Reactive Streams Interop
      • Error Handling in Streams
      • Working with streaming IO
      • StreamRefs - Reactive Streams over the network
      • Pipelining and Parallelism
      • Testing streams
      • Substreams
      • Streams Cookbook
      • Configuration
      • Operators
    • Discovery
      • Module info
      • How it works
      • Discovery Method: DNS
      • Discovery Method: Configuration
      • Discovery Method: Aggregate multiple discovery methods
      • Migrating from Pekko Management Discovery (before 1.0.0)
    • Utilities
      • Logging
      • Circuit Breaker
      • Futures patterns
      • Extending Apache Pekko
    • Other Apache Pekko modules
      • Pekko HTTP
      • Pekko gRPC
      • Pekko Connectors
      • Pekko Kafka Connector
      • Pekko Projections
      • Cassandra Plugin for Pekko Persistence
      • JDBC Plugin for Pekko Persistence
      • R2DBC Plugin for Pekko Persistence
      • Apache Pekko Management
    • Package, Deploy and Run
      • Packaging
      • Operating a Cluster
      • Deploying
      • Rolling Updates
    • Project Information
      • Binary Compatibility Rules
      • Scala 3 support
      • Downstream upgrade strategy
      • Modules marked “May Change”
      • IDE Tips
      • Immutability using Lombok
      • Apache Pekko in OSGi
      • Migration Guides
      • Rolling Updates and Versions
      • Issue Tracking
      • Licenses
      • License Report
      • Frequently Asked Questions
      • Books and Videos
      • Example projects
      • Project
    • Pekko Classic
      • Classic Actors
      • Classic Clustering
      • Classic Networking
      • Classic Utilities
    • link Apache Software Foundation
    • link License
    • link Security
    • link Privacy
    • link Events
    • link Donate
    • link Thanks

    Getting Started Guide

    • Introduction to Apache Pekko
      • How to get started
    • Why modern systems need a new programming model
      • The challenge of encapsulation
      • The illusion of shared memory on modern computer architectures
      • The illusion of a call stack
    • How the Actor Model Meets the Needs of Modern, Distributed Systems
      • Usage of message passing avoids locking and blocking
      • Actors handle error situations gracefully
    • Overview of Apache Pekko libraries and modules
      • Actor library
      • Remoting
      • Cluster
      • Cluster Sharding
      • Cluster Singleton
      • Persistence
      • Projections
      • Distributed Data
      • Streams
      • Pekko Connectors
      • HTTP
      • gRPC
      • Example of module use
    • Introduction to the Example
      • Prerequisites
      • IoT example use case
      • What you will learn in this tutorial
    • Part 1: Actor Architecture
      • Dependency
      • Introduction
      • The Pekko actor hierarchy
      • Summary
    • Part 2: Creating the First Actor
      • Introduction
      • What’s next?
    • Part 3: Working with Device Actors
      • Introduction
      • Identifying messages for devices
      • Adding flexibility to device messages
      • Implementing the device actor and its read protocol
      • Testing the actor
      • Adding a write protocol
      • Actor with read and write messages
      • What’s Next?
    • Part 4: Working with Device Groups
      • Introduction
      • Device manager hierarchy
      • The Registration Protocol
      • Adding registration support to device group actors
      • Creating device manager actors
      • What’s next?
    • Part 5: Querying Device Groups
      • Introduction
      • Dealing with possible scenarios
      • Implementing the query
      • Adding query capability to the group
      • Summary
      • What’s Next?
    Edit this page
    1.0.1
    Previous Release Notes
    Next Introduction to Apache Pekko
    Apache Incubator logo

    Apache Pekko is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF.

    Copyright © 2011-2022 Lightbend, Inc. Apache Pekko, Pekko, and its feather logo are trademarks of The Apache Software Foundation.