Added documentation for e2e tests

README.md

@@ -214,6 +214,10 @@ kubectl get pods -n eventing-manager-system
 kubectl get -n kyma-system eventing
 ```
 
+## End-to-End Tests
+
+See [hack/e2e/README.md](hack/e2e/README.md)
+
 ## Contributing
 
 See [CONTRIBUTING.md](CONTRIBUTING.md)

hack/e2e/.env.template

@@ -0,0 +1,4 @@
+KUBECONFIG=
+BACKEND_TYPE=NATS
+MANAGER_IMAGE=
+EVENTMESH_NAMESPACE="/default/sap.kyma/tunas-develop"

hack/e2e/README.md

@@ -0,0 +1,50 @@
+# Eventing End-to-End Tests
+Tests the end-to-end flow for eventing-manager.
+
+## Overview
+
+This test covers the end-to-end flow for Eventing. It is divided in three parts:
+1. `setup` - prepares an Eventing CR and verifies that all the required resources are being provisioned by the eventing-manager.
+2. `eventing` - prepares Subscription CR(s) and tests the end-to-end delivery of events for different event types.
+3. `cleanup` - removes the test resources and namespaces from the cluster.
+
+## Usage
+
+### Pre-requisites
+
+- [Go](https://go.dev/)
+- [kubectl](https://kubernetes.io/docs/tasks/tools/)
+- Access to Kubernetes cluster ([k3d](https://k3d.io/) / k8s)
+- Eventing-manager deployed to the cluster without any Eventing CR.
+- For EventMesh backend, the following secrets should exist in the cluster:
+  - Event Mesh credentials secret by name: `eventing-backend` in namespace: `kyma-system`.
+  - OAuth client secret by name: `eventing-webhook-auth` in namespace: `kyma-system`.
+
+### How to run end-to-end tests
+
+1. Prepare the `.env` file based on the `.env.template`.
+
+```
+KUBECONFIG=                  # Kubernetes cluster kubeconfig file path
+BACKEND_TYPE=NATS            # NATS or EventMesh
+MANAGER_IMAGE=               # [Optional] Container image of eventing-manager
+EVENTMESH_NAMESPACE=         # [Optional] Default is: "/default/sap.kyma/tunas-develop"
+```
+
+2. Run the following command to set up the environment variables in your system:
+```bash
+export $(xargs < .env)
+```
+
+3. Run the following make target to run the whole end-to-end test suite.
+```bash
+make e2e
+```
+
+### Make targets
+
+- `make e2e-setup` - creates an Eventing CR and verifies that all the required resources are being provisioned by the eventing-manager. If an Eventing CR already exists in the cluster, then it will only update the CR if the `spec.backend.type` is different from the backend configured for tests.
+- `make e2e-eventing-setup` - prepares Subscription CR(s) and deploys a subscriber to be used in subscriptions as a sink. It will not update the Subscription CR(s) if they already exists.
+- `make e2e-eventing` - tests the end-to-end delivery of events for different event types.
+- `make e2e-eventing-cleanup` - removes the subscriber and the Subscription CR(s) from the cluster.
+- `make e2e-cleanup` - removes all the test resources and namespaces from the cluster.