This repo documents the test plan for Cluster Orchestration subsystem in Intel® Open Edge Platform. It also hosts the integration test framework and test cases that is used test the cluster orchestration subsystem.
This repo uses the following tools. Make sure you have them installed on your system:
- mage build tool to build and run the tests.
- asdf to manage the versions of the tools used in the tests.
- docker to run the tests in a containerized environment.
To install the dependencies, run the following command:
mage asdfPluginsMake sure to set export PATH="$HOME/.asdf/shims:$PATH" in your shell profile to ensure that the tools installed
by asdf are available in your PATH.
To run the tests, run the following command:
make testThe above step will internally invoke the bootstrap make target to bootstrap the environment with the dependencies
configured in .test-dependencies.yaml file before running the tests.
Refer the test-plan/test-plan.md for the detailed test plan.
While there is a default configuration to bootstrap the test environment, it is also possible for you to configure the dependencies.
Below is the format the .test-dependencies.yaml file. You can add the dependencies that you need to install for your tests.
# .test-dependencies.yaml
# This YAML file defines the dependencies for the test bootstrap step. It specifies build steps for various dependencies
# required for the test environment. The file contains the following fields:
#
# Fields:
# - kind-cluster-config: Specifies the configuration file for the kind cluster.
#
# - components: A list of components, each with its own configuration:
# - name: The name of the component.
# - skip-component: A flag to skip the component during the build process (true/false).
# - skip-local-build: A flag to skip the local build of the component (true/false).
# - pre-install-commands: Commands to run before installing the component.
# - helm-repo: Details for the Helm repositories, including:
# - url: The URL of the Helm repository.
# release-name: The release name for the Helm chart.
# package: The Helm chart package name.
# namespace: The Kubernetes namespace for the Helm release.
# version: The version of the Helm chart.
# overrides: The Helm chart overrides.
# - git-repo:
# url: The Git URL of the component's repository.
# version: The Git branch/tag/commit of the component to use.
# - make-directory: The directory containing the Makefile.
# - make-variables: Variables to pass to the `make` command.
# - make-targets: `make` targets to build the component.
# - post-install-commands: Commands to run after installing the component.You can override the default configuration by setting the ADDITIONAL_CONFIG environment variable for the test:bootstrap
target like below.
ADDITIONAL_CONFIG='{"components":[{"name":"cluster-api-provider-intel", "skip-local-build": false, "git-repo": {"version":"my-dev-branch"}}]}' mage test:bootstrapThis example command will override the version of the cluster-api-provider-intel component to my-dev-branch.
NOTE: The ADDITIONAL_CONFIG should be a valid JSON string and should follow the format specified in the
.test-dependencies.yaml file.
We welcome contributions from the community! To contribute, please open a pull request to have your changes reviewed and merged. See the contributor's guide to learn more.
The project will accept contributions through Pull-Requests (PRs). PRs must be built successfully by the CI pipeline, pass linters verifications and the unit tests.
To learn more about the project, its community, and governance, visit the Edge Orchestrator Community. For support, start with Troubleshooting or contact us.
There are several convenience make targets to support developer activities, you can run mage -l to see the list of available targets.
Cluster tests is licensed under Apache 2.0 License