01cloud-status

Monitor Kubernetes service health and event history — Go backend · React frontend · PostgreSQL

---

Overview

01cloud-status gives teams a lightweight status dashboard for Kubernetes workloads. It combines live service health checks from the cluster, persisted event history in PostgreSQL, and a web UI for operators and developers. The backend exposes JSON APIs and can also serve the built frontend from the same process.

Features

• Live service health checks for configured Kubernetes workloads
• Historical event browsing with pagination and filtering
• PostgreSQL-backed event storage
• React dashboard bundled and served by the Go application
• Docker support for containerized deployment

Stack

Layer	Technologies
Backend	Go, Gin, GORM, Kubernetes client-go
Frontend	React, Vite, Bootstrap
Storage	PostgreSQL
License	Apache 2.0

Repository layout

.
├── main.go
├── pkg/v1/
│   ├── controller/
│   ├── middleware/
│   ├── models/
│   ├── repository/
│   └── service/
├── frontend/
└── .github/

---

API

Base path: /api/v1

Method	Endpoint	Description
GET	/api/v1	Current service status list
GET	/api/v1/history	Stored event history

/api/v1/history query parameters

Parameter	Type	Description
page	number	Page number
limit	number	Records per page
serviceName	string	Filter by service name
queryText	string	Search event messages
startDate	string	Start date (YYYY-MM-DD)
endDate	string	End date (YYYY-MM-DD)

---

Configuration

Copy .env.sample to .env and fill in the required values.

Variable	Description	Default
KUBECONFIG	Path to kubeconfig file	—
NAMESPACE	Kubernetes namespace to watch	—
SERVICES	Comma-separated deployment names	—
PORT	HTTP port for the backend	8080
DB_DRIVER	Database driver name	—
DB_HOST	Database host	—
DB_PORT	Database port	—
DB_USER	Database user	—
DB_PASSWORD	Database password	—
DB_NAME	Database name	—

---

Local development

Requirements: Go 1.23+ · Node.js 18+ · npm 9+ · PostgreSQL · Kubernetes cluster or kubeconfig

Backend

go mod download
make run

Frontend

cd frontend
npm ci
npm run dev

Build bundled UI

The backend serves files from frontend/dist. Build the frontend before running in bundled mode:

cd frontend
npm ci
npm run build

Docker

docker build -t 01cloud-status .

The Docker build compiles the frontend and bundles the generated assets into the final image.

Quality checks

Backend

make lint
make test

Frontend

cd frontend
npm run lint
npm run build

Repository-wide hooks

pre-commit run --all-files

---

Contributing

Contributions are welcome. Please read CONTRIBUTING.md before opening issues or pull requests.

Please also review CODE_OF_CONDUCT.md for community expectations.

Security

Please do not report vulnerabilities publicly. See SECURITY.md for responsible disclosure instructions.

License

This project is currently licensed under the Apache License 2.0. See LICENSE.