Kibishii (Japanese for "strict") is a tool for generating and verifying data, especially targeted at the cloud native space. Distributed applications are being built that have multiple independent storage units. Testing that the storage system and data protection system are correctly protecting data can be difficult. Testing with actual application data is a good final verification, but the sensitivity of applications to data corruption varies as well as the ability to diagnose the problem.
Kibishii generates a synthetic workload that can be tightly defined and data corruption or loss is easily diagnosed. It is a full scale-out architecture that can simulate thousands of nodes creating and verifying data. The data generated is in algorithmically generated and can be verified without storing a reference copy.
Kibishii generates a tree of files. The number of files/directories per level, number of levels and size of the files are specified. Each file contains checked-summed data that can be verified as correct.
Kibishii is given a tree and the parameters used to generate it. It then descends the tree, verifying that the expected number of files and directory exist and that the data in the files is consistent.
Kibishii on Kubernetes runs as a namespace with an etcd KV store for co-ordination and N Kibishii worker pods. Kibishii has a generate and verify operation, both of these are triggered via commands stored into the etcd database. During an operation all pods run independently, generating or verifying data. Status is stored into etcd.
All Kibishii keys start with "/kibishii"
Each node will create an etcd tuple named "/kibishii/node/" which it starts. It will apply a lease to the key and if the node exits, the tuple will be automatically removed. If the tuple already exists, the node will refuse to start until the tuple is removed.
Nodes will watch the "/kibishii/control" key. When it is updated, all nodes will execute the given command. The value of the control key is a JSON with the following fields:
{ "opID":"<op ID - unique for this operation, a date/time stamp is good>", "cmd":"<command to execute, current options are generate and verify>", "levels":"", "dirsPerLevel":"", "filesPerLevel":"", "fileLength":"", "blockSize":"<blocksize to read/write>" }
When a node detects that an operation is started, it will count the number of nodes existing existing and attempt to insert a JSON with a status JSON with key "/kibishii/ops/ and the following fields:
{ "nodesStarting":", "nodesCompleted":"", "nodesSuccessful":"", "nodesFailed":"", "status":"<running, success, failure - success will only be set if all nodes completed successfully>" }
If the key already exists it will not change it.
When each node completes, it will retrieve the status json, note the revision number of the node, then update the node with its completion status. If the number of failed + successful nodes = the number of starting nodes, it will set the status to be success if no nodes are marked as failed and failed otherwise.
The Kibishii command line can be used to generate and verify Kibishii directory trees.
mvn clean install
docker build target/package/worker
The jump-pad is a container that is installed in the Kubernetes cluster to interact with the etcd database and control Kibishii
docker build target/package/jump-pad
- Multiple volumes per node and verification that volumes have been attached to nodes properly
- Verification of consistency with snapshots taken during the Kibishii run
- Application aware interfaces so that Kibishii can flush buffers, etc.
- Scale up/down of nodes and verification that number of nodes restored matches number of nodes at time of generation
