mq-broker

cloudposse/mq-broker/aws

Terraform Module HCL AWS

Terraform module for provisioning an AmazonMQ broker

Install

module "mq-broker" {

source = "cloudposse/mq-broker/aws"

version = "3.6.0"

}

⭐ Source on GitHub 📦 Registry page

README

Terraform module to provision AmazonMQ resources on AWS > [!TIP] > #### 👽 Use Atmos with Terraform > Cloud Posse uses atmos to easily orchestrate multiple environments using Terraform. > Works with Github Actions, Atlantis, or Spacelift. > > > Watch demo of using Atmos with Terraform > > Example of running atmos to manage infrastructure from our Quick Start tutorial. > Introduction This module provisions the following resources: - ActiveMQ broker - RabbitMQ broker - Security group rules to allow access to the broker Admin and application users are created and credentials written to SSM if not passed in as variables. Usage For a complete example, see examples/complete. For automated tests of the complete example using bats and Terratest (which tests and deploys the example on AWS), see test

Inputs (50)

Name	Type	Description	Default
subnet_ids	list(string)	List of VPC subnet IDs	required
vpc_id	string	The ID of the VPC to create the broker in	required
mq_application_password	list(string)	Application password	`[]`
ssm_parameters_enabled	bool	Whether to create SSM parameters for MQ users and passwords	`true`
mq_admin_user_ssm_parameter_name	string	SSM parameter name for Admin username	`"mq_admin_username"`
context	any	Single object for setting entire context at once. See description of individual	`{ "additional_tag_map": {}, "attribu`
allowed_security_groups	list(string)	DEPRECATED: Use `allowed_security_group_ids` instead. A list of Security Group I	`[]`
tenant	string	ID element _(Rarely used, not included by default)_. A customer identifier, indi	`null`
environment	string	ID element. Usually used for region e.g. 'uw2', 'us-west-2', OR role 'prod', 'st	`null`
attributes	list(string)	ID element. Additional attributes (e.g. `workers` or `cluster`) to add to `id`,	`[]`
label_key_case	string	Controls the letter case of the `tags` keys (label names) for tags generated by	`null`
descriptor_formats	any	Describe additional descriptors to be output in the `descriptors` output map. Ma	`{}`
use_existing_security_groups	bool	DEPRECATED: Use `create_security_group` instead. Historical description: Set to	`null`
deployment_mode	string	The deployment mode of the broker. Supported: SINGLE_INSTANCE and ACTIVE_STANDBY	`"ACTIVE_STANDBY_MULTI_AZ"`
general_log_enabled	bool	Enables general logging via CloudWatch	`true`
regex_replace_chars	string	Terraform regular expression (regex) string. Characters matching the regex will	`null`
publicly_accessible	bool	Whether to enable connections from applications outside of the VPC that hosts th	`false`
maintenance_time_of_day	string	The maintenance time, in 24-hour format. e.g. 02:00	`"03:00"`
mq_admin_user	list(string)	Admin username	`[]`
maintenance_day_of_week	string	The maintenance day of the week. e.g. MONDAY, TUESDAY, or WEDNESDAY	`"SUNDAY"`
encryption_enabled	bool	Flag to enable/disable Amazon MQ encryption at rest	`true`
delimiter	string	Delimiter to be used between ID elements. Defaults to `-` (hyphen). Set to `""`	`null`
… and 10 more inputs

Outputs (22)

primary_ssl_endpoint — AmazonMQ primary SSL endpoint

primary_amqp_ssl_endpoint — AmazonMQ primary AMQP+SSL endpoint

primary_mqtt_ssl_endpoint — AmazonMQ primary MQTT+SSL endpoint

secondary_ssl_endpoint — AmazonMQ secondary SSL endpoint

broker_arn — AmazonMQ broker ARN

primary_wss_endpoint — AmazonMQ primary WSS endpoint

primary_ip_address — AmazonMQ primary IP address

secondary_amqp_ssl_endpoint — AmazonMQ secondary AMQP+SSL endpoint

secondary_ip_address — AmazonMQ secondary IP address

admin_username — AmazonMQ admin username

application_username — AmazonMQ application username

security_group_id — The ID of the created security group

secondary_stomp_ssl_endpoint — AmazonMQ secondary STOMP+SSL endpoint

broker_id — AmazonMQ broker ID

primary_stomp_ssl_endpoint — AmazonMQ primary STOMP+SSL endpoint

secondary_console_url — AmazonMQ secondary web console URL

application_password — AmazonMQ application password

security_group_arn — The ARN of the created security group

security_group_name — The name of the created security group

secondary_wss_endpoint — AmazonMQ secondary WSS endpoint

secondary_mqtt_ssl_endpoint — AmazonMQ secondary MQTT+SSL endpoint

primary_console_url — AmazonMQ active web console URL

Resources (5)

aws_mq_brokeraws_mq_configurationaws_ssm_parameterrandom_passwordrandom_pet

Details

FrameworkTerraform Module

LanguageHCL

Version3.6.0

Cloud AWS

★ Stars44

Forks62

Total downloads691.7k

Inputs50

Outputs22

Resources5

Examples1

LicenseApache-2.0

Namespacecloudposse

Updated