Initial AWS modules setup

Author: bobbyiliev

.github/release-drafter.yml

@@ -0,0 +1,11 @@
+name-template: '$RESOLVED_VERSION'
+tag-template: '$RESOLVED_VERSION'
+template: |
+  ## What's Changed
+  $CHANGES
+
+  ## Contributors
+  $CONTRIBUTORS
+
+  **Full Changelog**: https://github.com/$OWNER/$REPOSITORY/compare/$PREVIOUS_TAG...$RESOLVED_VERSION
+change-template: '- $TITLE by @$AUTHOR in #$NUMBER'

.github/scripts/generate-docs.sh

@@ -0,0 +1,58 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Determine repo root path relative to this script
+REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+
+# Path to terraform-docs config
+TFDOCS_CONFIG="${REPO_ROOT}/.terraform-docs.yml"
+
+# Check terraform-docs is installed
+if ! command -v terraform-docs &> /dev/null; then
+  echo "❌ terraform-docs is not installed. Install it from https://terraform-docs.io/"
+  exit 1
+fi
+
+echo "📘 Generating module documentation using config at: $TFDOCS_CONFIG"
+echo
+
+# Dynamically find all directories that contain a 'modules' subdirectory
+echo "🔍 Discovering module directories..."
+MODULE_DIRS=()
+while IFS= read -r -d '' modules_dir; do
+  MODULE_DIRS+=("$modules_dir")
+done < <(find "$REPO_ROOT" -maxdepth 2 -type d -name "modules" -print0)
+
+if [[ ${#MODULE_DIRS[@]} -eq 0 ]]; then
+  echo "⚠️  No 'modules' directories found in the repository"
+  exit 1
+fi
+
+echo "📁 Found module directories:"
+for dir in "${MODULE_DIRS[@]}"; do
+  echo "   ${dir#$REPO_ROOT/}"
+done
+echo
+
+# Loop through each discovered module directory
+for MODULE_BASE_DIR in "${MODULE_DIRS[@]}"; do
+  echo "🔍 Searching for modules in: ${MODULE_BASE_DIR#$REPO_ROOT/}"
+
+  # Find all modules with variables.tf in this directory
+  MODULES_FOUND=false
+  find "$MODULE_BASE_DIR" -type f -name "variables.tf" | while read -r tf_file; do
+    MODULE_DIR="$(dirname "$tf_file")"
+    echo "📄 Updating docs for module: ${MODULE_DIR#$REPO_ROOT/}"
+    MODULES_FOUND=true
+
+    terraform-docs --config "$TFDOCS_CONFIG" "$MODULE_DIR" > "$MODULE_DIR/README.md"
+  done
+
+  # Check if any modules were found in this directory
+  if ! find "$MODULE_BASE_DIR" -type f -name "variables.tf" -print -quit | grep -q .; then
+    echo "   ℹ️  No modules with variables.tf found in ${MODULE_BASE_DIR#$REPO_ROOT/}"
+  fi
+  echo
+done
+
+echo "✅ Documentation generated for all modules."

.github/workflows/lint.yml

@@ -0,0 +1,48 @@
+name: Lint and Test
+
+on:
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: hashicorp/setup-terraform@v3
+        with:
+          terraform_version: "1.7.0"
+
+      - name: Terraform Format Check
+        run: terraform fmt -check -recursive
+
+      - uses: terraform-linters/setup-tflint@v4
+        with:
+          tflint_version: v0.50.0
+
+      - name: TFLint
+        run: |
+          tflint --init
+          tflint --recursive --format compact
+
+  validate:
+    name: Validate
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: hashicorp/setup-terraform@v3
+        with:
+          terraform_version: "1.7.0"
+
+      - name: Terraform Init
+        run: |
+          cd examples/simple
+          terraform init -backend=false
+
+      - name: Terraform Validate
+        run: |
+          cd examples/simple
+          terraform validate

.github/workflows/release.yaml

@@ -0,0 +1,22 @@
+name: Create Release on Latest Tag Push
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Create Release
+        uses: release-drafter/release-drafter@b1476f6e6eb133afa41ed8589daba6dc69b4d3f5 # v6 release-drafter
+        with:
+          name: ${{ github.ref_name }}
+          tag: ${{ github.ref_name }}
+          publish: true
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -0,0 +1,40 @@
+# Local .terraform directories
+**/.terraform/*
+
+# .tfstate files
+*.tfstate
+*.tfstate.*
+
+# Crash log files
+crash.log
+crash.*.log
+
+# Exclude all .tfvars files, which are likely to contain sensitive data
+*.tfvars
+*.tfvars.json
+
+# Ignore override files as they are usually used for local development
+override.tf
+override.tf.json
+*_override.tf
+*_override.tf.json
+
+# Ignore CLI configuration files
+.terraformrc
+terraform.rc
+
+# Ignore lock files for examples and tests
+examples/*/.terraform.lock.hcl
+tests/.terraform.lock.hcl
+
+# macOS
+.DS_Store
+
+# IDE
+.idea/
+.vscode/
+
+# Local development
+*.env
+.envrc
+*.bak

.terraform-docs.yml

@@ -0,0 +1,12 @@
+formatter: markdown
+
+output-file: README.md
+output-mode: inject
+sections:
+  show-header: true
+  show-inputs: true
+  show-outputs: true
+  show-providers: false
+  show-requirements: false
+  show-resources: false
+  show-data-sources: false

CONTRIBUTING.md

@@ -0,0 +1,87 @@
+# Contributing to materialize-terraform-self-managed
+
+We love your input! We want to make contributing to materialize-terraform-self-managed as easy and transparent as possible, whether it's:
+
+- Reporting a bug
+- Discussing the current state of the code
+- Submitting a fix
+- Proposing new features
+- Becoming a maintainer
+
+## We Develop with Github
+We use GitHub to host code, to track issues and feature requests, as well as accept pull requests.
+
+## Pull Requests
+Pull requests are the best way to propose changes to the codebase. We actively welcome your pull requests:
+
+1. Fork the repo and create your branch from `main`.
+2. If you've added code that should be tested, add tests.
+3. If you've changed APIs, update the documentation.
+4. Ensure the test suite passes.
+5. Make sure your code lints.
+6. Issue that pull request!
+
+
+## Generating Documentation
+
+This module uses [terraform-docs](https://terraform-docs.io/user-guide/introduction/) to generate documentation. To generate the documentation, run the following command from the root of the repository:
+
+```bash
+.github/scripts/generate-docs.sh
+```
+
+## Development Process
+
+1. Clone the repository
+```bash
+git clone https://github.com/MaterializeInc/materialize-terraform-self-managed.git
+```
+
+2. Create a new branch
+```bash
+git checkout -b feature/your-feature-name
+```
+
+3. Make your changes and test them:
+```bash
+# Access the cloud provider directory, eg aws, azure, etc.
+cd aws  # or azure, gcp, etc.
+
+# Format your code
+terraform fmt -recursive
+
+# Run linter
+tflint
+
+# Test the examples
+cd examples/simple
+terraform init
+terraform plan
+```
+
+4. Commit your changes
+```bash
+git commit -m "Add your meaningful commit message"
+```
+
+5. Push to your fork and submit a pull request
+
+## Versioning
+
+We follow [Semantic Versioning](https://semver.org/). For version numbers:
+
+- MAJOR version for incompatible API changes
+- MINOR version for added functionality in a backwards compatible manner
+- PATCH version for backwards compatible bug fixes
+
+## Cutting a new release
+
+Perform a manual test of the latest code on `main`. See prior section. Then run:
+
+    git tag -a vX.Y.Z -m vX.Y.Z
+    git push origin vX.Y.Z
+
+## References
+
+- [Terraform Documentation](https://www.terraform.io/docs)
+- [Materialize Documentation](https://materialize.com/docs)