Prepare for testing with spread

[addyess]

This pull request updates documentation and workflow files to standardize the terminology and configuration for component-driven tests in the Kubernetes testing infrastructure. The main change is replacing the use-spread flag with a more general test flag, and expanding the repo field to support more flexible repository configurations. These updates improve clarity and flexibility for component test definitions and workflow execution.

Manifest and Component Configuration Changes:

• Replaced all instances of the use-spread flag with the test flag in documentation, YAML examples, and workflow instructions, clarifying that components providing tests should use test: true. [1] [2] [3] [4] [5] [6] [7]
• Expanded the repo field in component manifests from a simple string to an object supporting base-url, subdir, and ref, enabling monorepo support and flexible branch/tag selection. [1] [2] [3]

Workflow and CLI Usage Updates:

• Updated workflow files and CLI usage examples to use the new manifest structure and test flag, including changes to test execution commands and artifact paths. [1] [2]

Tooling and Environment Setup:

• Added steps to the GitHub Actions workflow to install Go, the Spread testing tool, and set up LXD, ensuring the required environment for component-driven spread tests.

Documentation Cleanup:

• Removed references to the deprecated hook_config property in component class documentation, simplifying configuration property access. [1] [2] [3]

[Copilot]

Pull request overview

This PR refactors the manifest schema and component configuration to support spread-based component tests, and wires a new kube-galaxy test flow that orchestrates spread suites from a shared tests directory.

Changes:

• Replace use-spread with test and change repo from a string to a structured RepoInfo object in manifests/models/loader.
• Add spread test orchestration (template + generator + runner) including kubeconfig sharing and per-component namespace lifecycle.
• Update CLI/workflow/tests to the new schema and to pass arch_info into component instances.

Reviewed changes

Copilot reviewed 36 out of 36 changed files in this pull request and generated 14 comments.

Show a summary per file

File	Description
tests/unit/test_validator.py	Updates spread component discovery test to use temp tests_root and test flag.
tests/unit/test_models.py	Updates model unit test from use_spread to test.
tests/unit/test_loader.py	Updates loader unit test expectations to test flag.
tests/unit/conftest.py	Updates sample manifest YAML to new repo.base-url shape; adds arch_info fixture.
tests/unit/components/test_kubelet.py	Updates component config construction to use RepoInfo and inject arch_info.
tests/unit/components/test_kubeadm.py	Updates component config construction to use RepoInfo and inject arch_info.
tests/unit/components/test_container_manifest.py	Updates tests for new RepoInfo and arch_info plumbing.
tests/unit/components/test_base_utils.py	Updates base utils tests for RepoInfo and new download_filename_from_config() signature.
tests/spread.yaml	Removes the repository-level spread config in favor of generated orchestration config.
src/kube_galaxy/pkg/utils/components.py	Introduces format_component_pattern() and removes GitHub-specific URL builder.
src/kube_galaxy/pkg/testing/templates/spread.yaml.tmpl	Adds a spread.yaml template for orchestration.
src/kube_galaxy/pkg/testing/spread.py	Implements spread orchestration, kubeconfig sharing, namespace lifecycle, and execution.
src/kube_galaxy/pkg/manifest/validator.py	Adds test task path helper and basic validation for component test structure.
src/kube_galaxy/pkg/manifest/models.py	Adds RepoInfo, replaces use_spread with test, adds InstallMethod.NONE.
src/kube_galaxy/pkg/manifest/loader.py	Parses new repo object, defaults install method to none, reads test flag.
src/kube_galaxy/pkg/literals.py	Adds tests paths and timeouts; replaces manifest field constant with TEST.
src/kube_galaxy/pkg/components/sonobuoy.py	Adds a test-only Sonobuoy component that writes a spread task.
src/kube_galaxy/pkg/components/kubeadm.py	Adjusts kubeadm init config to clear node taints.
src/kube_galaxy/pkg/components/containerd.py	Updates pause image resolution and uses shared pattern formatter.
src/kube_galaxy/pkg/components/_base.py	Makes arch_info required, centralizes pattern formatting, adds InstallMethod.NONE handling.
src/kube_galaxy/pkg/cluster.py	Ensures arch_info is passed when instantiating components; tweaks stage numbering.
src/kube_galaxy/cmd/validate.py	Removes the old validate command handler module.
src/kube_galaxy/cmd/test.py	Reworks test command to spread(manifest_path) and moves validate logic here.
src/kube_galaxy/cli.py	Simplifies CLI commands; changes test and validate wiring and signatures.
manifests/smoktest.yaml	Migrates to repo.base-url; adds sonobuoy as a test-only component.
manifests/baseline-k8s-1.36.yaml	Migrates to repo.base-url schema.
manifests/baseline-k8s-1.35.yaml	Migrates to repo.base-url schema.
manifests/baseline-k8s-1.34.yaml	Migrates to repo.base-url schema.
manifests/baseline-k8s-1.33.yaml	Migrates to repo.base-url schema.
docs/spread-based-component-tests-prompt.md	Adds a design/plan document for spread-based component tests.
docs/component-lifecycle-hooks.md	Removes references to now-removed hook config accessors.
docs/class-based-components.md	Removes hook-config section/docs that no longer match models.
README.md	Updates examples/docs for repo object and test flag.
.github/workflows/test-baseline-clusters.yml	Installs spread + LXD and runs kube-galaxy test <manifest>; uploads logs/.
.github/copilot-instructions.md	Updates schema references but still contains outdated CLI examples.
.github/ARCHITECTURE.md	Updates narrative references from use-spread to test.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

You can also share your feedback on Copilot code review. Take the survey.