Add AWS App Runner deployment configuration - single-container setup with PHP+Nginx, automated deployment scripts, and comprehensive documentation

Author: utkarshsingh77

AWS-APPRUNNER-DEPLOYMENT.md

@@ -0,0 +1,320 @@
+# AWS App Runner Deployment Guide
+
+This guide walks you through deploying your Food Influencer Marketplace to AWS App Runner, the easiest serverless container deployment option on AWS.
+
+## 🚀 Quick Start
+
+1. **Configure your GitHub repository URL** in `deploy-apprunner.sh`
+2. **Update Instagram API credentials** in `apprunner.yaml`
+3. **Run the deployment script**: `./deploy-apprunner.sh`
+
+## 📋 Prerequisites
+
+### AWS Account Setup
+
+- AWS Account with appropriate permissions
+- AWS CLI installed and configured
+- Docker installed locally (for testing)
+
+### GitHub Repository
+
+- Your code pushed to a GitHub repository
+- Repository must be public OR you need to set up GitHub connection in AWS
+
+### Instagram API Setup (Optional)
+
+- Meta Developer Account
+- Instagram App ID and Secret
+- Valid redirect URI configured
+
+## 🔧 Configuration Steps
+
+### 1. Install AWS CLI
+
+**macOS:**
+
+```bash
+brew install awscli
+```
+
+**Linux:**
+
+```bash
+curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
+unzip awscliv2.zip
+sudo ./aws/install
+```
+
+**Windows:**
+Download and install from [AWS CLI installer](https://awscli.amazonaws.com/AWSCLIV2.msi)
+
+### 2. Configure AWS CLI
+
+```bash
+aws configure
+```
+
+You'll need:
+
+- **AWS Access Key ID**
+- **AWS Secret Access Key**
+- **Default region** (recommend: `us-east-1`)
+- **Default output format** (recommend: `json`)
+
+### 3. Update Configuration Files
+
+#### A. Edit `deploy-apprunner.sh`
+
+```bash
+# Set your GitHub repository URL
+GITHUB_REPO_URL="https://github.com/yourusername/ourawork.git"
+```
+
+#### B. Edit `apprunner.yaml`
+
+Update the Instagram API credentials:
+
+```yaml
+- name: INSTAGRAM_APP_ID
+  value: YOUR_ACTUAL_INSTAGRAM_APP_ID
+- name: INSTAGRAM_APP_SECRET
+  value: YOUR_ACTUAL_INSTAGRAM_APP_SECRET
+- name: INSTAGRAM_REDIRECT_URI
+  value: https://YOUR_DOMAIN/instagram_auth.php
+```
+
+### 4. Make Deployment Script Executable
+
+```bash
+chmod +x deploy-apprunner.sh
+```
+
+## 🚀 Deployment Process
+
+### Automated Deployment
+
+Run the deployment script:
+
+```bash
+./deploy-apprunner.sh
+```
+
+The script will:
+
+1. ✅ Check AWS CLI configuration
+2. ✅ Create necessary IAM roles
+3. ✅ Test database connectivity
+4. ✅ Build and test Docker image locally
+5. ✅ Deploy to AWS App Runner
+6. ✅ Show deployment status
+
+### Manual Deployment (Alternative)
+
+If you prefer manual deployment:
+
+1. **Push your code to GitHub**
+2. **Go to AWS App Runner Console**
+3. **Create Service:**
+   - Source: Repository
+   - Connect to GitHub
+   - Select your repository
+   - Branch: main
+   - Configuration: Use configuration file (`apprunner.yaml`)
+
+## 🏗 Architecture Overview
+
+```
+┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
+│   User Browser  │───▶│  AWS App Runner │───▶│   AWS RDS       │
+│                 │    │                 │    │   (MariaDB)     │
+└─────────────────┘    │  - Nginx        │    └─────────────────┘
+                       │  - PHP-FPM      │
+                       │  - Your App     │    ┌─────────────────┐
+                       └─────────────────┘───▶│  Instagram API  │
+                                              └─────────────────┘
+```
+
+## 📊 Cost Estimation
+
+**AWS App Runner:**
+
+- CPU: 0.25 vCPU = ~$5-10/month
+- Memory: 0.5 GB = ~$2-5/month
+- Requests: Pay per million requests (~$0.40/million)
+
+**Existing RDS:** Already configured and running
+
+**Total Estimated Cost:** ~$10-20/month for low to moderate traffic
+
+## 🔍 Monitoring & Management
+
+### Check Service Status
+
+```bash
+aws apprunner list-services --region us-east-1
+```
+
+### View Service Details
+
+```bash
+aws apprunner describe-service --service-arn YOUR_SERVICE_ARN
+```
+
+### View Logs
+
+- Go to AWS App Runner Console
+- Select your service
+- Click on "Logs" tab
+- View Application logs and System logs
+
+### Health Check
+
+Your app includes a health check endpoint at `/health` that returns:
+
+```
+healthy
+```
+
+## 🔒 Security Features
+
+- **HTTPS by default** - App Runner provides SSL/TLS automatically
+- **Security headers** - Configured in nginx
+- **Environment variables** - Sensitive data stored securely
+- **Private networking** - Database access through AWS network
+- **File access restrictions** - Sensitive files blocked
+
+## 🛠 Troubleshooting
+
+### Common Issues
+
+#### 1. Database Connection Failed
+
+```bash
+# Test database connectivity
+docker run --rm php:8.4-cli php -r "
+try {
+    \$pdo = new PDO('mysql:host=ourawork.ckb40aqwiavq.us-east-1.rds.amazonaws.com;dbname=marketplace', 'admin', 'family95');
+    echo 'Connection successful!';
+} catch (Exception \$e) {
+    echo 'Error: ' . \$e->getMessage();
+}
+"
+```
+
+#### 2. Service Build Failed
+
+- Check your Dockerfile syntax
+- Ensure all required files are in the repository
+- Check App Runner logs in AWS Console
+
+#### 3. Health Check Failed
+
+- Verify nginx configuration
+- Check if application starts correctly
+- Review application logs
+
+#### 4. Instagram API Issues
+
+- Verify App ID and Secret are correct
+- Ensure redirect URI matches exactly
+- Check that your domain is properly configured
+
+### Debug Commands
+
+**Check service status:**
+
+```bash
+aws apprunner describe-service --service-arn arn:aws:apprunner:us-east-1:ACCOUNT:service/ourawork-marketplace
+```
+
+**List all services:**
+
+```bash
+aws apprunner list-services
+```
+
+**Check logs:**
+
+- AWS Console > App Runner > Your Service > Logs
+
+## 🔄 Updates & Maintenance
+
+### Automatic Deployments
+
+App Runner automatically redeploys when you push to the main branch of your connected GitHub repository.
+
+### Manual Deployments
+
+```bash
+aws apprunner start-deployment --service-arn YOUR_SERVICE_ARN
+```
+
+### Environment Variable Updates
+
+Update in AWS Console:
+
+1. Go to App Runner service
+2. Click "Configuration" tab
+3. Edit "Environment variables"
+4. Save (triggers automatic redeployment)
+
+## 📈 Scaling
+
+App Runner automatically scales based on traffic:
+
+- **Minimum instances:** 1
+- **Maximum instances:** 25 (configurable)
+- **Concurrent requests per instance:** 100
+
+To modify scaling:
+
+```bash
+aws apprunner update-service --service-arn YOUR_SERVICE_ARN --auto-scaling-configuration-arn YOUR_CONFIG_ARN
+```
+
+## 🔧 Advanced Configuration
+
+### Custom Domain Setup
+
+1. **Add custom domain in App Runner Console**
+2. **Update DNS records** with provided values
+3. **SSL certificate** automatically provisioned
+
+### VPC Configuration
+
+For private database access:
+
+```bash
+aws apprunner create-vpc-connector --vpc-connector-name ourawork-connector
+```
+
+### Environment-Specific Deployments
+
+Create separate services for staging/production:
+
+- `ourawork-marketplace-staging`
+- `ourawork-marketplace-production`
+
+## 📞 Support
+
+If you encounter issues:
+
+1. **Check AWS App Runner documentation**
+2. **Review CloudWatch logs**
+3. **Test locally using Docker**
+4. **Verify database connectivity**
+5. **Check Instagram API configuration**
+
+## 🎯 Next Steps
+
+After successful deployment:
+
+1. **Set up custom domain**
+2. **Configure monitoring/alerts**
+3. **Set up staging environment**
+4. **Configure backup strategies**
+5. **Implement CI/CD pipeline**
+
+---
+
+**🎉 Congratulations!** Your Food Influencer Marketplace is now running on AWS App Runner!