intel-device-plugins-for-kubernetes/cmd/fpga_crihook/README.md

Build and set up Intel FPGA prestart CRI-O hook

Dependencies

You must install and set up the following FPGA plugin modules for correct operation:

• FPGA device plugin
• FPGA admission controller webhook
• FPGA prestart CRI-O hook (this module)

Get source code:

    $ mkdir -p $GOPATH/src/github.com/intel/
    $ cd $GOPATH/src/github.com/intel/
    $ git clone https://github.com/intel/intel-device-plugins-for-kubernetes.git

Build CRI-O hook:

    $ cd $GOPATH/src/github.com/intel/intel-device-plugins-for-kubernetes
    $ make intel-fpga-initcontainer
    $ docker images
    REPOSITORY                      TAG                                        IMAGE ID            CREATED          SIZE
    intel/intel-fpga-initcontainer  01b11d9d6d18bbe7df987a738efb20ae22ce795e   2e7586fe0fa6        0 sec ago        57.6MB
    intel/intel-fpga-initcontainer  devel                                      2e7586fe0fa6        0 sec ago        57.6MB
    ...

Ensure that CRI-O is configured to allow OCI hooks

Recent versions of CRI-O are shipped with default configuration file that prevents CRI-O to discover and configure hooks automatically. For FPGA orchestration programmed mode, the OCI hooks are the key component. Thus, please make sure that in your /etc/crio/crio.conf parameter hooks_dir is either unset (to enable default search paths for OCI hooks configuration) or contains directory /etc/containers/oci/hooks.d