feat: add uvicorn start command and improve config examples

Author: ruckerf22

terraform/.gitignore

@@ -0,0 +1,31 @@
+# Terraform files
+*.tfstate
+*.tfstate.*
+*.tfvars
+!terraform.tfvars.example
+.terraform/
+.terraform.lock.hcl
+
+# Crash log files
+crash.log
+crash.*.log
+
+# Exclude all .tfvars files, which are likely to contain sensitive data
+*.tfvars.json
+
+# Ignore override files as they are usually used to override resources locally and so
+# are not checked in
+override.tf
+override.tf.json
+*_override.tf
+*_override.tf.json
+
+# Include override files you do wish to add to version control using negated pattern
+# !example_override.tf
+
+# Include tfplan files to ignore the plan output of command: terraform plan -out=tfplan
+*tfplan*
+
+# Ignore CLI configuration files
+.terraformrc
+terraform.rc

terraform/deploy.sh

@@ -0,0 +1,77 @@
+#!/bin/bash
+
+# Terraform deployment script for DevColor Backend
+
+echo "🚀 Starting Terraform deployment for DevColor Backend..."
+
+# Check if terraform.tfvars exists
+if [ ! -f "terraform.tfvars" ]; then
+    echo "❌ terraform.tfvars not found!"
+    echo "📝 Please copy terraform.tfvars.example to terraform.tfvars and update with your values:"
+    echo "   cp terraform.tfvars.example terraform.tfvars"
+    echo "   # Then edit terraform.tfvars with your database details"
+    exit 1
+fi
+
+# Initialize Terraform
+echo "🔧 Initializing Terraform..."
+terraform init
+
+if [ $? -ne 0 ]; then
+    echo "❌ Terraform init failed!"
+    exit 1
+fi
+
+# Validate configuration
+echo "✅ Validating Terraform configuration..."
+terraform validate
+
+if [ $? -ne 0 ]; then
+    echo "❌ Terraform validation failed!"
+    exit 1
+fi
+
+# Plan deployment
+echo "📋 Planning Terraform deployment..."
+terraform plan -out=tfplan
+
+if [ $? -ne 0 ]; then
+    echo "❌ Terraform plan failed!"
+    exit 1
+fi
+
+# Ask for confirmation
+echo ""
+echo "🤔 Do you want to apply this plan? (y/N)"
+read -r response
+
+if [[ "$response" =~ ^([yY][eE][sS]|[yY])$ ]]; then
+    echo "🚀 Applying Terraform configuration..."
+    terraform apply tfplan
+    
+    if [ $? -eq 0 ]; then
+        echo ""
+        echo "✅ Deployment completed successfully!"
+        echo ""
+        echo "📊 Important outputs:"
+        echo "ECR Repository URL:"
+        terraform output ecr_repository_url
+        echo ""
+        echo "App Runner Service URL:"
+        terraform output apprunner_service_url
+        echo ""
+        echo "App Runner Service ARN (for GitHub secrets):"
+        terraform output apprunner_service_arn
+        echo ""
+        echo "🔑 Next steps:"
+        echo "1. Add the App Runner Service ARN to your GitHub secrets as 'APPRUNNER_SERVICE_ARN'"
+        echo "2. Push to main branch to trigger deployment"
+    else
+        echo "❌ Terraform apply failed!"
+        exit 1
+    fi
+else
+    echo "❌ Deployment cancelled by user"
+    rm -f tfplan
+    exit 0
+fi

terraform/main.tf

@@ -124,6 +124,7 @@ resource "aws_apprunner_service" "devcolor00_school" {
           DB_PASSWORD = var.db_password
           DB_PORT     = var.db_port
         }
+        start_command = "uvicorn api.main:app --host 0.0.0.0 --port 8000"
       }
       image_identifier      = "${aws_ecr_repository.devcolor00_school.repository_url}:latest"
       image_repository_type = "ECR"

terraform/terraform.tfvars.example

@@ -1,7 +1,7 @@
-# Database configuration
-db_host     = "your-database-host"
-db_user     = "your-database-user"
-db_password = "your-database-password"
+# Database configuration - Update these with your actual database details
+db_host     = "your-mysql-host.com"
+db_user     = "your-db-username"
+db_password = "your-secure-password"
 db_port     = "3306"
 
 # AWS configuration