cflabs-devops-ai 0.4.7

Automate your devops using AI

cflabs-devops-ai

Deploy Flask apps to AWS Lambda + API Gateway and React apps to AWS Amplify with zero code changes and AI-powered natural language interface.

🚀 Features

• Zero-touch deployment: Your Flask app stays unchanged
• Single command deployment: cflabs-devops-ai serverless deploy (Flask) / cflabs-devops-ai amplify create-app (React)
• AI-powered interface: cflabs-devops-ai chat for natural language commands
• CI/CD ready: Generate GitHub Actions workflows for automated deployment
• AWS Lambda Web Adapter: Runs Gunicorn inside Lambda containers
• AWS Amplify integration: Deploy React apps with branch-specific deployments
• Automatic scaffolding: Generates Dockerfile, SAM template, and Amplify configs
• Simple CLI: Intuitive commands for the full deployment lifecycle
• Image tag control: Specify custom Docker image tags for deployments
• Multi-framework support: React, Next.js, Vue.js, Angular for Amplify

📦 Installation

pip install cflabs-devops-ai

🎯 Quick Start

Flask Apps (AWS Lambda)

Deploy your Flask app to AWS with a single command:

cflabs-devops-ai serverless deploy

That's it! Your Flask app is now running on AWS Lambda + API Gateway.

React Apps (AWS Amplify)

Deploy your React app to AWS Amplify:

# Create Amplify app
cflabs-devops-ai amplify create-app --name my-react-app --repo https://github.com/username/my-react-app

# Configure for React
cflabs-devops-ai amplify configure-app --framework react

# Deploy main branch
cflabs-devops-ai amplify deploy-branch --branch main

AI-Powered Interface

Use natural language to deploy your apps:

# Set your OpenAI API key
export OPENAI_API_KEY="your-api-key-here"

# Start the AI agent
cflabs-devops-ai chat

Then simply type: "deploy this flask app on aws lambda with memory as 1 GB and timeout as 300 seconds" or "deploy this react app to amplify with repository https://github.com/username/my-react-app"

The deploy command automatically:

• Detects your Flask app (app.py)
• Generates all necessary files (Dockerfile, SAM template, etc.)
• Builds and pushes the Docker container
• Deploys to AWS Lambda + API Gateway

📋 Prerequisites

• Python 3.8+
• AWS CLI configured with appropriate permissions
• Docker installed and running
• AWS SAM CLI installed

🔧 CLI Commands

serverless deploy

Deploy Flask app to AWS Lambda + API Gateway (all-in-one command):

cflabs-devops-ai serverless deploy

Options:

• --name, -n: Name for your Lambda function (prompts if not provided)
• --region, -r: AWS region (default: us-east-1)
• --port, -p: Application port (default: 8000)
• --memory: Lambda memory size in MB (default: 512)
• --timeout, -t: Lambda timeout in seconds (default: 30)
• --image-tag, -i: Docker image tag to use for deployment (default: latest)

Examples:

# Deploy with default settings (will prompt for function name)
cflabs-devops-ai serverless deploy

# Deploy with custom name and region
cflabs-devops-ai serverless deploy --name my-awesome-app --region us-west-2

# Deploy with custom configuration
cflabs-devops-ai serverless deploy --name my-app --memory 1024 --timeout 60

# Deploy with specific image tag
cflabs-devops-ai serverless deploy --name my-app --image-tag v1.0.0

# Deploy with commit SHA (like CI/CD)
cflabs-devops-ai serverless deploy --name my-app --image-tag $(git rev-parse --short HEAD)

The deploy command automatically:

• Detects your Flask app (app.py)
• Generates Dockerfile, SAM template, and configuration files
• Creates ECR repository and builds Docker container
• Deploys to AWS Lambda + API Gateway
• Shows real-time progress with progress bars

serverless logs

Stream logs from your deployed function:

cflabs-devops-ai serverless logs

serverless delete

Remove the deployed stack and clean up ECR:

cflabs-devops-ai serverless delete

serverless status

Show deployment status and information:

cflabs-devops-ai serverless status

serverless generate

Generate deployment files (Dockerfile, template.yaml, etc.) without deploying:

cflabs-devops-ai serverless generate

Options:

• --name, -n: Name for your Lambda function (prompts if not provided)
• --region, -r: AWS region (default: us-east-1)
• --port, -p: Application port (default: 8000)
• --memory: Lambda memory size in MB (default: 512)
• --timeout, -t: Lambda timeout in seconds (default: 30)
• --image-tag, -i: Docker image tag to use for deployment (default: latest)
• --config, -c: Path to config file
• --force, -f: Overwrite existing files

Examples:

# Generate files with default settings
cflabs-devops-ai serverless generate

# Generate files with custom name and force overwrite
cflabs-devops-ai serverless generate --name my-app --force

# Generate files for CI/CD (using commit SHA)
cflabs-devops-ai serverless generate --name my-app --image-tag $(git rev-parse --short HEAD)

github-actions create-workflow

Generate GitHub Actions workflow for CI/CD deployment:

cflabs-devops-ai github-actions create-workflow

Options:

• --name, -n: Name for your Lambda function
• --region, -r: AWS region (default: us-east-1)
• --stack-name, -s: Name of the CloudFormation stack
• --ecr-repo: ECR repository name
• --config, -c: Path to config file
• --force, -f: Overwrite existing workflow file

Examples:

# Generate workflow with default settings
cflabs-devops-ai github-actions create-workflow

# Generate workflow with custom options
cflabs-devops-ai github-actions create-workflow --name my-app --region us-west-2 --force

# Generate workflow using existing config
cflabs-devops-ai github-actions create-workflow --config cflabs-config.yaml

The generated workflow will:

• Run tests on every push and pull request
• Build and push Docker image with unique tags
• Deploy to AWS Lambda automatically
• Verify Lambda is using the latest image
• Comment deployment info on pull requests

troubleshoot

Show comprehensive AWS troubleshooting guide:

devops-ai troubleshoot

🤖 AI Agent Module

The AI agent provides an AI-powered interface for natural language DevOps commands.

Quick Start

# Set your OpenAI API key
export OPENAI_API_KEY="your-api-key-here"

# Start the AI agent in interactive mode
cflabs-devops-ai chat

# Test a specific query
cflabs-devops-ai test "deploy this flask app on aws lambda with memory as 1 GB"

Available Commands

chat

Start the AI agent in interactive chat mode:

cflabs-devops-ai chat

Options:

• --api-key, -k: OpenAI API key (optional, can use environment variable)
• --interactive, -i: Run in interactive mode (default: true)

test

Test the AI agent with a specific query:

cflabs-devops-ai test "deploy this flask app on aws lambda with memory as 1 GB"

Options:

• --api-key, -k: OpenAI API key (optional, can use environment variable)

Supported Commands

The AI agent can understand and execute these types of commands:

Flask/Lambda Deployment

• "deploy this flask app on aws lambda with memory as 1 GB and timeout as 300 seconds"
• "create a github actions workflow for my flask app"
• "check the status of my deployment"
• "view logs from my lambda function"
• "delete my deployment"

EventBridge Rules

• "create an eventbridge rule called backup-rule that runs daily at 2am"
• "create an eventbridge rule called backup-rule that runs daily at 9am indian time"
• "list all eventbridge rules"
• "delete the eventbridge rule called backup-rule"
• "update my eventbridge rule to run every 6 hours"

AWS Amplify

• "deploy this react app to amplify with repository https://github.com/username/my-react-app"
• "deploy the main branch to amplify and wait for completion"
• "configure my amplify app for nextjs framework"
• "list all amplify apps"
• "create a feature branch called new-ui for my amplify app"
• "check the status of my amplify app"

Features

• 🧠 Natural Language Processing: Understand complex DevOps requests
• 🤖 AI-Powered Parsing: Uses OpenAI for enhanced command understanding
• ⚡ Direct Execution: Commands are executed immediately after parsing
• 🔄 Interactive Mode: Chat-like interface for continuous interaction
• 🧪 Test Mode: Test queries without execution
• 🌍 Timezone Support: Automatic conversion for Indian timezone (IST)
• 📊 Confidence Scoring: Shows confidence level for parsed commands

🚀 AWS Amplify Module

The Amplify module provides comprehensive CLI tools for deploying React applications (and other frontend frameworks) to AWS Amplify.

Quick Start

# Create Amplify app
cflabs-devops-ai amplify create-app --name my-react-app --repo https://github.com/username/my-react-app

# Configure for React
cflabs-devops-ai amplify configure-app --framework react

# Deploy main branch
cflabs-devops-ai amplify deploy-branch --branch main

Available Commands

App Management

• create-app - Create new Amplify app and connect to GitHub
• list-apps - List all Amplify apps in a region
• delete-app - Delete an Amplify app
• status - Show app status and branches

Branch Management

• create-branch - Create new branch for deployment
• list-branches - List all branches for an app
• delete-branch - Delete a branch
• deploy-branch - Deploy specific branch

Configuration

• configure-app - Configure app with framework-specific settings

Framework Support

• React - Standard React apps with Create React App
• Next.js - Next.js applications with static export
• Vue.js - Vue.js applications
• Angular - Angular applications

Features

• 🌿 Branch-specific deployments with automatic builds
• 🎯 Preview deployments for pull requests
• 🔧 Framework-specific configurations
• 📱 Responsive design support
• 🔒 SSL certificates and custom domain management
• 🔄 CI/CD integration with GitHub Actions
• 📊 Build monitoring and status tracking

For detailed documentation, see devops_ai_amplify/README.md.

📁 Project Structure

After running deploy, your project will have:

your-flask-app/
├── app.py                 # Your existing Flask app (unchanged)
├── requirements.txt       # Python dependencies (auto-generated if missing)
├── Dockerfile            # Generated container config
├── template.yaml         # Generated SAM template
├── .dockerignore         # Docker ignore file (auto-generated if missing)
├── cflabs-config.yaml    # Configuration file
└── .github/
    └── workflows/
        └── deploy.yml    # GitHub Actions workflow (if using CI/CD)

Note: All files except app.py are automatically generated during deployment.

⚙️ Configuration

The cflabs-config.yaml file contains your deployment settings:

app:
  module: app
  object: app
  port: 8000

deployment:
  stack_name: my-flask-app
  region: us-east-1
  memory_size: 512
  timeout: 30
  image_uri: 123456789012.dkr.ecr.us-east-1.amazonaws.com/my-app-repo:latest
  image_tag: latest

container:
  base_image: public.ecr.aws/lambda/python:3.11
  working_dir: /var/task

🏷️ Image Tag Strategies

Manual Deployment

# Use latest tag (default)
devops-ai deploy

# Use specific version
devops-ai deploy --image-tag v1.0.0

# Use commit SHA
devops-ai deploy --image-tag $(git rev-parse --short HEAD)

# Use timestamp
devops-ai deploy --image-tag $(date +%Y%m%d-%H%M%S)

CI/CD Deployment

The GitHub Actions workflow automatically uses:

• Unique tags: ${{ github.sha }} (commit SHA)
• Force updates: --force-upload ensures Lambda updates
• Verification: Confirms Lambda uses the correct image

This ensures:

• Reproducible deployments: Each commit has a unique image
• Rollback capability: Deploy previous versions by tag
• No conflicts: Lambda always updates to the latest image

🔍 How It Works

1. AWS Lambda Web Adapter: Uses the binary at /lambda-adapter to handle HTTP requests
2. Gunicorn: Runs your Flask app with Gunicorn inside the Lambda container
3. Zero Code Changes: Your Flask app runs exactly as it does locally
4. SAM Template: Automatically generated with proper API Gateway integration

🚀 CI/CD with GitHub Actions

Set up automated deployment with GitHub Actions:

1. Generate Workflow

cflabs-devops-ai github-actions create-workflow --name my-flask-app

This creates .github/workflows/deploy.yml with:

• Test job: Runs your tests and coverage
• Deploy job: Builds, pushes, and deploys to AWS Lambda
• Verification: Ensures Lambda uses the latest image
• PR comments: Posts deployment info on pull requests

2. Add AWS Credentials

Add these secrets to your GitHub repository:

• AWS_ACCESS_KEY_ID: Your AWS access key
• AWS_SECRET_ACCESS_KEY: Your AWS secret key

3. Push to Deploy

Every push to main or master will:

1. Run tests
2. Build Docker image with unique tag (${{ github.sha }})
3. Push to ECR
4. Deploy to AWS Lambda
5. Verify deployment

4. Workflow Features

• Unique Image Tags: Uses commit SHA for reproducible deployments
• Force Updates: Ensures Lambda always uses the latest image
• Error Handling: Fails if Lambda doesn't update correctly
• PR Integration: Comments deployment URLs on pull requests
• Test Coverage: Runs tests and uploads coverage reports

🛠️ Development

Local Development

# Clone the repository
git clone https://github.com/cosmicfusionlabs/devops-ai.git
cd devops-ai

# Install in development mode
pip install -e ".[dev]"

# Run tests
pytest

# Format code
black .
isort .

Building for Distribution

# Build the package
python -m build

# Install from local build
pip install dist/cflabs_serverless-*.whl

📄 License

MIT License - see LICENSE file for details.

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests
5. Submit a pull request

🐛 Issues

Found a bug? Please open an issue with:

• Python version
• Operating system
• Steps to reproduce
• Expected vs actual behavior

🔧 Troubleshooting

Common AWS Errors

If you encounter AWS-related errors, try these steps:

1. Run diagnostics:

   devops-ai doctor
   

2. View troubleshooting guide:

   devops-ai troubleshoot
   

3. Check AWS permissions:

   • Ensure your AWS user has the required permissions
   • For testing, attach the AdministratorAccess managed policy
   • Or create a custom policy with minimum required permissions

4. Common solutions:

   • Access Denied: Check IAM permissions
   • No Such Bucket: SAM will create S3 bucket automatically
   • Repository Already Exists: Normal, deployment will continue
   • Image Not Found: Run devops-ai build first
   • Credentials Error: Run aws configure

Getting Help

• Check the troubleshooting guide
• Run cflabs-devops-ai serverless doctor for automated diagnostics
• Review AWS CloudFormation console for stack errors
• Check CloudWatch logs: cflabs-devops-ai serverless logs

📚 Examples

Basic Flask App

# app.py
from flask import Flask, jsonify

app = Flask(__name__)

@app.route('/')
def hello():
    return jsonify({"message": "Hello from Lambda!"})

@app.route('/health')
def health():
    return jsonify({"status": "healthy"})

if __name__ == '__main__':
    app.run(debug=True)