AWS Cloud Operations Toolkit

Project Overview

This project demonstrates how Python can be used to automate common AWS cloud operations tasks.

Using the AWS SDK for Python (Boto3), the toolkit connects to AWS, retrieves account information, inventories cloud resources, and generates operational reports.

The goal was not simply to learn Python syntax, but to apply programming fundamentals to real-world cloud engineering problems.

---

Business Scenario

Cloud engineers and system administrators often need visibility into their AWS environments.

Questions such as:

• Which AWS account am I connected to?
• Which IAM identity is currently authenticated?
• How many S3 buckets exist?
• When were those buckets created?
• How many EC2 instances are running?

are common operational requirements.

Rather than manually gathering this information through the AWS Console, this toolkit automates the process and generates a structured report.

---

Solution Components

Account Discovery

Retrieves:

• AWS Account ID
• IAM User / Role ARN

Using:

• AWS Security Token Service (STS)

---

S3 Inventory

Retrieves:

• Bucket Names
• Bucket Creation Dates

Using:

• Amazon S3 API

---

EC2 Inventory

Retrieves:

• Instance Count
• Instance Details
• Instance State Information

Using:

• Amazon EC2 API

---

Report Generation

Creates:

• Human-readable console output
• Persistent text-based reports

Output Location:

reports/cloud_report.txt

---

Technologies Used

• Python
• Boto3
• AWS STS
• Amazon S3
• Amazon EC2
• VS Code
• PowerShell

---

Example Report

AWS CLOUD ENVIRONMENT REPORT

AWS Account: 735707987320
IAM Identity: arn:aws:iam::735707987320:user/ismail_admin

S3 Buckets: 5

Bucket Inventory:
- ismail-portfolio-site-2026
- iar-my-terraform-state
...

EC2 Instances: 0

---

First-Principles Engineering Approach

My initial instinct was to focus on Python syntax:

• Variables
• Lists
• Dictionaries
• Loops
• Functions

While these concepts are important, they are not the actual goal.

The real objective was to solve a cloud operations problem.

Instead of asking:

"How do I learn Python?"

I learned to ask:

"What operational capability am I trying to create?"

Once I focused on the problem, the programming concepts became tools rather than objectives.

This shift from learning syntax to building systems mirrors the same first-principles approach I used in previous Terraform and DevOps projects.

---

---

Architecture

---

Screenshots

VS Code Project Structure

Successful Report Execution

Generated Report File

---

Future Enhancements

Planned improvements include:

• Multi-region EC2 discovery
• Resource tagging analysis
• CSV report generation
• Cost visibility reporting
• CloudWatch integration
• Automated scheduled reporting

---

Author

Ismail Abdur-Rahman

Cloud Engineer Academy Portfolio Project