Kubernetes Virtualization Operator with API and runtime in order to define and manage virtual machines.
Go Shell Other
cynepco3hahue Merge pull request #1345 from cynepco3hahue/cpu_host_passthrough
Add possibility to use CPU passthrough for VM's
Latest commit e29d57e Jul 22, 2018
Permalink
Failed to load latest commit information.
.github Prepare Issues and PRs for Prow Jun 21, 2018
api/openapi-spec Add explicitly host-model and update CPU model description. Jul 22, 2018
automation Fix stdci configuration for the project Jul 19, 2018
cluster virtctl.sh: Call appropriate binary by architecture Jul 19, 2018
cmd Use libvirt-4.2.0 Jul 15, 2018
docs Merge pull request #1156 from awels/fix_storage_doc Jul 19, 2018
hack Merge pull request #1313 from benwatcisco/Darwin_support Jul 19, 2018
images Update base images to Fedora 28 Jul 15, 2018
manifests Removed CRD status from generated manifests Jul 20, 2018
pkg Add explicitly host-model and update CPU model description. Jul 22, 2018
tests Add explicitly host-model and update CPU model description. Jul 22, 2018
tools Merge pull request #1171 from phoracek/hooks Jul 10, 2018
vendor Removed CRD status from generated manifests Jul 20, 2018
.gitattributes Add .gitattributes to hide vendor/ in diffs Jun 13, 2018
.gitignore hooks: fix timeout and sidecar name in tests Jul 5, 2018
.mailmap hack: Update release script and mailMap Jul 19, 2018
.rsynctemp Wait for rsyncd to be ready Jan 15, 2018
.travis.yml Create and publish a jinja2 template of kubevirt.yaml Jun 27, 2018
CODE_OF_CONDUCT.md Make CoC render as Markdown May 9, 2018
CONTRIBUTING.md Link from contribution guide to getting-started guide Jun 27, 2017
FAQ.md Add FAQ.md Jan 26, 2017
LICENSE LICENSE: Add date and owner Feb 27, 2017
Makefile Add separation between registry push and publish Jun 25, 2018
README.md direct visitors more clearly to user / developer docs Jun 9, 2018
glide.lock Removed CRD status from generated manifests Jul 20, 2018
glide.yaml Removed CRD status from generated manifests Jul 20, 2018
stdci.yaml Fix stdci configuration for the project Jul 19, 2018

README.md

KubeVirt

Build Status Go Report Card Licensed under Apache License version 2.0 Coverage Status Visit our IRC channel

KubeVirt is a virtual machine management add-on for Kubernetes. The aim is to provide a common ground for virtualization solutions on top of Kubernetes.

Note: KubeVirt is a heavy work in progress.

Introduction

Virtualization extension for Kubernetes

At its core, KubeVirt extends Kubernetes by adding additional virtualization resource types (especially the VM type) through Kubernetes's Custom Resource Definitions API. By using this mechanism, the Kubernetes API can be used to manage these VM resources alongside all other resources Kubernetes provides.

The resources themselves are not enough to launch virtual machines. For this to happen the functionality and business logic needs to be added to the cluster. The functionality is not added to Kubernetes itself, but rather added to a Kubernetes cluster by running additional controllers and agents on an existing cluster.

The necessary controllers and agents are provided by KubeVirt.

As of today KubeVirt can be used to declaratively

  • Create a predefined VM
  • Schedule a VM on a Kubernetes cluster
  • Launch a VM
  • Stop a VM
  • Delete a VM

Example:

asciicast

To start using KubeVirt

Try our quickstart at kubevirt.io.

See our user documentation at docs.kubevirt.io.

To start developing KubeVirt

To set up a development environment please read our Getting Started Guide. To learn how to contribute, please read our contribution guide.

You can learn more about how KubeVirt is designed (and why it is that way), and learn more about the major components by taking a look at our developer documentation:

Community

If you got enough of code and want to speak to people, then you got a couple of options:

Related resources

Submitting patches

When sending patches to the project, the submitter is required to certify that they have the legal right to submit the code. This is achieved by adding a line

Signed-off-by: Real Name <email@address.com>

to the bottom of every commit message. Existence of such a line certifies that the submitter has complied with the Developer's Certificate of Origin 1.1, (as defined in the file docs/developer-certificate-of-origin).

This line can be automatically added to a commit in the correct format, by using the '-s' option to 'git commit'.

License

KubeVirt is distributed under the Apache License, Version 2.0.

Copyright 2016

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.