Data Import Service for kubernetes, designed with kubevirt in mind.
Go to file
2019-05-29 16:18:04 -04:00
.github Issue and PR templates for PROW 2018-09-10 08:57:20 -04:00
api/openapi-spec Generate new clientset compatable with k8s-1.13.4 2019-05-16 09:38:37 +03:00
assets CDI operator OLM integration: 2019-05-01 13:54:28 +03:00
automation Fix microdnf not using the repo files in /etc/yum.repos.d 2019-05-24 08:11:33 -04:00
cluster Fix cluster-clean 2019-05-08 17:36:12 -06:00
cmd controller leader election broken because controller had to become leader to be ready. Classic deadlock 2019-05-29 16:18:04 -04:00
doc doc updates 2019-05-29 10:44:43 -04:00
hack Fix microdnf not using the repo files in /etc/yum.repos.d 2019-05-24 08:11:33 -04:00
manifests fix sync script and rename cdi manifest 2019-05-05 19:11:49 -04:00
pkg Send more useful error messages from pods up to the controlling objects. 2019-05-29 07:51:15 -04:00
tests controller leader election broken because controller had to become leader to be ready. Classic deadlock 2019-05-29 16:18:04 -04:00
tools Set klog flags before flags parsing 2019-05-16 09:38:37 +03:00
vendor smart-clone 2019-05-20 11:04:10 +03:00
.gitignore this file shouldn't be here 2019-02-05 13:16:58 -05:00
.travis.yml Revert user change. 2019-05-01 12:16:41 -04:00
CONTRIBUTING.md Add CONTRIBUTING.md 2019-01-09 15:39:16 -05:00
doc.go Fix a bunch of go score card issues. 2019-05-06 16:52:03 -04:00
glide.lock smart-clone 2019-05-20 11:04:10 +03:00
glide.yaml smart-clone 2019-05-20 11:04:10 +03:00
LICENSE Add Apache V2 license (#379) 2018-08-28 14:50:21 -07:00
Makefile Randomize cdi namespace in tests. 2019-05-14 10:55:42 -04:00
README.md Added some basic storage information 2019-05-13 09:06:54 -04:00
stdci.yaml update k8s image to 1.13.3 and enable ceph 2019-03-27 11:41:35 +02:00

Containerized Data Importer

Build Status Go Report Card Coverage Status Licensed under Apache License version 2.0

Containerized-Data-Importer (CDI) is a persistent storage management add-on for Kubernetes. It's primary goal is to provide a declarative way to build Virtual Machine Disks on PVCs for Kubevirt VMs

CDI works with standard core Kubernetes resources and is storage device agnostic, while its primary focus is to build disk images for Kubevirt, it's also useful outside of a Kubevirt context to use for initializing your Kubernetes Volumes with data.

Introduction

Kubernetes extension to populate PVCs with VM images

CDI provides the ability to populate PVCs with VM images upon creation. Multiple image formats and sources are supported:

Current supported Image formats

  • .tar
  • .gz
  • .xz
  • .img
  • .iso
  • .qcow2

Current supported image endpoints

  • http
  • S3
  • local directory

DataVolumes

CDI also includes a CRD, that provides an object of type DataVolume. The DataVolume is an abstraction on top of the standard Kubernetes PVC and can be used to automate creation and population of a PVC for consumption in a Kubevirt VM.

Deploy it

Deploying the CDI controller is straightforward. In this document the default namespace is used, but in a production setup a protected namespace that is inaccessible to regular users should be used instead.

$ export VERSION=$(curl -s https://github.com/kubevirt/containerized-data-importer/releases/latest | grep -o "v[0-9]\.[0-9]*\.[0-9]*")
$ kubectl create -f https://github.com/kubevirt/containerized-data-importer/releases/download/$VERSION/cdi-operator.yaml
$ kubectl create -f https://github.com/kubevirt/containerized-data-importer/releases/download/$VERSION/cdi-operator-cr.yaml

Use it

Create a DataVolume and populate it with data from an http source

$ kubectl create -f https://raw.githubusercontent.com/kubevirt/containerized-data-importer/$VERSION/manifests/example/import-kubevirt-datavolume.yaml

There are quite a few examples in the example manifests, check them out as a reference to create DataVolumes from additional sources like registries, S3 and your local system.

Hack it

CDI includes a self contained development and test environment. We use Docker to build, and we provide a simple way to get a test cluster up and running on your laptop.

$ mkdir $GOPATH/src/kubevirt.io && cd $GOPATH/src/kubevirt.io
$ git clone https://github.com/kubevirt/containerized-data-importer && cd containerized-data-importer
$ make cluster-up
$ make cluster-sync
$ ./cluster/kubect.sh .....

Connect with us

We'd love to hear from you, reach out on Github via Issues or Pull Requests!

Hit us up on Slack, under the Kubernetes Virtualization channel

Shoot us an email at: kubevirt-dev@googlegroups.com

More details

  1. Hacking details
  2. Design docs
  3. Kubevirt documentation