Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

doc: add diagram for how JS SDK interacts with Dapr runtime #521

Closed
sicoyle opened this issue Sep 14, 2023 · 4 comments
Closed

doc: add diagram for how JS SDK interacts with Dapr runtime #521

sicoyle opened this issue Sep 14, 2023 · 4 comments
Labels

Comments

@sicoyle
Copy link

sicoyle commented Sep 14, 2023

Describe the proposal

Is your feature request related to a problem? Please describe.
There is no visual representation for how the SDK interacts with the Dapr runtime.

Describe the solution you'd like
It would be nice for community members to have a diagram depicting the interactions with end user applications, the Dapr JS SDK, and the Dapr sidecar close to the codebase, within the README.md file.

The diagram should include:

  • 3 main components: end user application, Dapr JS SDK, Dapr sidecar
  • Initialization: which protocol is the application Dapr client using to establish connection with the Dapr sidecar, HTTP or gRPC? That depends on the SDK and should be depicted visually.
  • API calls that one can use the Dapr client for. For example you can save & retrieve state from state stores, publish and subscribe to events using pub/sub, invoke other services using service invocation, etc. We should represent which APIs the SDK supports.
  • Overall request routing (when app makes API call through Dapr client, then the request is sent to the Dapr sidecar running along the app)

Other ideas that can be included in diagram:

  • Sidecar processing
  • Response handling
  • Middleware and observability
  • Error handling
  • Security

Describe alternatives you've considered
We could technically keep the README.md file as is, but it would be nice to have visuals here for community members understanding of these interactions.

Additional context
https://docs.dapr.io/developing-applications/sdks/

@XavierGeerinck
Copy link
Contributor

We have this: https://docs.dapr.io/developing-applications/sdks/js/ is that what you are looking for?

@sicoyle
Copy link
Author

sicoyle commented Sep 21, 2023

We have this: https://docs.dapr.io/developing-applications/sdks/js/ is that what you are looking for?

Yes, thank you for pointing this out! Maybe we can link in the readme or add this image to the readme directly.
Also, discussing moving something like this to a broader view in the docs because I think this is more of a general diagram.
dapr/docs#3736

@dapr-bot
Copy link
Collaborator

This issue has been automatically marked as stale because it has not had activity in the last 60 days. It will be closed in the next 7 days unless it is tagged (pinned, good first issue, help wanted or triaged/resolved) or other activity occurs. Thank you for your contributions.

@dapr-bot dapr-bot added the stale label Nov 20, 2023
@dapr-bot
Copy link
Collaborator

This issue has been automatically closed because it has not had activity in the last 67 days. If this issue is still valid, please ping a maintainer and ask them to label it as pinned, good first issue, help wanted or triaged/resolved. Thank you for your contributions.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
No open projects
Development

No branches or pull requests

3 participants