From 6ce2c6438588c69e894dda27ee322e057c091bb0 Mon Sep 17 00:00:00 2001 From: Ayush Raj Date: Sat, 21 Nov 2026 08:07:59 +0530 Subject: [PATCH 1/2] docs: clarify three team workstreams and detailed contributions --- README.md | 79 ++++++++++++++++++++++++++++++++++++++++++++++++++----- 1 file changed, 72 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 75e3b40..74e8b42 100644 --- a/README.md +++ b/README.md @@ -593,15 +593,80 @@ Automated production deployment is a **known limitation, not a confirmed healthy ## Team -BSc Computer Science and Data Analytics students, IIT Patna, 5th semester. +**Project:** CloudMonitor — Cloud Infrastructure & Monitoring Platform +**Institution:** Indian Institute of Technology Patna +**Program:** BSc Computer Science and Data Analytics +**Semester:** 5th -| Member | Area | Built (implemented) | AWS deployment role (target) | Optional | -|---|---|---|---|---| -| Sarnendu Das | Custom backend | FastAPI backend and Prometheus metrics; health, status, and simulation endpoints; backend Dockerfile with a non-root user | Backend container on EC2; backend image through ECR; port 8000 security group setup | Scripted ECR image push | -| Ayush Raj | Monitoring and observability | Prometheus configuration and six alert rules; Alertmanager routing and Grafana provisioning; GitHub Actions CI pipeline | Monitoring ports kept private; Grafana via admin IP or SSH tunnel; EC2 bootstrap with Docker Compose | CloudWatch integration | -| Parveen Kumar | Custom frontend | React and Vite dashboard; testing suite with a 10-check pipeline test; failure injection and SRE verification | Frontend container on EC2; public access on ports 80 and 443 through Nginx; post-deploy checks with the test suite | CloudFront in front of the frontend | +CloudMonitor is a collaborative cloud computing project developed by three students across three primary workstreams: backend development and monitoring APIs; frontend development and dashboard; and AWS cloud infrastructure, DevOps and observability. The responsibilities below combine the team's presentation with implementation and deployment details recorded in this README. -The AWS deployment roles are the target scope for each member, and the optional items are extensions that are not part of the current deployment. See [AWS deployment](#aws-deployment) and [Known limitations](#known-limitations) for what is live today. +### 1. Sarnendu Das — Backend Development & Monitoring API + +**Roll Number:** 24a12res592 +**Primary Responsibility:** Custom Backend, API Services & Metric Processing + +**Backend development** +- Developed the FastAPI backend service and REST endpoints connecting the backend to the dashboard. +- Implemented health, status and simulation endpoints for service visibility and monitoring scenarios. +- Exposed Prometheus-compatible metric endpoints. +- Responsible for backend metric ingestion, processing, API integration, and the database/persistence workstream. + +**Containerization and deployment scope** +- Implemented the backend Dockerfile with a non-root container user. +- Assigned AWS deployment work: deploy the backend container on EC2, distribute its image via Amazon ECR and configure port 8000 networking/security-group access. +- **Optional extension:** Scripted or automated ECR image pushes. + +### 2. Parveen Kumar — Frontend Development & Dashboard + +**Roll Number:** 24a12res426 +**Primary Responsibility:** React Dashboard, Visualizations & Frontend Integration + +**Frontend development** +- Developed the monitoring dashboard using React, TypeScript and Vite. +- Built host/container status views, health displays and metric visualizations. +- Worked on frontend ↔ backend REST API integration and user experience. + +**Testing and deployment scope** +- Contributed the documented testing suite, including the 10-check pipeline test, failure-injection testing and SRE verification. +- Assigned AWS deployment work: deploy the frontend container on EC2, serve it publicly using Nginx on ports 80 and 443, and run post-deployment checks with the test suite. +- **Optional extension:** Add Amazon CloudFront in front of the frontend. + +### 3. Ayush Raj — AWS Cloud Infrastructure, DevOps & Observability + +**Roll Number:** 24a12res897 +**Primary Responsibility:** AWS Cloud, Infrastructure Deployment, CI/CD, Containerization & Monitoring + +**AWS cloud and infrastructure** +- Responsible for the AWS EC2 Ubuntu deployment environment, IAM permissions, security groups and infrastructure access/networking. +- Worked on infrastructure preparation, operations and deployment verification. + +**Docker and orchestration** +- Responsible for Docker/Compose deployment integration, service coordination and infrastructure readiness. +- Worked on configuring the containerized environment for the application and monitoring stack. + +**Infrastructure monitoring and observability** +- Responsible for Node Exporter and cAdvisor integration to support host/container telemetry. +- Configured Prometheus monitoring, including the documented six alert rules. +- Implemented Alertmanager routing and Grafana provisioning; worked on monitoring dashboards and operational alert visibility. + +**CI/CD and deployment scope** +- Implemented the documented GitHub Actions CI pipeline and worked on deployment coordination and verification. +- Assigned AWS deployment work: provision/configure EC2, bootstrap Docker Compose, keep monitoring ports private, and restrict Grafana admin access via approved IP or SSH tunnel. +- **Optional extension:** Amazon CloudWatch integration. + +### Team Responsibility Summary + +| Member | Roll number | Primary workstream | Main responsibilities | +|---|---|---|---| +| **Sarnendu Das** | 24a12res592 | Backend & Monitoring API | FastAPI, REST/metrics endpoints, ingestion and processing, health checks, persistence/API integration | +| **Parveen Kumar** | 24a12res426 | Frontend & Dashboard | React/TypeScript, status and metric visualizations, frontend integration, UX and testing | +| **Ayush Raj** | 24a12res897 | AWS Cloud & DevOps | EC2, IAM, security groups, Docker/Compose, Node Exporter, cAdvisor, Prometheus, Grafana, Alertmanager, CI/CD and deployment verification | + +### Implementation and Deployment Scope + +The implementation details above are taken from the project's documented work, while the three primary workstreams reflect the team's presentation. Assigned AWS deployment responsibilities describe each member's target scope and should **not** be read as a claim that every task is live. Optional ECR publishing automation, CloudFront and CloudWatch integrations are extensions, not completed features. + +See [AWS deployment](#aws-deployment) and [Known limitations](#known-limitations) for the documented current deployment status. ## Documentation From c4c846919fa8e1949c42de6d9395a11c37ec0653 Mon Sep 17 00:00:00 2001 From: Ayush Raj Date: Sat, 21 Nov 2026 08:17:52 +0530 Subject: [PATCH 2/2] docs: link team contributors and credit co-authors Co-authored-by: Sarnendu Das Co-authored-by: Parveen Kumar --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 74e8b42..ee83b0c 100644 --- a/README.md +++ b/README.md @@ -600,7 +600,7 @@ Automated production deployment is a **known limitation, not a confirmed healthy CloudMonitor is a collaborative cloud computing project developed by three students across three primary workstreams: backend development and monitoring APIs; frontend development and dashboard; and AWS cloud infrastructure, DevOps and observability. The responsibilities below combine the team's presentation with implementation and deployment details recorded in this README. -### 1. Sarnendu Das — Backend Development & Monitoring API +### 1. Sarnendu Das ([blackpython34](https://github.com/blackpython34)) — Backend Development & Monitoring API **Roll Number:** 24a12res592 **Primary Responsibility:** Custom Backend, API Services & Metric Processing @@ -616,7 +616,7 @@ CloudMonitor is a collaborative cloud computing project developed by three stude - Assigned AWS deployment work: deploy the backend container on EC2, distribute its image via Amazon ECR and configure port 8000 networking/security-group access. - **Optional extension:** Scripted or automated ECR image pushes. -### 2. Parveen Kumar — Frontend Development & Dashboard +### 2. Parveen Kumar ([Parveen-collab](https://github.com/Parveen-collab)) — Frontend Development & Dashboard **Roll Number:** 24a12res426 **Primary Responsibility:** React Dashboard, Visualizations & Frontend Integration