FEATURE (healthcheck): Add databases healthcheck

Author: RostislavDugin

README.md

@@ -1,8 +1,8 @@
 <div align="center">
   <img src="assets/logo.svg" alt="Postgresus Logo" width="250"/>
 
-  <h3>PostgreSQL backup and restore tool</h3>
-  <p>Free, open source and self-hosted solution for automated PostgreSQL backups with multiple storage options and notifications</p>
+  <h3>PostgreSQL monitoring and backup</h3>
+  <p>Free, open source and self-hosted solution for automated PostgreSQL monitoring and backups with multiple storage options and notifications</p>
 
   <p>
     <a href="#-features">Features</a> •

backend/.env.development.example

@@ -10,4 +10,18 @@ DATABASE_URL=postgres://postgres:Q1234567@dev-db:5437/postgresus?sslmode=disable
 # migrations
 GOOSE_DRIVER=postgres
 GOOSE_DBSTRING=postgres://postgres:Q1234567@dev-db:5437/postgresus?sslmode=disable
-GOOSE_MIGRATION_DIR=./migrations
+GOOSE_MIGRATION_DIR=./migrations
+# testing
+# to get Google Drive env variables: add storage in UI and copy data from added storage here 
+TEST_GOOGLE_DRIVE_CLIENT_ID=
+TEST_GOOGLE_DRIVE_CLIENT_SECRET=
+TEST_GOOGLE_DRIVE_TOKEN_JSON=
+# testing DBs
+TEST_POSTGRES_13_PORT=5001
+TEST_POSTGRES_14_PORT=5002
+TEST_POSTGRES_15_PORT=5003
+TEST_POSTGRES_16_PORT=5004
+TEST_POSTGRES_17_PORT=5005
+# testing S3
+TEST_MINIO_PORT=9000
+TEST_MINIO_CONSOLE_PORT=9001

backend/cmd/main.go

@@ -17,10 +17,12 @@ import (
 	"postgresus-backend/internal/features/backups"
 	"postgresus-backend/internal/features/databases"
 	"postgresus-backend/internal/features/disk"
-	"postgresus-backend/internal/features/healthcheck"
+	healthcheck_attempt "postgresus-backend/internal/features/healthcheck/attempt"
+	healthcheck_config "postgresus-backend/internal/features/healthcheck/config"
 	"postgresus-backend/internal/features/notifiers"
 	"postgresus-backend/internal/features/restores"
 	"postgresus-backend/internal/features/storages"
+	system_healthcheck "postgresus-backend/internal/features/system/healthcheck"
 	"postgresus-backend/internal/features/users"
 	env_utils "postgresus-backend/internal/util/env"
 	files_utils "postgresus-backend/internal/util/files"
@@ -129,7 +131,9 @@ func setUpRoutes(r *gin.Engine) {
 	databaseController := databases.GetDatabaseController()
 	backupController := backups.GetBackupController()
 	restoreController := restores.GetRestoreController()
-	healthcheckController := healthcheck.GetHealthcheckController()
+	healthcheckController := system_healthcheck.GetHealthcheckController()
+	healthcheckConfigController := healthcheck_config.GetHealthcheckConfigController()
+	healthcheckAttemptController := healthcheck_attempt.GetHealthcheckAttemptController()
 	diskController := disk.GetDiskController()
 
 	downdetectContoller.RegisterRoutes(v1)
@@ -141,10 +145,13 @@ func setUpRoutes(r *gin.Engine) {
 	restoreController.RegisterRoutes(v1)
 	healthcheckController.RegisterRoutes(v1)
 	diskController.RegisterRoutes(v1)
+	healthcheckConfigController.RegisterRoutes(v1)
+	healthcheckAttemptController.RegisterRoutes(v1)
 }
 
 func setUpDependencies() {
 	backups.SetupDependencies()
+	healthcheck_config.SetupDependencies()
 }
 
 func runBackgroundTasks(log *slog.Logger) {
@@ -162,6 +169,10 @@ func runBackgroundTasks(log *slog.Logger) {
 	go runWithPanicLogging(log, "restore background service", func() {
 		restores.GetRestoreBackgroundService().Run()
 	})
+
+	go runWithPanicLogging(log, "healthcheck attempt background service", func() {
+		healthcheck_attempt.GetHealthcheckAttemptBackgroundService().RunBackgroundTasks()
+	})
 }
 
 func runWithPanicLogging(log *slog.Logger, serviceName string, fn func()) {

backend/docker-compose.yml.example

@@ -17,4 +17,72 @@ services:
       - ./pgdata:/var/lib/postgresql/data
     container_name: dev-db
     command: -p 5437
-    shm_size: 10gb
+    shm_size: 10gb
+
+  # Test MinIO container
+  test-minio:
+    image: minio/minio:latest
+    ports:
+      - "${TEST_MINIO_PORT:-9000}:9000"
+      - "${TEST_MINIO_CONSOLE_PORT:-9001}:9001"
+    environment:
+      - MINIO_ROOT_USER=testuser
+      - MINIO_ROOT_PASSWORD=testpassword
+    container_name: test-minio
+    command: server /data --console-address ":9001"
+
+  # Test PostgreSQL containers
+  test-postgres-13:
+    image: postgres:13
+    ports:
+      - "${TEST_POSTGRES_13_PORT}:5432"
+    environment:
+      - POSTGRES_DB=testdb
+      - POSTGRES_USER=testuser
+      - POSTGRES_PASSWORD=testpassword
+    container_name: test-postgres-13
+    shm_size: 1gb
+
+  test-postgres-14:
+    image: postgres:14
+    ports:
+      - "${TEST_POSTGRES_14_PORT}:5432"
+    environment:
+      - POSTGRES_DB=testdb
+      - POSTGRES_USER=testuser
+      - POSTGRES_PASSWORD=testpassword
+    container_name: test-postgres-14
+    shm_size: 1gb
+
+  test-postgres-15:
+    image: postgres:15
+    ports:
+      - "${TEST_POSTGRES_15_PORT}:5432"
+    environment:
+      - POSTGRES_DB=testdb
+      - POSTGRES_USER=testuser
+      - POSTGRES_PASSWORD=testpassword
+    container_name: test-postgres-15
+    shm_size: 1gb
+
+  test-postgres-16:
+    image: postgres:16
+    ports:
+      - "${TEST_POSTGRES_16_PORT}:5432"
+    environment:
+      - POSTGRES_DB=testdb
+      - POSTGRES_USER=testuser
+      - POSTGRES_PASSWORD=testpassword
+    container_name: test-postgres-16
+    shm_size: 1gb
+
+  test-postgres-17:
+    image: postgres:17
+    ports:
+      - "${TEST_POSTGRES_17_PORT}:5432"
+    environment:
+      - POSTGRES_DB=testdb
+      - POSTGRES_USER=testuser
+      - POSTGRES_PASSWORD=testpassword
+    container_name: test-postgres-17
+    shm_size: 1gb

backend/go.mod

@@ -3,7 +3,6 @@ module postgresus-backend
 go 1.23.3
 
 require (
-	github.com/docker/go-connections v0.5.0
 	github.com/gin-contrib/cors v1.7.5
 	github.com/gin-gonic/gin v1.10.0
 	github.com/golang-jwt/jwt/v4 v4.5.2
@@ -19,7 +18,6 @@ require (
 	github.com/swaggo/files v1.0.1
 	github.com/swaggo/gin-swagger v1.6.0
 	github.com/swaggo/swag v1.16.4
-	github.com/testcontainers/testcontainers-go v0.37.0
 	golang.org/x/crypto v0.39.0
 	gorm.io/driver/postgres v1.5.11
 	gorm.io/gorm v1.26.1
@@ -32,31 +30,20 @@ require (
 	github.com/google/s2a-go v0.1.9 // indirect
 	github.com/googleapis/enterprise-certificate-proxy v0.3.6 // indirect
 	github.com/googleapis/gax-go/v2 v2.14.2 // indirect
+	google.golang.org/genproto/googleapis/api v0.0.0-20250528174236-200df99c418a // indirect
 	google.golang.org/genproto/googleapis/rpc v0.0.0-20250603155806-513f23925822 // indirect
 	google.golang.org/grpc v1.73.0 // indirect
 )
 
 require (
-	dario.cat/mergo v1.0.2 // indirect
-	github.com/Azure/go-ansiterm v0.0.0-20250102033503-faa5f7b0171c // indirect
 	github.com/BurntSushi/toml v1.5.0 // indirect
 	github.com/KyleBanks/depth v1.2.1 // indirect
-	github.com/Microsoft/go-winio v0.6.2 // indirect
 	github.com/PuerkitoBio/purell v1.1.1 // indirect
 	github.com/PuerkitoBio/urlesc v0.0.0-20170810143723-de5bf2ad4578 // indirect
 	github.com/bytedance/sonic v1.13.2 // indirect
 	github.com/bytedance/sonic/loader v0.2.4 // indirect
-	github.com/cenkalti/backoff/v4 v4.3.0 // indirect
 	github.com/cloudwego/base64x v0.1.5 // indirect
-	github.com/containerd/errdefs v1.0.0 // indirect
-	github.com/containerd/errdefs/pkg v0.3.0 // indirect
-	github.com/containerd/log v0.1.0 // indirect
-	github.com/containerd/platforms v0.2.1 // indirect
-	github.com/cpuguy83/dockercfg v0.3.2 // indirect
 	github.com/davecgh/go-spew v1.1.1 // indirect
-	github.com/distribution/reference v0.6.0 // indirect
-	github.com/docker/docker v28.2.2+incompatible // indirect
-	github.com/docker/go-units v0.5.0 // indirect
 	github.com/dustin/go-humanize v1.0.1 // indirect
 	github.com/ebitengine/purego v0.8.4 // indirect
 	github.com/felixge/httpsnoop v1.0.4 // indirect
@@ -75,7 +62,6 @@ require (
 	github.com/go-playground/validator/v10 v10.26.0 // indirect
 	github.com/go-sql-driver/mysql v1.9.2 // indirect
 	github.com/goccy/go-json v0.10.5 // indirect
-	github.com/gogo/protobuf v1.3.2 // indirect
 	github.com/jackc/pgpassfile v1.0.0 // indirect
 	github.com/jackc/pgservicefile v0.0.0-20240606120523-5a60cdf6a761 // indirect
 	github.com/jackc/puddle/v2 v2.2.2 // indirect
@@ -86,47 +72,28 @@ require (
 	github.com/klauspost/compress v1.18.0 // indirect
 	github.com/klauspost/cpuid/v2 v2.2.10 // indirect
 	github.com/leodido/go-urn v1.4.0 // indirect
-	github.com/lufia/plan9stats v0.0.0-20250317134145-8bc96cf8fc35 // indirect
-	github.com/magiconair/properties v1.8.10 // indirect
 	github.com/mailru/easyjson v0.7.6 // indirect
 	github.com/mattn/go-isatty v0.0.20 // indirect
 	github.com/minio/crc64nvme v1.0.1 // indirect
 	github.com/minio/md5-simd v1.1.2 // indirect
-	github.com/moby/docker-image-spec v1.3.1 // indirect
-	github.com/moby/go-archive v0.1.0 // indirect
-	github.com/moby/patternmatcher v0.6.0 // indirect
-	github.com/moby/sys/atomicwriter v0.1.0 // indirect
-	github.com/moby/sys/sequential v0.6.0 // indirect
-	github.com/moby/sys/user v0.4.0 // indirect
-	github.com/moby/sys/userns v0.1.0 // indirect
-	github.com/moby/term v0.5.2 // indirect
 	github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd // indirect
 	github.com/modern-go/reflect2 v1.0.2 // indirect
-	github.com/morikuni/aec v1.0.0 // indirect
-	github.com/opencontainers/go-digest v1.0.0 // indirect
-	github.com/opencontainers/image-spec v1.1.1 // indirect
 	github.com/pelletier/go-toml/v2 v2.2.4 // indirect
 	github.com/philhofer/fwd v1.1.3-0.20240916144458-20a13a1f6b7c // indirect
-	github.com/pkg/errors v0.9.1 // indirect
 	github.com/pmezard/go-difflib v1.0.0 // indirect
 	github.com/power-devops/perfstat v0.0.0-20240221224432-82ca36839d55 // indirect
 	github.com/rogpeppe/go-internal v1.14.1 // indirect
 	github.com/rs/xid v1.6.0 // indirect
-	github.com/sirupsen/logrus v1.9.3 // indirect
 	github.com/stretchr/objx v0.5.2 // indirect
 	github.com/tinylib/msgp v1.3.0 // indirect
-	github.com/tklauser/go-sysconf v0.3.15 // indirect
-	github.com/tklauser/numcpus v0.10.0 // indirect
 	github.com/twitchyliquid64/golang-asm v0.15.1 // indirect
 	github.com/ugorji/go/codec v1.2.12 // indirect
 	github.com/yusufpapurcu/wmi v1.2.4 // indirect
 	go.opentelemetry.io/auto/sdk v1.1.0 // indirect
 	go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp v0.61.0 // indirect
 	go.opentelemetry.io/otel v1.36.0 // indirect
-	go.opentelemetry.io/otel/exporters/otlp/otlptrace v1.36.0 // indirect
 	go.opentelemetry.io/otel/metric v1.36.0 // indirect
 	go.opentelemetry.io/otel/trace v1.36.0 // indirect
-	go.opentelemetry.io/proto/otlp v1.7.0 // indirect
 	golang.org/x/arch v0.17.0 // indirect
 	golang.org/x/net v0.41.0 // indirect
 	golang.org/x/oauth2 v0.30.0