Skip to content

Latest commit

 

History

History
57 lines (42 loc) · 2.35 KB

CONTRIBUTING.md

File metadata and controls

57 lines (42 loc) · 2.35 KB
Raw

Contribution guidelines

So you want to hack on Knative Eventing Kafka Broker? Yay! Please refer to Knative's overall contribution guidelines to find out how you can help.

Getting started

  1. Create and checkout a repo fork

Requirements

You need to install:

  • ko - (required)
  • docker - (required)
  • Go - (required)
    • check go <version> for the required Go version used in this project
  • Java (we recommend an openjdk build) - (required)
    • check java.version maven property for the required Java version used in this project
  • protoc
  • protoc-gen-go
    • To install protoc-gen-go run go install google.golang.org/protobuf/cmd/protoc-gen-go@[version]

Note: See protoc and protoc-gen-go current used versions

Requirements signaled as "optional" are not required, but it's highly recommended having them installed. If a specific version of a requirement is not explicitly defined above, any version will work during development.

Checkout your fork

To check out this repository:

  1. Create your own fork of this repository:
  2. Clone it to your machine:
mkdir -p ${GOPATH}/src/knative.dev
cd ${GOPATH}/src/knative.dev
git clone git@github.com:knative/eventing.git # clone eventing repo
git clone git@github.com:${YOUR_GITHUB_USERNAME}/eventing-kafka-broker.git
cd eventing-kafka-broker
git remote add upstream https://github.com/knative-sandbox/eventing-kafka-broker.git
git remote set-url --push upstream no_push

Adding the upstream remote sets you up nicely for regularly syncing your fork.

Once you reach this point you are ready to do a full build and deploy as follows.