/spec-2

CloudEvents Specification

Primary LanguageShellApache License 2.0Apache-2.0

CloudEvents

CloudEvents logo

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

The lack of a common way of describing events means developers must constantly re-learn how to receive 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.

Enter CloudEvents, a specification for describing event data in a common way. CloudEvents seeks to ease event declaration and delivery across services, platforms and beyond.

CloudEvents is a new effort and has received a surprising amount of industry interest, ranging from major cloud providers to popular SaaS companies. CloudEvents is hosted by the Cloud Native Computing Foundation (CNCF) as a sandbox level project.

CloudEvents Documents

The following specifications are available:

Latest Release Working Draft
CloudEvents v0.1 master
HTTP Transport Binding v0.1 master
JSON Event Format v0.1 master
Web hook - master
NATS Transport Binding - master

There is also the CloudEvents Extension Attributes document.

Included within this repository are some documents that helped guide the working group's design decisions. They include:

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!

Working Group process

The CNCF Serverless WG 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 Serverless WG 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 WG 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&

In Person Meetings

There is a face-to-face meeting planned for June 15, 2018 in San Francisco. Please see the first page of the minutes document for more information.

Meeting Minutes

The minutes from our calls are available here.

Recording from our calls are available here.