Google Cloud Pub/Sub + AsyncAPI

I’ve been covering different aspects of AsyncAPI in my recent blog posts. In this final post of my AsyncAPI blog post series, I want to talk about how to document Google Cloud’s Pub/Sub using AsyncAPI. AsyncAPI has pretty good support for Google Pub/Sub, thanks to contributions from Jeremy Whitlock, an engineer from Google, and the flexibility baked in AsyncAPI spec. Jeremy also has a nice blog post on this topic that you can read for more details. Read More →

CloudEvents + AsyncAPI

I’ve been recently talking about CloudEvents and AsyncAPI,two of my favorite open-source specifications for event-driven architectures. In this blog post, I want to talk about how you can use CloudEvents and AsyncAPI together. More specifically, I’ll show you how to document CloudEvents enabled services using AsyncAPI, thanks to the flexibility and openness of both projects. Recap: CloudEvents and AsyncAPI Let’s first do a quick recap CloudEvents and AsyncAPI. CloudEvents is an open-source specification for describing event data in a common way with the goal of increasing interoperability between different event systems. Read More →

Understanding AsyncAPI's publish & subscribe semantics with an example

In AsyncAPI, a channel can have a publish and subscribe operation. This can be confusing, depending on which perspective you’re considering (server vs. user) and what you’re comparing against (eg. WebSocket). In this blog post, I want to go through an example to show you how to construct your AsyncAPI file with the right publish and subscribe semantics. As a bonus, I also show you how to refactor your AsyncAPI files with common configuration. Read More →

AsyncAPI Tools

In my previous post, I talked about basic of AsyncAPI. In this post, I want to get into more details on some tools around AsyncAPI. More specially, we’ll install AsyncAPI CLI and Generator, generate a sample AsyncAPI definition, visualize it in AsyncAPI Studio, and generate code from it. You’ll see how useful AsyncAPI can be in documenting and maintaining your event-driven architectures. Install AsyncAPI tools First, let’s install some of the AsyncAPI tools. Read More →

AsyncAPI Basics

Recently, I’ve been looking into AsyncAPI, an open-source specification and tools to document and maintain event-driven architectures (EDAs). In this blog post, I want summarize the basics of AsyncAPI and point to some useful links to learn more. In future blog posts, I’ll get into more details of AsyncAPI. AsyncAPI: Why? What? AsyncAPI is an open source initiative with the goal of making event-driven APIs as easy as REST APIs. Fundamentally, it is a specification to define asynchronous APIs, similar to what OpenAPI (aka Swagger) does for REST APIs. Read More →

CloudEvents Basics

I talked about CloudEvents in the context of event-driven architectures before. In this post, let’s explore CloudEvents in more depth. CloudEvents: Why? What? CloudEvents is a popular specification for describing event data in a common way with the goal of increasing interoperability between different event systems. Google Cloud’s Eventarc, open-source Knative, Azure’s Event Grid, and many more projects rely on CloudEvent specification to define their event formats. CloudEvents, at its core, defines a set of metadata, called “context attributes”. Read More →