CloudEvents 형식 - HTTP 프로토콜 바인딩

CloudEvents(cloudevents.io)는 이벤트 데이터를 일반적인 방식으로 설명할 수 있는 사양입니다. 이 사양은 CNCF(Cloud Native Computing Foundation)에 속하며 CNCF의 서버리스 작업 그룹별로 구성됩니다.

Eventarc는 HTTP 요청을 통해 CloudEvents 형식으로 이벤트 수신자에 이벤트를 전달합니다.

HTTP 요청 헤더

타겟 서비스는 이벤트 라우터의 이벤트를 CloudEvents 버전 1.0 HTTP 프로토콜 바인딩 사양으로 형식이 지정된 HTTP POST 요청으로 수신합니다. 각 HTTP 요청에는 이벤트별 헤더와 본문이 포함되며 이러한 요청은 서비스의 기준 URL 경로(/)로 전송됩니다.

다른 HTTP 헤더 외에도 모든 이벤트에 다음과 같은 CloudEvents HTTP 헤더가 포함됩니다.

HTTP 페이로드 형식

ce-specversion: 1.0
ce-type: google.cloud.audit.log.v1.written
ce-source: //SERVICE_NAME/projects/PROJECT_ID
ce-id: MESSAGE_ID
ce-time: PUBLISH_TIME
Content-Type: application/json; charset=utf-8
Content-Length: CONTENT_LENGTH

ce-specversion: 1.0
ce-type: google.cloud.pubsub.topic.v1.messagePublished
ce-source: //pubsub.googleapis.com/TOPIC
ce-id: MESSAGE_ID
ce-time: PUBLISH_TIME
Content-Type: application/json; charset=utf-8
Content-Length: CONTENT_LENGTH

오픈소스 저장소

모든 이벤트의 HTTP 본문 구조는 CloudEvents GitHub 저장소에서 제공합니다.

이 저장소에는 다음과 같은 항목이 포함되어 있어 프로그래밍 언어로 CloudEvents 데이터를 이해하고 사용하는 데 도움이 됩니다.

• CloudEvents 데이터 페이로드용 Google 프로토콜 버퍼
• 생성된 JSON 스키마
• 공개 JSON 스키마 카탈로그

클라이언트 라이브러리 링크도 포함됩니다.

일반 이벤트

프로토콜 버퍼(또는 protobuf)는 Eventarc에서 생성되는 이벤트 내의 데이터를 나타냅니다. CloudEvents의 프로토콜 버퍼는 머신 판독 가능 스키마로 제공되며, 데이터 유형의 라이브러리를 생성하고 이벤트를 더 쉽게 소비할 수 있게 해줍니다.

모든 특정 CloudEvent 유형에는 2개의 protobuf 메시지가 관련되어 있습니다.

• 하나는 확장 속성을 포함하여 전체 CloudEvent를 나타내는 봉투 메시지입니다(예: AuditLogWrittenEvent).
• data 메시지입니다(예: LogEntryData 또는 StorageObjectData).

다음 표에서는 일부 일반 이벤트의 구성요소를 자세히 설명합니다.

다음 단계

이벤트 경로에 대해 자세히 알아보기