DISCONTINUATION OF PROJECT
This project will no longer be maintained by Intel.
Intel has ceased development and contributions including, but not limited to, maintenance, bug fixes, new releases, or updates, to this project.
Intel no longer accepts patches to this project.
If you have an ongoing need to use this project, are interested in independently developing it, or would like to maintain patches for the open source software community, please create your own fork of this project.
Contact: webadmin@linux.intel.com
Documentation
Prerequisites
Prerequisites for building and running CDI include:
- Appropriate hardware
- A fully configured Kubernetes cluster with Docker runtime
- A working Go environment, of at least version v1.14.4
Installation
- Build modified external-provisioner image csi-provisioner:cdi
$ git clone ssh://git@gitlab.devtools.intel.com:29418/kubernetes/device-plugins/external-provisioner.git
$ cd external-provisioner
$ make container
$ docker tag csi-provisioner csi-provisioner:cdi
- Clone cdi repo
$ git clone ssh://git@gitlab.devtools.intel.com:29418/kubernetes/device-plugins/cdi.git
- Install cfssl and cfssljson
$ sudo apt-get install golang-cfssl
- Create cdi-registry-secrets and cdi-node-secrets
$ cd cdi
$ KUBECONFIG=~/.kube/config ./deploy/setup-ca-k8s.sh
- Build cdi-driver:canary image
$ make image
- Build runc wrapper
$ make cdi-runc
- Replace runc with a wrapper
$ sudo cp /usr/bin/runc /usr/bin/runc.orig
$ sudo cp _output/cdi-runc /usr/bin/runc
- Build deploy/kubernetes-1.18/cdi.yaml
$ make kustomize
- Label device nodes
$ kubectl label node <node name> storage=cdi
- Deploy cdi driver and its dependencies
$ kubectl create -f deploy/kubernetes-1.18/cdi.yaml
- Create FPGA storage class and PVC
$ kubectl create -f example/arria10.nlb0/sc.yaml
$ kubectl create -f example/arria10.nlb0/pvc.yaml
- Run example workload
$ kubectl create -f example/arria10.nlb0/pod.yaml