docs/docs/eventing/samples/writing-receive-adapter-source
Lukas Berk b3f4abf5c2 Writing sources the hard way (#2058)
* First hack at turning 'writing sources the hard way' to markdown

* Add simplified controller

* Add tutorial/example for github.com/knative/sample-source

* Add README.md links

* fix README sample link for new tutorial

* Drop dangling link from 06f51184f7

Commit 06f51184f7 left the
WORKING-GROUPS link, which is causing tests fail. Drop it from readme.

06f51184f7 is the first bad commit
commit 06f51184f7
Author: RichieEscarez <rescarez@google.com>
Date:   Wed May 8 16:04:38 2019 -0700

    remove duplicate files -> all moved to knative/community (#1291)

 contributing/CODE-OF-CONDUCT.md          |  87 -------
 contributing/CONTRIBUTING.md             | 238 ------------------
 contributing/DOCS-CONTRIBUTING.md        | 411 -------------------------------
 contributing/README.md                   | 112 ---------
 contributing/REPOSITORY-GUIDELINES.md    |  77 ------
 contributing/REVIEWING.md                | 112 ---------
 contributing/ROLES.md                    | 320 ------------------------
 contributing/SLACK-GUIDELINES.md         | 144 -----------
 contributing/STEERING-COMMITTEE.md       | 163 ------------
 contributing/TECH-OVERSIGHT-COMMITTEE.md | 103 --------
 contributing/VALUES.md                   |  60 -----
 contributing/WORKING-GROUP-PROCESSES.md  | 203 ---------------
 contributing/WORKING-GROUPS.md           | 216 ----------------
 13 files changed, 2246 deletions(-)
 delete mode 100644 contributing/CODE-OF-CONDUCT.md
 delete mode 100644 contributing/CONTRIBUTING.md
 delete mode 100644 contributing/DOCS-CONTRIBUTING.md
 delete mode 100644 contributing/README.md
 delete mode 100644 contributing/REPOSITORY-GUIDELINES.md
 delete mode 100644 contributing/REVIEWING.md
 delete mode 100644 contributing/ROLES.md
 delete mode 100644 contributing/SLACK-GUIDELINES.md
 delete mode 100644 contributing/STEERING-COMMITTEE.md
 delete mode 100644 contributing/TECH-OVERSIGHT-COMMITTEE.md
 delete mode 100644 contributing/VALUES.md
 delete mode 100644 contributing/WORKING-GROUP-PROCESSES.md
 delete mode 100644 contributing/WORKING-GROUPS.md

* Various review feedback incorporated.

* Add image reference, standardize comment and ellipsis

* Fix link errors

* Add patch for hack/update-codegen.sh

* Change SampleSource (writing-a-source) to Kuberbuilder SampleSource

* Reword Contributor concern
2020-01-13 10:51:03 -08:00
..
01-theory.md Writing sources the hard way (#2058) 2020-01-13 10:51:03 -08:00
02-lifecycle-and-types.md Writing sources the hard way (#2058) 2020-01-13 10:51:03 -08:00
03-controller.md Writing sources the hard way (#2058) 2020-01-13 10:51:03 -08:00
04-reconciler.md Writing sources the hard way (#2058) 2020-01-13 10:51:03 -08:00
05-receive-adapter.md Writing sources the hard way (#2058) 2020-01-13 10:51:03 -08:00
06-yaml.md Writing sources the hard way (#2058) 2020-01-13 10:51:03 -08:00
README.md Writing sources the hard way (#2058) 2020-01-13 10:51:03 -08:00
_index.md Writing sources the hard way (#2058) 2020-01-13 10:51:03 -08:00
simplified-controller.png Writing sources the hard way (#2058) 2020-01-13 10:51:03 -08:00

README.md

This tutorial will walk you though writing a new event source for Knative Eventing using a sample repository and explaining the key concepts used throughout each component.

After completing the tutorial, you'll have a basic event source controller as well as receive adapter, which events can be viewed through a basic event_display Knative Service.

Just want to see the code? The reference project is https://github.com/knative/sample-source.

Target Audience

The target audience is already familiar with Kubernetes and Go development and wants to develope a new event source, importing their custom events via Knative Eventing into the Knative system.

Before You Begin

You'll need these tools installed:

Steps

  1. Separation of Concerns
  2. API Definition
  3. Controller
  4. Reconciler
  5. Receive Adapter
  6. Example YAML