Initial commit: add .gitignore and README

2026-02-09 21:51:46 -08:00
commit b970b4fc51
52 changed files with 3362 additions and 0 deletions
--- a/terraform/modules/README.md
+++ b/terraform/modules/README.md
@@ -0,0 +1,156 @@
+# Shared Terraform Modules
+
+**Purpose**: Reusable Terraform modules for infrastructure provisioning
+**Last Updated**: 2025-01-27
+
+---
+
+## Overview
+
+This directory contains shared Terraform modules that can be used across all projects to ensure consistency and reduce duplication.
+
+---
+
+## Module Structure
+
+```
+modules/
+├── azure/              # Azure-specific modules
+│   ├── networking/     # Virtual networks, subnets, NSGs
+│   ├── kubernetes/     # AKS clusters
+│   ├── keyvault/       # Key Vault with RBAC
+│   ├── storage/        # Storage accounts
+│   └── monitoring/     # Monitoring resources
+├── kubernetes/         # Kubernetes modules (multi-cloud)
+│   ├── namespace/      # Namespace creation
+│   ├── ingress/        # Ingress configuration
+│   └── service/        # Service configuration
+└── monitoring/          # Monitoring modules
+    ├── prometheus/     # Prometheus deployment
+    ├── grafana/        # Grafana deployment
+    └── loki/           # Loki deployment
+```
+
+---
+
+## Usage
+
+### Example: Using Azure Networking Module
+
+```hcl
+module "networking" {
+  source = "../../modules/azure/networking"
+
+  resource_group_name = "rg-example"
+  location           = "eastus"
+  vnet_name          = "vnet-example"
+  address_space      = ["10.0.0.0/16"]
+
+  subnets = [
+    {
+      name           = "subnet-1"
+      address_prefix = "10.0.1.0/24"
+    }
+  ]
+}
+```
+
+### Example: Using Kubernetes Namespace Module
+
+```hcl
+module "namespace" {
+  source = "../../modules/kubernetes/namespace"
+
+  name        = "example-namespace"
+  labels      = {
+    environment = "production"
+    project     = "example"
+  }
+  annotations = {}
+}
+```
+
+---
+
+## Module Development Guidelines
+
+### 1. Standard Structure
+
+Each module should follow this structure:
+
+```
+module-name/
+├── main.tf          # Main resources
+├── variables.tf    # Input variables
+├── outputs.tf      # Output values
+├── README.md       # Module documentation
+└── versions.tf     # Provider versions
+```
+
+### 2. Documentation
+
+Each module must include:
+- Purpose and use cases
+- Input variables documentation
+- Output values documentation
+- Usage examples
+- Requirements
+
+### 3. Versioning
+
+- Use semantic versioning (v1.0.0, v1.1.0, etc.)
+- Tag releases in git
+- Document breaking changes
+
+---
+
+## Available Modules
+
+### Azure Modules
+
+#### networking
+**Purpose**: Create virtual networks, subnets, and network security groups
+**Status**: 🚧 Planned
+
+#### kubernetes
+**Purpose**: Deploy AKS clusters
+**Status**: 🚧 Planned
+
+#### keyvault
+**Purpose**: Create Key Vault with RBAC
+**Status**: 🚧 Planned
+
+#### storage
+**Purpose**: Create storage accounts and containers
+**Status**: 🚧 Planned
+
+### Kubernetes Modules
+
+#### namespace
+**Purpose**: Create Kubernetes namespaces
+**Status**: 🚧 Planned
+
+#### ingress
+**Purpose**: Configure ingress controllers
+**Status**: 🚧 Planned
+
+### Monitoring Modules
+
+#### prometheus
+**Purpose**: Deploy Prometheus
+**Status**: 🚧 Planned
+
+#### grafana
+**Purpose**: Deploy Grafana
+**Status**: 🚧 Planned
+
+---
+
+## Migration Plan
+
+See [TERRAFORM_MODULES_CONSOLIDATION.md](../../../docs/TERRAFORM_MODULES_CONSOLIDATION.md) for detailed migration plan.
+
+---
+
+**Last Updated**: 2025-01-27
+