Skip to content
CloudEvents Specification
Shell Makefile
Branch: master
Clone or download
Pull request Compare This branch is 3 commits behind cloudevents:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
adapters
artwork
community
extensions
share
tools
.gitignore
.travis.yml
CONTRIBUTING.md
GOVERNANCE.md
LICENSE
Makefile
OWNERS
README.md
SDK.md
adapters.md
amqp-protocol-binding.md
avro-format.md
documented-extensions.md
http-protocol-binding.md
http-webhook.md
json-format.md
kafka-protocol-binding.md
mqtt-protocol-binding.md
nats-protocol-binding.md
primer.md
proprietary-specs.md
roadmap.md
source-event-action.png
spec.avsc
spec.json
spec.md

README.md

CloudEvents

CloudEvents logo

Events are everywhere. However, event producers tend to describe events differently.

The lack of a common way of describing events means developers must constantly re-learn how to consume events. This also limits the potential for libraries, tooling and infrastructure to aide the delivery of event data across environments, like SDKs, event routers or tracing systems. The portability and productivity we can achieve from event data is hindered overall.

CloudEvents is a specification for describing event data in common formats to provide interoperability across services, platforms and systems.

CloudEvents has received a large amount of industry interest, ranging from major cloud providers to popular SaaS companies. CloudEvents is hosted by the Cloud Native Computing Foundation (CNCF) and was approved as a Cloud Native sandbox level project on May 15, 2018.

CloudEvents Documents

The following documents are available:

Latest Release Working Draft
Core Specification:
CloudEvents v1.0 master
Optional Specifications:
AMQP Protocol Binding v1.0 master
AVRO Event Format - master
HTTP Protocol Binding v1.0 master
JSON Event Format v1.0 master
Kafka Protocol Binding - master
MQTT Protocol Binding v1.0 master
NATS Protocol Binding v1.0 master
Web hook v1.0 master
Additional Documentation:
CloudEvents Adapters - master
CloudEvents SDK Requirements - master
Documented Extensions - master
Primer v1.0 master
Proprietary Specifications - master

If you are new to CloudEvents, it is recommended that you start by reading the Primer for an overview of the specification's goals and design decisions, and then move on to the core specification.

Since not all event producers generate CloudEvents by default, there is documentation describing the recommended process for adapting some popular events into CloudEvents, see CloudEvents Adapters.

SDKs

In addition to the documentation mentioned above, there are also an SDK proposal and a set of SDKs being developed:

Community

Learn more about the people and organizations who are creating a dynamic cloud native ecosystem by making our systems interoperable with CloudEvents.

  • Contributors: people and organizations who helped us get started or are actively working on the CloudEvents specification.
  • Coming soon: demos & open source -- if you have something to share about your use of CloudEvents, please submit a PR!

Process

The CloudEvents project is working to formalize the specification based on design goals which focus on interoperability between systems which generate and respond to events.

In order to achieve these goals, the project must describe:

  • Common attributes of an event that facilitate interoperability
  • One or more common architectures that are in active use today or planned to be built by its members
  • How events are transported from producer to consumer via at least one protocol
  • Identify and resolve whatever else is needed for interoperability

Communications

The mailing list for e-mail communications:

And a #cloudevents Slack channel under CNCF's Slack workspace.

Meeting Time

See the CNCF public events calendar. This specification is being developed by the CNCF Serverless Working Group. This working group meets every Thursday at 9AM PT (USA Pacific):

Join from PC, Mac, Linux, iOS or Android: https://zoom.us/my/cncfserverlesswg

Or iPhone one-tap :

US: +16465588656,,3361029682#  or +16699006833,,3361029682#

Or Telephone:

Dial:
    US: +1 646 558 8656 (US Toll) or +1 669 900 6833 (US Toll)
    or +1 855 880 1246 (Toll Free) or +1 877 369 0926 (Toll Free)

Meeting ID: 336 102 9682

International numbers available: https://zoom.us/zoomconference?m=QpOqQYfTzY_Gbj9_8jPtsplp1pnVUKDr

NOTE: Please use *6 to mute/un-mute your phone during the call.

World Time Zone Converter: http://www.thetimezoneconverter.com/?t=9:00%20am&tz=San%20Francisco&

Meeting Minutes

The minutes from our calls are available here.

Recording from our calls are available here.

Periodically, the group may have in-person meetings that coincide with a major conference. Please see the meeting minutes for any future plans.

You can’t perform that action at this time.