test: add example with spring boot application failover

Author: vlsi

README.md

@@ -9,6 +9,7 @@ Postgres-Operator provides PostgreSQL as a service on Kubernetes and OpenShift.
 * * `./charts/patroni-services` - directory with HELM chart for Postgres Services.
 * `./pkg` - directory with operator source code, which is used for running Postgres Operator.
 * `./tests` - directory with robot test source code, `Dockerfile`.
+* * `./tests/examples` - example projects demonstrating various use cases.
 
 ## How to start
 
@@ -25,7 +26,12 @@ There are no well-defined rules for troubleshooting, as each task is unique, but
 * Deploy parameters.
 * Logs from all Postgres Service pods: operator, postgres db and others.
 
+## Examples
+
+* **[Spring Boot Failover Testing](tests/examples/spring-boot-failover-test/)** - Test PostgreSQL failover behavior with Spring Boot applications
+* [More Examples](tests/examples/) - Additional example projects
+
 ## Useful links
 
 * [Installation Guide](/docs/public/installation.md)
-* [Features](/docs/public/features)
+* [Features](/docs/public/features)

tests/examples/README.md

@@ -0,0 +1,48 @@
+# pgskipper-operator Examples
+
+This directory contains example projects demonstrating various use cases for pgskipper-operator.
+
+## Available Examples
+
+### [Spring Boot Failover Testing](spring-boot-failover-test/)
+
+A comprehensive testing environment to reproduce and analyze PostgreSQL failover behavior with Spring Boot applications using HikariCP connection pooling.
+
+**Features:**
+- PostgreSQL HA cluster with automatic failover
+- Spring Boot application with connection monitoring
+- Failover testing scripts
+- Detailed metrics and monitoring
+- HikariCP connection pool optimization
+
+**Use Cases:**
+- Testing application behavior during database failover
+- Validating connection pool configurations
+- Analyzing reconnection patterns and timing
+- Developing failover-resilient applications
+
+**Quick Start:**
+```bash
+cd spring-boot-failover-test
+helmfile sync
+```
+
+See the [full documentation](spring-boot-failover-test/README.md) for detailed instructions.
+
+---
+
+## Contributing Examples
+
+If you have an example demonstrating a specific use case for pgskipper-operator, please feel free to contribute it! Each example should include:
+
+1. **README.md** - Clear documentation with prerequisites, setup instructions, and usage
+2. **helmfile.yaml** or deployment manifests - Reproducible deployment configuration
+3. **Application code** - If applicable, well-documented source code
+4. **.gitignore** - To exclude build artifacts and sensitive data
+
+## Support
+
+For issues or questions about these examples:
+- Check the individual example's documentation
+- Review the main [pgskipper-operator documentation](../../README.md)
+- Open an issue in the [GitHub repository](https://github.com/Netcracker/pgskipper-operator/issues)

tests/examples/spring-boot-failover-test/.envrc.example

@@ -0,0 +1,39 @@
+# Example environment configuration for helmfile
+# Copy this file to .envrc and adjust as needed
+# If using direnv, it will automatically load these variables when you cd into the directory
+
+# Image Configuration
+# -------------------
+
+# Use local build instead of official images (default: false)
+# export USE_LOCAL_IMAGES=true
+
+# Override operator image repository (default: ghcr.io/netcracker/pgskipper-operator)
+# export PGSKIPPER_IMAGE=ghcr.io/netcracker/pgskipper-operator
+
+# Override operator image tag (default: main)
+# export PGSKIPPER_TAG=v1.2.3
+
+# Deployment Configuration
+# -------------------------
+
+# Override PostgreSQL namespace (default: postgres)
+# export NAMESPACE=postgres
+
+# Override application namespace (default: default)
+# export APP_NAMESPACE=default
+
+# Usage Examples
+# --------------
+#
+# Deploy to OrbStack with official images:
+#   helmfile -e local sync
+#
+# Deploy to OrbStack with local build:
+#   USE_LOCAL_IMAGES=true helmfile -e local sync
+#
+# Deploy to Rancher with specific version:
+#   PGSKIPPER_TAG=v1.2.3 helmfile -e rancher sync
+#
+# Deploy to cloud with custom image:
+#   PGSKIPPER_IMAGE=myregistry.io/pgskipper PGSKIPPER_TAG=custom helmfile sync

tests/examples/spring-boot-failover-test/.gitignore

@@ -0,0 +1,40 @@
+# Maven
+spring-app/target/
+spring-app/.mvn/
+spring-app/mvnw
+spring-app/mvnw.cmd
+
+# Buildpacks cache
+spring-app/.pack/
+.pack-build/
+
+# IDE
+.idea/
+*.iml
+.vscode/
+*.swp
+*.swo
+.claude/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+
+# Kubernetes
+*.kubeconfig
+
+# Docker
+.dockerignore
+
+# Environment variables (direnv)
+.envrc
+
+# Temporary files
+tmp/
+temp/
+
+# Test outputs
+test-results/