Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
87 changes: 72 additions & 15 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,27 +1,51 @@
# Middleware - Open Source
# Middleware

![Product Demo](media_files/product_demo_1.gif)

**Middleware** is an open-source tool designed to help engineering leaders measure and analyze the effectiveness of their teams using the DORA (DevOps Research and Assessment) metrics. The DORA metrics are a set of four key values that provide insights into software delivery performance and operational efficiency. They are:

- **Deployment Frequency**: The frequency of code deployments to production or an operational environment.
- **Lead Time for Changes**: The time it takes for a commit to make it into production.
- **Mean Time to Restore**: The time it takes to restore service after an incident or failure.
- **Change Failure Rate**: The percentage of deployments that result in failures or require remediation.

# Quick Start

**Table of Contents**
- [Middleware - Open Source](#middleware)
- [Features](#features)
- [Quick Start](#quick-start)
- [Project Setup Guidelines](#project-setup-guidelines)
- [Using Docker](#using-docker)
- [Manual Setup](#manual-setup)
- [Contributing guidelines](#contributing-guidelines)
- [Security guidelines and disclosure](#security-guidelines-and-disclosure)
- [Installation](#installation)
- [Usage](#usage)
- [Examples](#examples)
- [Contributing](#contributing)
- [License](#license)

## Features
- Integration with various CI/CD tools
- Automated collection and analysis of DORA metrics
- Visualization of key performance indicators
- Customizable reports and dashboards
- Integration with popular project management platforms

## Quick Start
Open the terminal and run the following command
```bash
docker run \
--name middleware \
-p 3000:3000 \
-p 9696:9696 \
-p 3000:3333 \
public.ecr.aws/y4x5l0o7/middleware:latest
```

Wait for sometime for the services to be up.\
\
The frontend is available on your host at http://localhost:3005. \
The backend is available on your host at http://localhost:9696.
Wait for sometime for the services to be up.

The App shall be available on your host at http://localhost:3333.

# Project Setup Guidelines
## Project Setup Guidelines
### Using Docker
1. **Clone the Repository**:
```bash
Expand Down Expand Up @@ -80,7 +104,7 @@ The backend is available on your host at http://localhost:9696.
```
```bash
# runs with the ssh tunnel
./dev.sh -i /path/to/private_key -l 5433 -r staging_db.rds.amazonaws.com -p 5432 -u ec2-user -h 10.3.17.192
./dev.sh -i /path/to/private_key -l 5433 -r mhq_db.rds.amazonaws.com -p 5432 -u ec2-user -h 255.96.240.666
```

### Manual Setup
Expand Down Expand Up @@ -113,24 +137,57 @@ To set up middleware locally, follow these steps:
```

5. **Run the Project**:
- For backend:
- For backend analytics server:
```bash
python main.py
python app.py
```
- For backend sync server:
```bash
python sync_app.py
```
- For frontend:
```bash
npm start
```

7. **Access the Application**:
Once the project is running, access the application through your web browser at `http://localhost:8000`.
Once the project is running, access the application through your web browser at http://localhost:8000. Additionally:
* The analytics server is available at http://localhost:5000.
* The sync server can be accessed at http://localhost:6000.


# Contributing guidelines
## Contributing
To get started contributing to middleware check out our [CONTRIBUTING.md](https://github.com/middlewarehq/middleware/blob/main/CONTRIBUTING.md).

We appreciate your contributions and look forward to working together to make Middleware even better!

# Security guidelines and disclosure
## Security guidelines and disclosure
To get started contributing to middleware check out our [SECURITY.md](https://github.com/middlewarehq/middleware/blob/main/SECURITY.md).

We look forward to your part in keeping Middleware secure!

## Usage
- Instructions for using the DORA metrics analyzer
- How to configure data sources and metrics collection
- Generating and interpreting reports
- Tips for optimizing DevOps performance based on insights

## Examples
- Sample reports and dashboards showcasing DORA metrics
- Real-world use cases and success stories
- Screenshots of the analyzer in action

## License
- Information about the project's license (e.g., MIT, Apache 2.0)
- Link to the full license text
- Any additional terms or conditions related to licensing

## License
- Information about the project's license (e.g., MIT, Apache 2.0)
- Link to the full license text
- Any additional terms or conditions related to licensing

![Product Screenshot](link_to_screenshot)



Binary file added media_files/product_demo_1.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.