https://github.com/trivediayush/fastapi-deploy-pipeline

Production-ready, containerized FastAPI application.
https://github.com/trivediayush/fastapi-deploy-pipeline

aws-ec2 containerized-application docker docker-compose dockerhub fastapi github-actions postman-collection postman-test qa-test rollback terraform

Last synced: about 2 months ago
JSON representation

Production-ready, containerized FastAPI application.

• Host: GitHub
• URL: https://github.com/trivediayush/fastapi-deploy-pipeline
• Owner: trivediayush
• License: mit
• Created: 2025-07-23T09:48:07.000Z (10 months ago)
• Default Branch: master
• Last Pushed: 2025-07-23T09:57:14.000Z (10 months ago)
• Last Synced: 2025-07-23T11:42:21.683Z (10 months ago)
• Topics: aws-ec2, containerized-application, docker, docker-compose, dockerhub, fastapi, github-actions, postman-collection, postman-test, qa-test, rollback, terraform
• Homepage:
• Size: 2.93 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
📦 FastAPI Deploy Pipeline

==========================

**Description:** This project is a production-ready, containerized **FastAPI** application. It is fully automated for continuous integration and deployment using **GitHub Actions**, **Docker**, and **Terraform** on **AWS EC2**. The pipeline integrates automated unit and API testing, failure recovery via rollback scripts, and structured manual QA validation processes.

* * *

🔄 Deployment Workflow

----------------------

1.  Code is committed and pushed to the **GitHub** repository.

2.  **CI/CD pipeline** is triggered via GitHub Actions:

    *   Execute unit and integration tests

    *   Build Docker image

    *   Push image to DockerHub

    *   Provision AWS EC2 resources via **Terraform**

    *   Deploy Docker container to provisioned infrastructure

3.  On deployment failure:

    *   `rollback.sh` is invoked to restore the previous stable version

4.  Post-deployment QA:

    *   Execution of `postman_collection.json`

    *   Validation against `manual_test_cases.md`

* * *

📌 Technology Stack

-------------------

*   **FastAPI** – Asynchronous Python web framework

*   **GitHub Actions** – Continuous integration and delivery (CI/CD)

*   **Docker** – Containerization and deployment standardization

*   **Terraform** – Infrastructure provisioning and management

*   **AWS EC2** – Scalable compute environment

*   **Postman** – API validation and test automation

* * *

✅ Testing and Quality Assurance

-------------------------------

*   `test_main.py` – Automated unit and API tests executed in CI

*   `manual_test_cases.md` – Structured manual QA verification

*   `postman_collection.json` – Postman test suite for endpoint validation

* * *

🔁 Rollback Mechanism

---------------------

Deployment failures are handled through an automated rollback process using `rollback.sh`, restoring the last known stable container state to ensure high availability and system integrity.