Warning This repository is obsolete. The recommendation is to use kubernetes.core for virtualization machine management.

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 Kuberenetes 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 commands below. For more information on clusters and other deployment scenarious see playbooks instructions.

oc login -u <admin_user> -p <admin_password>

ansible-playbook -i localhost playbooks/kubevirt.yml -e@vars/all.yml

Note: Check default variables in vars/all.yml and update them if needed.

1. Ensure it is possible to login into the cluster

oc login

2. Compile tests from the tests directory inside the docker container and copy it to the kubevirt-ansible/_out directory.

make build-tests

3. Run all the e2e tests with the ~/.kube/config file

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.endpoint with other images, use the STREAM_IMAGE_URL environment 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.

• KubeVirt
• OpenShift Ansible
• Golang Ansible playbook