An ephemeral-inline volume manager with time delayed deletion for Kubernetes.
Find a file
Christina Monti 05fe14fe6c
Update README.md
Update README to apply archive status
2023-06-23 12:21:35 -07:00
.github/workflows Adds stream image push to quay. 2021-11-24 14:04:24 -08:00
cmd/katboxplugin Changing default name of the driver to be katbox.csi.paypal.com 2021-04-12 14:51:50 -07:00
deploy Corrects image used for katbox to an actual katbox image. 2021-11-23 20:17:39 -08:00
docs Public release of katbox 2021-04-12 12:03:46 -07:00
examples Public release of katbox 2021-04-12 12:03:46 -07:00
hack Public release of katbox 2021-04-12 12:03:46 -07:00
pkg/katbox Removing artifact from csi hostpath as it's no longer relevant 2022-03-18 16:12:27 -07:00
release-tools Upgrade kubernetes to v1.22.5 (#4) 2021-12-29 15:30:37 -08:00
stream Reduces stream image complexity to just loading the binary into the iamge and setting an entrypoint. 2021-11-24 14:01:29 -08:00
.gitignore Public release of katbox 2021-04-12 12:03:46 -07:00
CHANGELOG.md Public release of katbox 2021-04-12 12:03:46 -07:00
Dockerfile Changes the name of the files created in order to disambiguate. Updates Dockerfile to reflect the change. 2021-11-24 14:02:27 -08:00
go.mod Bump github.com/swaggo/http-swagger from 1.0.0 to 1.2.6 (#5) 2022-04-22 14:55:04 -07:00
go.sum Bump github.com/swaggo/http-swagger from 1.0.0 to 1.2.6 (#5) 2022-04-22 14:55:04 -07:00
LICENSE Public release of katbox 2021-04-12 12:03:46 -07:00
Makefile Changes the name of the files created in order to disambiguate. Updates Dockerfile to reflect the change. 2021-11-24 14:02:27 -08:00
README.md Update README.md 2023-06-23 12:21:35 -07:00

status: archive

Katbox Docker Images

Katbox is an inline ephemeral volume manager with delayed deletion for Kubernetes.

It is inspired by the "Sandbox" functionality provided by Apache Mesos.

Pre-requisite

  • Kubernetes cluster
  • Running version 1.18 or later
  • Access to terminal with kubectl installed

Deployment

Deployment varies depending on the Kubernetes version your cluster is running:

Examples

Assuming katbox has been successfully deployed, the following example can be run using kubectl:

$ kubectl apply -f https://raw.githubusercontent.com/paypal/katbox/main/examples/csi-app-inline.yaml

Building the binaries

To build the driver, run the following command from the root of the repository:

make

Building a docker image

To build a docker image to be used on a kubernetes cluster, run the following command from the root of the repository:

docker build . -t <image name>

Documentation

A high level overview of how katbox works can be found here

A closer look at how the creation and deletion of volumes works can be found here

Credits

This project was initially a fork of CSI Hostpath driver.