The documentation you are viewing is for Dapr v1.2 which is an older version of Dapr. For up-to-date documentation, see the latest version.
To setup AWS SNS/SQS for pub/sub, you create a component of type
pubsub.snssqs. See this guide on how to create and apply a pubsub configuration.
apiVersion: dapr.io/v1alpha1 kind: Component metadata: name: snssqs-pubsub namespace: default spec: type: pubsub.snssqs version: v1 metadata: - name: accessKey value: "AKIAIOSFODNN7EXAMPLE" - name: secretKey value: "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY" - name: region value: "us-east-1" - name: sessionToken value: "TOKEN" - name: messageVisibilityTimeout value: 10 - name: messageRetryLimit value: 10 - name: messageWaitTimeSeconds value: 1 - name: messageMaxNumber value: 10
WarningThe above example uses secrets as plain strings. It is recommended to use a secret store for the secrets as described here.
Spec metadata fields
|accessKey||Y||ID of the AWS account with appropriate permissions to SNS and SQS. Can be
|secretKey||Y||Secret for the AWS user. Can be
|region||Y||The AWS region to the instance. See this page for valid regions: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.RegionsAndAvailabilityZones.html. Ensure that SNS and SQS are available in that region.||
|endpoint||N||AWS endpoint for the component to use. Only used for local development. The
|sessionToken||N||AWS session token to use. A session token is only required if you are using temporary security credentials||
|messageVisibilityTimeout||N||Amount of time in seconds that a message is hidden from receive requests after it is sent to a subscriber. Default:
|messageRetryLimit||N||Number of times to resend a message after processing of that message fails before removing that message from the queue. Default:
|messageWaitTimeSeconds||N||amount of time to await receipt of a message before making another request. Default:
|messageMaxNumber||N||maximum number of messages to receive from the queue at a time. Default:
Create an SNS/SQS instance
In order to use localstack with your pubsub binding, you need to provide the
in the component metadata. The
endpoint is unncessary when running against production AWS.
See Authenticating to AWS for information about authentication-related attributes
apiVersion: dapr.io/v1alpha1 kind: Component metadata: name: snssqs-pubsub spec: type: pubsub.snssqs version: v1 metadata: - name: endpoint value: http://localhost:4566 # Use us-east-1 for localstack - name: region value: us-east-1
To run localstack on Kubernetes, you can apply the configuration below. Localstack is then
reachable at the DNS name
(assuming this was applied to the default namespace) and this should be used as the
apiVersion: apps/v1 kind: Deployment metadata: name: localstack namespace: default spec: # using the selector, we will expose the running deployments # this is how Kubernetes knows, that a given service belongs to a deployment selector: matchLabels: app: localstack replicas: 1 template: metadata: labels: app: localstack spec: containers: - name: localstack image: localstack/localstack:latest ports: # Expose the edge endpoint - containerPort: 4566 --- kind: Service apiVersion: v1 metadata: name: localstack labels: app: localstack spec: selector: app: localstack ports: - protocol: TCP port: 4566 targetPort: 4566 type: LoadBalancer
In order to run in AWS, you should create an IAM user with permissions to the SNS and SQS services.
AWS account ID and
AWS account secret and plug them into the
secretKey in the component metadata using Kubernetes secrets and
- Basic schema for a Dapr component
- Pub/Sub building block
- Read this guide for instructions on configuring pub/sub components
- AWS SQS as subscriber to SNS
- AWS SNS API reference
- AWS SQS API reference
- Authenticating to AWS