Skip to main content

EventBridge Bus

๐Ÿ“ฆ Overviewโ€‹

This Terraform module provisions a custom Amazon EventBridge event bus in a specified AWS region, enabling secure and scalable event routing across services.

It serves as the foundation for building decoupled, event-driven architectures.


โœ… Key Featuresโ€‹

  • Creates a named EventBridge event bus
  • Supports custom event producers and consumers
  • Enables service decoupling through event-based routing
  • Designed for use with AWS services, SaaS platforms, or custom applications

๐Ÿ’ผ Use Casesโ€‹

  • Microservice communication via pub/sub event patterns
  • Cross-account or cross-region event delivery
  • SaaS platform integration and data pipeline triggers
  • Isolated, domain-specific event buses for application boundaries

๐Ÿ“ฅ Input Variablesโ€‹

NameTypeDescription
regionstringAWS region where the event bus should be created
bus_namestringName of the EventBridge bus
environmentstringTag to specify the deployment environment (e.g., prod)

๐Ÿ“ค Outputsโ€‹

NameDescription
eventbridge_bus_arnThe ARN of the created EventBridge event bus
bus_nameThe name of the created event bus
regionThe AWS region where the bus was deployed

๐Ÿš€ Deployment Readinessโ€‹

  • โœ… Compatible with Terraform 1.0+
  • โœ… Tested with AWS provider 5.x
  • ๐Ÿงช Requires IAM permissions to create and manage EventBridge resources

๐Ÿ› ๏ธ Example Usageโ€‹

module "eventbridge_bus" {
source = "git::ssh://git@github.com/archiphire/aws-level-1-modules.git//developer-utilities/eventbridge-bus?ref=v1.0.0"

region = "us-east-1"
bus_name = "my-custom-bus"
environment = "prod"
}
terraform init
terraform plan
terraform apply

or

tofu init
tofu plan
tofu apply

๐Ÿงน Cleanup Optionsโ€‹

For testing:

terraform destroy

or

tofu destroy

For production:

Manually delete the event bus using the AWS Console or CLI if it's connected to rules, targets, or integrations that should remain intact.

๐Ÿ›ก๏ธ Notesโ€‹

This is a Level 1 developer utility module designed to provision an isolated EventBridge event bus. To create a full event-driven system, pair it with additional modules for event rules, targets, and cross-account permissions.

๐Ÿ”’ Deployment Package Noticeโ€‹

This module is part of the Level 1 AWS License Tier. To access the full deployment package and source code, subscribe to Archiphire.