🚀 NaN Labs Terraform Modules

Deploy Production Infrastructure in Minutes, Not Months

🔥 Battle-tested • 🔒 Security-first • 💰 Cost-optimized • 🚀 Developer-friendly

From MVP to Enterprise: Infrastructure that scales with your business

---

🎯 How to Use This Repository

📚 As Reference	🏗️ As Template	🧩 Direct Usage
Study our best practices and patterns for your IaC projects	Fork and customize as starting point for your terraform-modules repository	Import modules directly into your Terraform projects
Perfect for learning and inspiration	Ideal for teams building their own module library	Ready-to-use modules for immediate deployment

---

✨ What Makes Our Modules Special?

🏆 Enterprise-Ready	🔒 Security First	💰 Cost Optimized	📊 Observability	🚀 Developer Experience
Zero-downtime deployments	Encryption by default	Intelligent scaling	Comprehensive logging	One-command deploy
Production-tested patterns	Zero-trust networking	Resource optimization	Monitoring dashboards	Extensive examples
High availability design	Compliance ready	Budget-friendly defaults	Alerting ready	Clear documentation

🎯 Why Choose These Modules?

• ⚡ Faster Time-to-Market: Deploy in minutes what used to take weeks
• 🛡️ Battle-Tested Reliability: Used in production by dozens of companies
• 💡 Best Practices Built-In: Security, performance, and cost optimization from day one
• 🔧 Highly Configurable: From simple setups to complex enterprise requirements
• 📚 Comprehensive Documentation: Every module includes examples and detailed guides
• 🤝 Community Driven: Open source with active maintenance and support

---

🎪 Quick Start Examples

Choose your adventure:

🌐 Simple Web App (~$46/month)

Perfect for MVPs and small applications

cd examples/simple-web-app
terraform init && terraform apply

⚙️ Medium Complexity (~$300/month)

Microservices with EKS + RDS + Monitoring

cd examples/medium-complexity-infrastructure
terraform init && terraform apply

🏢 Complete Enterprise (~$940/month)

Full-scale infrastructure with everything included

cd examples/complete-enterprise-setup
terraform init && terraform apply

💡 New here? Check our 📚 Usage Guide or jump to 🎪 Examples • 📦 All Modules

🎯 Motivation

Building and maintaining infrastructure across cloud providers can become repetitive and error-prone. This repository consolidates reusable Terraform modules following best practices, allowing your team to provision infrastructure efficiently, securely, and consistently—whether it's an AWS VPC, a Kubernetes cluster, or a MongoDB Atlas database.

📦 Available Modules

AWS Infrastructure Modules

Module	Description	Use Cases
🌐 AWS VPC	Virtual Private Cloud with best practices	Network foundation, multi-AZ setup
⚡ AWS EKS	Managed Kubernetes with essential addons	Microservices, container orchestration
🗄️ AWS RDS	Relational database with monitoring	Application databases, data persistence
🗄️ AWS RDS Aurora	High-performance Aurora cluster	High-availability databases, read replicas
📨 AWS MSK	Managed Apache Kafka streaming	Event streaming, data pipelines
🏰 AWS Bastion	Secure jump host with SSM	Secure access, troubleshooting
📊 AWS DocumentDB	MongoDB-compatible database	Document storage, NoSQL applications
👤 AWS IAM Role	IAM roles with best practices	Service permissions, access control
🌍 AWS Amplify App	Frontend hosting and CI/CD	Static sites, SPAs, JAMstack

Other Cloud Providers

Module	Description	Use Cases
🍃 MongoDB Atlas Cluster	Managed MongoDB in the cloud	Global databases, serverless apps

🚀 Quick Module Usage

Each module is designed to be plug-and-play with sensible defaults, yet highly customizable for complex requirements.

module "vpc" {
  source = "git::https://github.com/nanlabs/terraform-modules.git//modules/aws-vpc?ref=v0.2.0"

  vpc_cidr = "10.0.0.0/16"
  # That's it! VPC with best practices is ready 🎉
}

📖 Need more details? Check our complete usage guide with advanced patterns and best practices.

---

🎯 Ready to Get Started?

🚀 Quick Start	📚 Learn More	🤝 Get Help
Browse Examples	Read Documentation	Join Discussions
Pick an example that fits your needs	Understand best practices	Ask questions, share ideas

⭐ If this project helps you, please consider giving it a star! ⭐

---

🤝 Contributing

We love contributions! Whether you're:

• 🐛 Reporting bugs or suggesting improvements
• 📝 Improving documentation or adding examples
• 🚀 Adding new modules or enhancing existing ones
• 💡 Sharing ideas for new features

Every contribution matters! Check our Contributing Guidelines to get started.

🌟 Ways to Contribute

1. Star this repo - It helps others discover these modules
2. Share your experience - Write a blog post or tweet about your usage
3. Submit feedback - Open issues with suggestions or bug reports
4. Code contributions - Submit PRs for new features or fixes
5. Documentation - Help improve guides and examples

📚 Documentation

📖 Guide	🎯 Purpose
📚 Usage Guide	Complete module usage, versioning, and advanced patterns
🛠️ Development Setup	Set up your development environment
📦 Modules Guide	How to use and create modules
⭐ Best Practices	Module design, security, and guidelines
🚀 Versioning Strategy	Release management and versioning
🔄 GitHub Actions	CI/CD workflows and automation
🤝 Contributing	How to contribute to this repository

📚 Additional Resources

• 🚀 Awesome NAN - Best practices and resources
• 📖 Terraform Documentation - Official Terraform docs
• ☁️ AWS Provider Documentation - AWS provider reference
• 💬 NaN Labs Blog - Technical articles and insights

License

This project is licensed under the MIT License - see the LICENSE file for details.

👥 Contributors

Made with contributors-img.

---

🌟 Built with ❤️ by NaN Labs

🚀 Accelerating development through proven technology solutions