https://github.com/petabridge/akka.remote.grpc

Akka.Remote gRPC transport
https://github.com/petabridge/akka.remote.grpc

akka-remote

Last synced: 9 days ago
JSON representation

Akka.Remote gRPC transport

• Host: GitHub
• URL: https://github.com/petabridge/akka.remote.grpc
• Owner: petabridge
• License: apache-2.0
• Created: 2022-02-22T03:47:33.000Z (almost 3 years ago)
• Default Branch: master
• Last Pushed: 2024-09-11T19:17:54.000Z (4 months ago)
• Last Synced: 2025-01-11T05:57:38.608Z (9 days ago)
• Topics: akka-remote
• Language: C#
• Homepage:
• Size: 107 KB
• Stars: 0
• Watchers: 2
• Forks: 1
• Open Issues: 9
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Akka.Remote.gRPC

Prototype gRPC transport for [Akka.NET](https://getakka.net/) built on top of ASP.NET gRPC / .NET 6.0.

## Installation

To use this transport:

```

PS> Install-Package Akka.Remote.gRPC

```

### Configuration (HOCON)

Then configure the following in your HOCON for Akka.Remote:

```hocon

akka.remote{

    enabled-transports = ["akka.remote.grpc"]

    

    grpc{

          transport-class = "Akka.Remote.gRPC.GrpcTransport,Akka.Remote.gRPC"

    

          # The default remote server port clients should connect to.

          # Default is 2553 (AKKA), use 0 if you want a random available port

          # This port needs to be unique for each actor system on the same machine.

          port = 2553

    

          # Similar in spirit to "public-hostname" setting, this allows Akka.Remote users

          # to alias the port they're listening on. The socket will actually listen on the

          # "port" setting, but when connecting to other ActorSystems this node will advertise

          # itself as being connected to the "public-port". This is helpful when working with 

          # hosting environments that rely on address translation and port-forwarding, such as Docker.

          #

          # Leave this setting to "0" if you don't intend to use it.

          public-port = 0

    

          # The hostname or ip to bind the remoting to,

          # InetAddress.getLocalHost.getHostAddress is used if empty

          hostname = ""

    

          # If this value is set, this becomes the public address for the actor system on this

          # transport, which might be different than the physical ip address (hostname)

          # this is designed to make it easy to support private / public addressing schemes

          public-hostname = ""

    }

}

```

> **`akka.remote.grpc.hostname` and `akka.remote.grpc.port` should be populated with values specific to your application**, just like `akka.remote.dot-netty.tcp`.

From there you'll be able to address other remote `ActorSystem`s and `IActorRef`s using `akka.grpc://{ActorSystemName}@host:port/`.