README.md

Event Email Service

Overview

This example illustrates how to write a service in NodeJS that listens for Events and sends an automated email to the address in the Event payload.

Prerequisites

• A Docker installation.
• Kyma as the target deployment environment.
• A Namespace to which to deploy the example with the env: "true" label. For more information, read the related documentation.

Installation

Local installation

1. Build the Docker image:

   docker build . -t event-email-service:latest

2. Run the recently built image:

   docker run -p 3000:3000 event-email-service:latest

Cluster installation

1. Export your Namespace as a variable by replacing the {namespace} placeholder in the following command and running it:

   export KYMA_EXAMPLE_NS="{namespace}"

2. Deploy the service:

   kubectl apply -f deployment -n $KYMA_EXAMPLE_NS

3. Expose the service endpoint:

   kubectl port-forward -n $KYMA_EXAMPLE_NS $(kubectl get pod -n $KYMA_EXAMPLE_NS -l example=event-email-service | grep event-email-service | awk '{print $1}') 3000

Test the service

To test the service, simulate an Event using cURL:

curl -H "Content-Type: application/json" -d '{"event":{"customer":{"customerID": "1234", "uid": "[email protected]"}}}' http://localhost:3000/v1/events/register

After sending the Event, you should see a log entry either in your terminal (if running locally) or in the Pod's logs (if running on Kyma) confirming the Event reception.

Cleanup

Clean all deployed example resources from Kyma with the following command:

kubectl delete all -l example=event-email-service -n $KYMA_EXAMPLE_NS