Skip to content

Collection of Testkube Workflows for validating Kubernetes infrastructure components

License

Notifications You must be signed in to change notification settings

kubeshop/testkube-workflow-catalog

Repository files navigation

Testkube Infrastructure Validation Workflows

A community-driven collection of reusable Testkube workflows for validating infrastructure components in Kubernetes environments.

Overview

This repository contains pre-built TestWorkflows that validate the configuration and health of common infrastructure components like databases, message brokers, caching systems, and more.

Key Features:

  • 🔌 Plug-and-play - Configure and run in minutes
  • 🔒 Security-first - All images vetted and digest-pinned
  • 🏷️ Well-categorized - Easy to browse and discover
  • 🤝 Community-driven - Open for contributions

Repository Structure

workflows/
├── databases/          # PostgreSQL, MySQL, MongoDB, Redis
├── messaging/          # Kafka, RabbitMQ, NATS
├── caching/            # Redis, Memcached
├── storage/            # MinIO, Elasticsearch
├── networking/         # Ingress controllers, Service mesh
├── observability/      # Prometheus, Grafana, Jaeger
└── security/           # Vault, cert-manager
└── other/              # Anything that doesn't fit these categories

Quick Start

1. Browse Available Workflows

Explore the workflows/ directory to find validation workflows for your infrastructure components.

The Testkube Dashboard included with

2. Deploy a Workflow

# Apply directly to your Testkube instance
kubectl apply -f workflows/databases/redis/redis-connectivity.yaml

# Or use the Testkube CLI
testkube create testworkflow -f workflows/databases/redis/redis-connectivity.yaml

3. Run the Workflow

# Run with default configuration
testkube run testworkflow redis-connectivity

# Run with custom parameters
testkube run testworkflow redis-connectivity \
  --config host=my-redis.default.svc.cluster.local \
  --config port=6379

Workflow Metadata

All workflows include standardized metadata for easy discovery:

Labels (for filtering)

Label Purpose Values
catalog.testkube.io/category Infrastructure type databases, messaging, caching, storage, networking, observability, security, other
catalog.testkube.io/component Specific component redis, postgresql, kafka, etc.
catalog.testkube.io/validation-type What's being validated connectivity, health, performance, security

Annotations (for display)

Annotation Purpose
catalog.testkube.io/display-name Human-readable name
catalog.testkube.io/description What the workflow validates
catalog.testkube.io/icon Icon identifier for UIs
catalog.testkube.io/tags Search keywords

Security

All workflows in this repository follow strict security guidelines:

  • Approved registries only - Images from vetted sources
  • Digest pinning - Immutable image references
  • Automated validation - CI checks on every PR

See CONTRIBUTING.md for details.

Contributing

We welcome contributions! Please read our Contributing Guidelines before submitting a PR.

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

About

Collection of Testkube Workflows for validating Kubernetes infrastructure components

Topics

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published