Skip to content

Commit a4ae755

Browse files
committed
add readme file
1 parent f5f2129 commit a4ae755

4 files changed

Lines changed: 54 additions & 5 deletions

File tree

.env.example

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,6 @@
11
FLASK_APP_SECRET=
2+
FLASK_APP_SALT=
3+
JWT_SALT=
24
FLASK_APP=server.py
3-
FLASK_ENV=
5+
FLASK_ENV=development
6+
PRODUCT_BASE_URL=

.github/workflows/prod.yml

Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -6,9 +6,6 @@ on:
66
types:
77
- released
88
- prereleased
9-
push:
10-
branches:
11-
- deploy/gcp
129

1310
jobs:
1411
build:
@@ -22,7 +19,7 @@ jobs:
2219
- name: Checkout
2320
uses: actions/checkout@v4
2421
with:
25-
ref: deploy/gcp # Reference branch
22+
ref: master # Reference branch
2623

2724
- name: Install (Buildx)
2825
uses: docker/setup-buildx-action@v3

.github/workflows/staging.yml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,7 @@ on:
55
push:
66
branches:
77
- master
8+
- deploy/gcp
89

910
workflow_dispatch:
1011

ReadMe.md

Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
# Crane Cloud Monitoring API
2+
3+
[![Prod](https://github.com/crane-cloud/monitoring-api/actions/workflows/prod.yml/badge.svg)](https://github.com/crane-cloud/monitoring-api/actions/workflows/prod.yml)
4+
5+
The Crane Cloud Monitoring API provides a backend service for monitoring resource usage (CPU, memory, network) within a Kubernetes environment. It interfaces with Prometheus to fetch and aggregate metrics data.
6+
7+
## Features
8+
9+
- RESTful API endpoints to fetch metrics for projects and applications.
10+
- Integration with Prometheus for metrics collection.
11+
- Docker containerization for easy deployment and scaling.
12+
- Helm charts for Kubernetes deployments.
13+
14+
## Prerequisites
15+
16+
- Docker and Docker Compose
17+
- Python 3.10
18+
- Helm 3 for Kubernetes deployment
19+
- Access to a Kubernetes cluster (for staging/production environments)
20+
21+
## Local Development Setup
22+
23+
1. **Clone the repository:**
24+
25+
```bash
26+
git clone https://github.com/crane-cloud/monitoring-api.git
27+
cd monitoring-api
28+
```
29+
30+
2. **Environment Variables:**
31+
32+
Copy the `.env.example` to `.env` and modify the environment variables according to your local setup.
33+
34+
3. **Start the application:**
35+
36+
Use Docker Compose to build and run the local development environment:
37+
38+
```bash
39+
make start
40+
```
41+
42+
This command builds the Docker image and starts the services defined in `docker-compose.yml`.
43+
44+
## API Documentation
45+
46+
Swagger documentation is available once the application is running, accessible at `/apidocs`.
47+
48+

0 commit comments

Comments
 (0)