basic

Basic REST Delivery Configuration Example

Configuration in this directory creates a REST delivery point and child objects on the PubSub+ event broker, with minimum configuration, leveraging the REST Delivery Terraform module.

Module Configuration in the Example

Required Inputs

• msg_vpn_name - Set to default in the example.
• rest_delivery_point_name
• url - Set to https://example.com/test in the example. Note that it includes the endpoint path.
• queue_name - Set to rdp_queue, the queue that has been created to be used with the RDP.

Important: The REST delivery point must have permission to consume messages from the queue — to achieve this, the queue’s owner must be set to #rdp/<rest_delivery_point_name> or the queue’s permissions for non-owner clients must be set to at least consume level access. Queue ingress and egress must also be enabled.

Optional Inputs

Optional module input variables have the same name as the attributes of the underlying provider resource. If omitted, then the default for the related resource attribute will be configured on the broker. For a list of attributes and the corresponding defaults, see the documentation of "solacebroker_msg_vpn_rest_delivery_point_rest_consumer".

The module default for the enabled variable is true, which enables both the RDP and the REST consumer resources.

Output

The module rdp, consumer and queue_binding outputs refer to the created REST delivery point, REST consumer and queue binding.

Created Resources

This example will create the following resources:

• solacebroker_msg_vpn_queue (created before the module, as pre-requisite)
  
  
• solacebroker_msg_vpn_rest_delivery_point
• solacebroker_msg_vpn_rest_delivery_point_rest_consumer
• solacebroker_msg_vpn_rest_delivery_point_queue_binding

Running the Example

Access to a PubSub+ Event Broker

If you don't already have access to a broker, see the Developers page for options to get started.

Sample Source Code

The sample is available from the module GitHub repo:

git clone https://github.com/SolaceProducts/terraform-solacebroker-rest-delivery.git
cd examples/basic

Adjust the Provider Configuration

Adjust the provider parameters in main.tf according to your broker. The example configuration shows settings for a local broker running in Docker.

Create the Resource

Tip: You can verify configuration changes on the broker, before and after, using the PubSub+ Broker Manager Web UI.

Execute from this folder:

terraform init
terraform plan
terraform apply

Run terraform destroy to clean up the created resources when they are no longer needed.

Additional Documentation

For more information, see Managing REST Delivery Points section in the PubSub+ documentation.