search

asyncapi / website

AsyncAPI specification website
https://www.asyncapi.com
Apache License 2.0
491 stars 631 forks source link

Blog post suggestion: AsyncAPI, say hi to TriggerMesh #1267

Closed jmcx closed 1 year ago

jmcx commented 1 year ago

Post title

AsyncAPI, say hi to TriggerMesh

Post description

This tutorial demonstrates how to use AsyncAPI with TriggerMesh. It shows how the two play nicely together because TriggerMesh can ingest, transform, filter, and route events from channels defined in an AsyncAPI definition. This is one of many possible ways to use the two technologies together.

The scenario is based on the perspective of a DevOps engineer that has been provided with an AsyncAPI definition that describes an application (or set of applications) that produce order events over various channels including a Kafka topic, a Google pub/sub topic, and an HTTP service. The engineer's task is to ingest orders from these different channels and route them to a single downstream Kafka topic called unified-orders.

The tutorial leverages the TriggerMesh open-source command-line interface called tmctl to create the TriggerMesh sources, brokers, triggers and targets that make up the event flow. tmctl lets you run these components locally on any laptop that has Docker.

The project includes a prototype parser built with AsyncAPI's js-parser. It parses the provided AsyncAPI definition and generates tmctl CLI commands that create TriggerMesh event sources that will ingest events from the various channels into a TriggerMesh broker for further processing. You could of course write the tmctl commands manually too, but this parser shows how nicely a well-documented AsyncAPI definition can be used alongside TriggerMesh.

The following schema illustrates what we'll build in this tutorial.

full-schema

A solid version is already ready here: https://github.com/triggermesh/tutorials/tree/main/asyncAPI

Are you interesting in me pushing this to a PR for the asyncAPI blog?

Cheers and thanks @jonaslagoni for the feedback during the community meeting this week and @magicmatatjahu for the help with the parse !

github-actions[bot] commented 1 year ago

Welcome to AsyncAPI. Thanks a lot for reporting your first issue. Please check out our contributors guide and the instructions about a basic recommended setup useful for opening a pull request.
Keep in mind there are also other channels you can use to interact with AsyncAPI community. For more details check out this issue.

github-actions[bot] commented 1 year ago

This issue has been automatically marked as stale because it has not had recent activity :sleeping:

It will be closed in 120 days if no further activity occurs. To unstale this issue, add a comment with a detailed explanation.

There can be many reasons why some specific issue has no activity. The most probable cause is lack of time, not lack of interest. AsyncAPI Initiative is a Linux Foundation project not owned by a single for-profit company. It is a community-driven initiative ruled under open governance model.

Let us figure out together how to push this issue forward. Connect with us through one of many communication channels we established here.

Thank you for your patience :heart:

jmcx commented 1 year ago

Done https://www.asyncapi.com/blog/asyncapi-say-hi-to-triggermesh. Thanks all!