From 2b84d0ec30aba68d76287c8dde05b9369e339a62 Mon Sep 17 00:00:00 2001 From: Leon Mai Date: Mon, 7 Oct 2019 17:03:19 -0700 Subject: [PATCH] Service invocation conceptual doc (#66) * Initial draft * Initial draft * Missed initial changes * Clarification * Review comment - rephrase --- .../service-invocation/service-invocation.md | 18 ++++++++++++++++-- images/service-invocation.png | Bin 0 -> 12461 bytes 2 files changed, 16 insertions(+), 2 deletions(-) create mode 100644 images/service-invocation.png diff --git a/concepts/service-invocation/service-invocation.md b/concepts/service-invocation/service-invocation.md index 808829791..011f8f02f 100644 --- a/concepts/service-invocation/service-invocation.md +++ b/concepts/service-invocation/service-invocation.md @@ -1,3 +1,17 @@ -# documentation +# Service Invocation -Content for this file to be added +Dapr-enabled apps can communicate with each other through well-known endpoints in the form of http or gRPC messages. + +![Service Invocation Diagram](../../images/service-invocation.png) + + +1. Service A makes a http/gRPC call meant for Service B. The call goes to the local Dapr sidecar. +2. Dapr discovers Service B's location and forwards the message to Service B's Dapr sidecar +3. Service B's Dapr sidecar forwards the request to Service B. Service B performs its corresponding business logic. +4. Service B sends a response for Service A. The response goes to Service B's sidecar. +5. Dapr forwards the response to Service A's Dapr sidecar. +6. Service A receives the response. + +For more information, see: +- The [Service Invocation Spec](https://github.com/dapr/spec/blob/master/service_invocation.md) +- A [HowTo]() on Service Invocation \ No newline at end of file diff --git a/images/service-invocation.png b/images/service-invocation.png new file mode 100644 index 0000000000000000000000000000000000000000..f014c5a835377333ae5d5175aad4e6d1ed1666ce GIT binary patch literal 12461 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 S1QYnM1NMja=I#FJxBmkaX8kY# literal 0 HcmV?d00001