ovirt-openshift-extensions

container image	status
ovirt-flexvolume-driver
ovirt-volume-provisioner
ovirt-cloud-provider
ovirt-flexvolume-driver-apb
ovirt-openshift-installer

Purpose

Make oVirt the a prefered platform for openshift installation. The main components this project will ship are:

• storage integration through plugin - currently flex, CSI in the future
• cloud provider
• easy deployement of all those components

ovirt-volume-provisioner

A kubernetes controller that creates/deletes persistent volumes, and allocates disks
in ovirt as a result. This is the first part for providing volumes from oVirt.

ovirt-flexvolume-driver

A kubernetes node plugin that attaches/detaches a volume to a container.
It attaches the oVirt disk to the kube node (which is an oVirt VM). It identifies the disk device on the os,
prepares a filesystem, then mounts it so it is ready as a volume mount for a container.

ovirt-cloud-provider

An out-of-tree implementation of a cloudprovider.
A controller that manages the admission of new nodes for openshift, from oVirt VMs. \

Versions

version	ovirt version	openshift version
<= v0.3.1	>= 4.2	3.9, 3.10
>= v0.3.2	>= 4.2	3.10, 3.11

Deployment

Deploy via service-catalog

Pre-requisite:

• Openshift 3.10.0 or higher
• Running service catalog

From the repo:

• push the apb image to your cluster repo

  $ make apb_build apb_push

• go to the service catalog UI and deploy the ovirt-flexvolume-driver-apb.
  Here is a demo doing that:
  

Deploy via cli

• make sure oc command is configured and has access to your cluster, e.g. run oc status

• use a cluster admin user to deploy, or grant permission to one

  $ oc login -u system:admin
  $ oc adm policy add-cluster-role-to-user cluster-admin developer

• Run on a master (replace the input with yours):

   docker run \
   -it \
   --rm \
   --net=host \
   -v $HOME/.kube:/opt/apb/.kube:z \
   -u $UID quay.io/rgolangh/ovirt-flexvolume-driver-apb \
   provision -e \
   '{
     "admin_user":"developer",
     "admin_password":"YOURPASS",  
     "cluster":"openshift",
     "namespace":"default",
     "engine_username":"admin@internal",
     "engine_password":"YOURPASS",
     "engine_url":"https://ENGINE-FQDN/ovirt-engine/api",
     }'

  If it's the first time deploying the image then it should take few moments to download it. To customize the images to be deployed, provide these environment variables to the container invocation:

  • FLEX_REGISTRY
  • FLEX_REPOSITORY
  • FLEX_VERSION
  • PROVISIONER_REGISTRY
  • PROVISIONER_REPOSITORY
  • PROVISIONER_VERSION

  Example: docker run -e FLEX_REGISTRY=registry.example.com ...

Upon completion you have these components running:

$ oc get ds -n default ovirt-flexvolume-driver 
name                      desired   current   ready     up-to-date   available   node selector   age
ovirt-flexvolume-driver   1         1         1         1            1           <none>          15m

$ oc get deployment -n default ovirt-volume-provisioner 
NAME                       DESIRED   CURRENT   UP-TO-DATE   AVAILABLE   AGE
ovirt-volume-provisioner   1         1         1            1           17m

Documentation

For topics not covered in this Readme, see the project documentation.

Contributing

Feedback is most welcome, if you have an idea, proposal, fix, or want to chat
you'll find the details here:

• Patches are usual pull-request, see the pull request template.
• Upstream bugs: https://github.com/oVirt/ovirt-openshift-extensions/issues
• Trello Board: ovirt-openshift-extensions (may change to Jira)
• Bugzilla tracker bug: https://bugzilla.redhat.com/show_bug.cgi?id=1581638 (see the bugzilla tracker for the component under rhev)
• IRC: upstream: #ovirt @ oftc.net
• Mailing List: devel@ovirt.org

Blog post in ovirt: https://www.ovirt.org/blog/2018/02/your-container-volumes-served-by-ovirt/

Youtube Demo: https://youtu.be/_E9pUVrI0hs

References

• flexvolume plugin page on openshift
• flexvolume spec on kubernetes page