HyperFleet E2E

Black-box end-to-end testing for validating the HyperFleet cluster lifecycle management.

What is it?

HyperFleet E2E is a Ginkgo-based testing framework that validates HyperFleet cluster lifecycle management through black-box tests. It creates ephemeral test clusters for each test, providing complete isolation and supporting parallel execution.

Quick Start

# Clone and build
git clone https://github.com/openshift-hyperfleet/hyperfleet-e2e.git
cd hyperfleet-e2e
make build

# Set API URL and run tests
export HYPERFLEET_API_URL=https://api.hyperfleet.example.com
./bin/hyperfleet-e2e test --label-filter=tier0

Done! The framework created a cluster, validated adapters, and cleaned up resources.

Running Tests

Filter by Labels

# Critical severity tests (Release gate)
./bin/hyperfleet-e2e test --label-filter=tier0

# Exclude slow tests
./bin/hyperfleet-e2e test --label-filter="!slow"

Common Options

# Debug mode (API calls and framework internals)
./bin/hyperfleet-e2e test --log-level=debug

# Run specific test suite
./bin/hyperfleet-e2e test --focus "\[Suite: cluster\]"

Run ./bin/hyperfleet-e2e test --help for all options.

Configuration

Configuration priority (highest to lowest):

1. CLI flags (--api-url)
2. Environment variables (HYPERFLEET_API_URL)
3. Config file (configs/config.yaml)
4. Built-in defaults

Example:

export HYPERFLEET_API_URL=https://staging.api.example.com
./bin/hyperfleet-e2e test

See configs/config.yaml for all configuration options with detailed comments.

Project Structure

hyperfleet-e2e/
├── cmd/              - CLI entry point
│   └── hyperfleet-e2e/
├── pkg/              - Core packages
│   ├── api/          - OpenAPI generated client
│   ├── client/       - HyperFleet API client wrapper
│   ├── config/       - Configuration loading and validation
│   ├── e2e/          - Test execution engine (Ginkgo)
│   ├── helper/       - Test helper utilities
│   ├── labels/       - Test label definitions
│   └── logger/       - Structured logging (slog)
├── e2e/              - Test suites
│   ├── cluster/      - Cluster lifecycle tests
│   └── nodepool/     - NodePool management tests
├── testdata/         - Test payloads and fixtures
│   └── payloads/
│       ├── clusters/ - Cluster creation payloads
│       └── nodepools/ - NodePool creation payloads
├── configs/          - Configuration files
│   └── config.yaml   - Default configuration
└── docs/             - Documentation

Key Features

• Ephemeral Resources: Each test creates and cleans up its own cluster for complete isolation
• Payload Templates: Dynamic resource naming with template variables to prevent naming conflicts
• Flexible Filtering: Run tests by labels, focus patterns, or skip patterns
• Comprehensive Validation: Verifies cluster phases, adapter conditions, and health status
• Structured Logging: JSON or text logging with configurable levels
• Parallel Execution: Full isolation enables safe parallel test runs

Documentation

• Getting Started - Run your first test in 10 minutes
• Architecture - Understand the framework design
• Development - Write new tests

CI/CD Integration

# Set API URL
export HYPERFLEET_API_URL=$CI_API_URL

# Run critical severity tests with JUnit output
./bin/hyperfleet-e2e test \
  --label-filter=tier0 \
  --junit-report=results.xml \
  --log-format=json

Container Usage

make image

podman run --rm \
  -e HYPERFLEET_API_URL=https://api.example.com \
  quay.io/openshift-hyperfleet/hyperfleet-e2e:latest \
  test --label-filter=tier0

Development

make build      # Build binary
make test       # Run unit tests
make lint       # Run linter
make check      # Run all checks

See Development Guide for adding new tests.

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes and add tests
4. Run make check
5. Submit a pull request

See OWNERS for approval requirements.

Support

• 📖 Documentation
• 🐛 Report Issues

License

Apache License 2.0 - See LICENSE for details.