Modules
Modules are reusable "infrastructure building blocks" that describe how to deploy and manage a specific piece of infrastructure, such as a VPC, ECS cluster, or Auto Scaling Group.
Most modules are written in Terraform and define several AWS resources.
Example
Let’s look at an example module. The rds module is a Terraform module that creates an RDS database, the IAM roles needed to operate that database, optional read replicas, database subnet groups, and the relevant security groups.
The module deploys a key element of an overall RDS deployment, but it's not a complete RDS deployment. That's because the rds module does not include backup policies using AWS Backup (for disaster recovery), or RDS Proxy (to pool database connections), or CloudWatch alarms (to alert you when something goes wrong). These missing pieces are best thought of as building block modules themselves. Gruntwork has modules for backup-plan, backup-vault, and rds-proxy that can all be used in combination with the rds module.
To see how Gruntwork gives you an off-the-shelf overall deployment with all the elements included, see Service Modules.
Modules are optimized for control
A module is designed to be small, narrow in scope, and highly reusable, like a building block. Modules give you control, but they may not give you convenience. You can use the building block modules for all kinds of use cases (high control), but if you want to deploy a complete piece of infrastructure, you still have to do the work of assembling the right modules (low convenience).
To learn how you can optimize for convenience, see Service Modules.
To learn more about the overall thought process behind building block modules versus service modules, see Introducing: The Gruntwork Module, Service, and Architecture Catalogs.
When to use a building block module
Building block modules are fairly generic by design, so you won't typically deploy a single building block module directly. Instead, you write code that combines the building block modules you need for a specific use case.
For example, one module might deploy the control plane for Kubernetes and a separate module could deploy worker nodes; you may need to combine both modules together to deploy a Kubernetes cluster.
We recommend our Service Catalog for common use cases, but our full module catalog is available if you have a more complex use case.
Where to find the building block modules
The module catalog features over 250 "building block" modules spanning three major use cases:
- AWS foundations
- Running applications
- Storing data
Each of these use cases covers one or more Subject Matter Expert (SME) topics such as AWS account management, VPC/Networking, EKS, ECS, and RDS. SME topics are a first-class concept within Gruntwork, but do not have much visibility in the product itself at this time.
To browse the module catalog, see the Library Reference and look for "Module Catalog" on the sidebar. You can also visit the list of private Gruntwork GitHub repos.
How modules are updated
Gruntwork brings together AWS and Terraform experts around the world who track updates from AWS, Terraform, and the DevOps community at large, along with requests from the Gruntwork customer community. We translate the most important of these updates into new features, new optimizations, and ultimately new releases.
Refer to Gruntwork releases for a comprehensive listing of all the updates.