I'm confused about ‘EndpointOptions’

[paxhujing]

Since SiloListeningEndpoint and GatewayListeningEndpoint are provided, why are AdvertisedIPAddress, SiloPort, and GatewayPort also offered? I'm confused about the differences between them.

[rkargMsft]

The Listening endpoints are what the local process is listening on. If there are multiple IP addresses on the machine, then it would be one of those or all of those that it's locally listening on.

Advertised address/port is what an outside client would contact which could be different from listening endpoint. For example, if the workload is running in Docker then it will listen on some IP:Port in the container, but an outside client will actually call to the hosting machine on some port that then gets mapped into the container. The port inside the container and on the host may be different, such as if there are multiple containers on the same host which all can't map to 11111/30000 on the host.

+-------------------------------------------------------------+
|                         Host Machine                        |
|                                                             |
|  +-----------------------------------------------+          |
|  |                 Docker Container              |          |
|  |                                               |          |
|  |  Orleans Silo Process                         |          |
|  |                                               |          |
|  |  Listening Endpoints:                         |          |
|  |    - SiloListeningEndpoint: 0.0.0.0:11111     |          |
|  |    - GatewayListeningEndpoint: 0.0.0.0:30000  |          |
|  |                                               |          |
|  +-----------------------------------------------+          |
|                                                             |
|  Port Mappings:                                             |
|    - Host Port 11112 --> Container Port 11111               |
|    - Host Port 30001 --> Container Port 30000               |
|                                                             |
+-------------------------------------------------------------+

External Client
     |
     |  Connects to: Host_IP:30001
     v
Host Machine (Port 30001)
     |
     |  Port Forwarding to Container's GatewayListeningEndpoint
     v
Docker Container (0.0.0.0:30000)
     |
     |  Orleans Silo processes the request
     v
Orleans Silo Process

[paxhujing]

Does this mean the advertised address/port acts as a proxy?