📖 Adding SNS IntegrationSink example

Signed-off-by: Matthias Wessendorf <mwessend@redhat.com>

Author: matzew

config/nav.yml

@@ -253,6 +253,7 @@ nav:
           - IntegrationSink: 
             - About IntegrationSink: eventing/sinks/integration-sink/README.md
             - AWS S3 Sink: eventing/sinks/integration-sink/aws_s3.md
+            - AWS SNS Sink: eventing/sinks/integration-sink/aws_sns.md
             - AWS SQS Sink: eventing/sinks/integration-sink/aws_sqs.md
             - Generic Logger Sink: eventing/sinks/integration-sink/logger.md
         - Flows:

docs/eventing/sinks/README.md

@@ -133,6 +133,7 @@ The `svc` in `http://event-display.svc.cluster.local` determines that the sink i
 | Name                                                                             | Maintainer | Description                          |
 |----------------------------------------------------------------------------------| -- |--------------------------------------|
 | [Amazon S3 Sink](./integration-sink/aws_s3.md)                                   | Knative  | Send events to AWS S3 bucket                  |
+| [Amazon SNS Sink](./integration-sink/aws_sns.md)                                 | Knative  | Send events to AWS SNS topic                  |
 | [Amazon SQS Sink](./integration-sink/aws_sqs.md)                                 | Knative  | Send events to AWS SQS queue                  |
 | [JobSink](job-sink.md)                                                           | Knative  | Trigger long-running background jobs          |
 | [KafkaSink](kafka-sink.md)                                                       | Knative  | Send events to a Kafka topic                  |

docs/eventing/sinks/integration-sink/README.md

@@ -8,5 +8,6 @@ The `IntegrationSink` is a Knative Eventing custom resource supporting selected
 ## Supported Kamelet sinks
 
 * [AWS S3](./aws_s3.md)
+* [AWS SNS](./aws_sns.md)
 * [AWS SQS](./aws_sqs.md)
 * [Generic logger](./logger.md)

docs/eventing/sinks/integration-sink/aws_sns.md

@@ -0,0 +1,35 @@
+# AWS Simple Notification Service Sink
+
+The `IntegrationSink` supports the Amazon Web Services (AWS) Simple Notification Service (SNS) service, through its `aws.sns` property.
+
+## Amazon credentials
+
+For connecting to AWS the `IntegrationSink` uses Kubernetes `Secret`, present in the namespace of the reSink. The `Secret` can be created like:
+
+    ```bash
+    kubectl -n <namespace> create secret generic my-secret --from-literal=aws.accessKey=<accessKey> --from-literal=aws.secretKey=<secretKey>
+    ```
+
+## AWS SQS Sink Example
+
+Below is an `IntegrationSink` to send data to AWS SNS:
+
+  ```yaml
+  apiVersion: sinks.knative.dev/v1alpha1
+  kind: IntegrationSink
+  metadata:
+    name: integration-sink-aws-sns
+    namespace: knative-samples
+  spec:
+    aws:
+      sns:
+        arn: "my-topic"
+        region: "eu-north-1"
+      auth:
+        secret:
+          ref:
+          name: "my-secret"
+  ```
+Inside of the `aws.sns` object we define the name of the topic (or _arn_) and its region. The credentials for the AWS service are referenced from the `my-secret` Kubernetes `Secret` 
+
+More details about the Apache Camel Kamelet [aws-sns-sink](https://camel.apache.org/camel-kamelets/latest/aws-sns-sink.html).