Tools to provision resources, deploy clusters and install KubeVirt.
KubeVirt Ansible consists of a set of Ansible playbooks that deploy fully functional virtual machine management add-on for Kubernetes - KubeVirt. Optionally, a KubeVirt or OpenShift cluster can also be configured.
automation/: CI scripts to verify the functionality of playbooks.playbooks/: Ansible playbooks to provision resources, deploy a cluster and install KubeVirt for various scenarios.roles/: Roles to use in playbooks.vars/: Variables to use in playbooks.inventory: A template for the cluster and nodes configuration.requirements.yml: A list of required Ansible-Galaxy roles to use in playbooks.stdci.yaml: A configuration file for CI system.
To deploy KubeVirt on an existing OpenShift cluster run the command below. For more information on clusters and other deployment scenarious see playbooks instructions.
ansible-playbook -i localhost playbooks/kubevirt.yml -e@vars/all.yml
Note: Check default variables in vars/all.yml and update them if needed.
- Ensure it is possible to login into the cluster
oc login
- Compile tests from the tests directory inside the docker container and copy it to the
kubevirt-ansible/_outdirectory.
make build-tests
- Run all the e2e tests with the
~/.kube/configfile
make test
If you'd like to run specific tests only, you can leverage ginkgo
command line options as follows (run a specified suite):
FUNC_TEST_ARGS='-ginkgo.focus=sanity_test -ginkgo.regexScansFilePath' make test
or you can pass it to tests via:
./_out/tests/<name>.test -kubeconfig=your_kubeconfig -tag=kubevirt_images_tag -prefix=kubevirt -test.timeout 60m
Note: To test PVC's
storage.import.endpointwith other images, use theSTREAM_IMAGE_URLenvironment variable:
export STREAM_IMAGE_URL=<the_image_url>
Stop by the #kubevirt chat channel on freenode IRC
Please see the contributing guidelines for information regarding the contribution process.
Please check the CI automation guidelines for information on playbooks verification.