diff --git a/README.md b/README.md index 76c7d8f..8eb2b98 100644 --- a/README.md +++ b/README.md @@ -25,6 +25,8 @@ kube-bench supports the tests for Kubernetes as defined in the CIS Benchmarks 1. By default kube-bench will determine the test set to run based on the Kubernetes version running on the machine. +There is also preliminary support for Red Hat's Openshift Hardening Guide for 3.10 and 3.11. Please note that kube-bench does not automatically detect Openshift - see below. + ## Installation You can choose to @@ -47,14 +49,14 @@ You can even use your own configs by mounting them over the default ones in `/op docker run --pid=host -v /etc:/etc:ro -v /var:/var:ro -t -v path/to/my-config.yaml:/opt/kube-bench/cfg/config.yaml aquasec/kube-bench:latest [master|node] ``` -> Note: the tests require either the kubelet or kubectl binary in the path in order to know the Kubernetes version. You can pass `-v $(which kubectl):/usr/bin/kubectl` to the above invocations to resolve this. +> Note: the tests require either the kubelet or kubectl binary in the path in order to auto-detect the Kubernetes version. You can pass `-v $(which kubectl):/usr/bin/kubectl` to the above invocations to resolve this. ### Running in a kubernetes cluster You can run kube-bench inside a pod, but it will need access to the host's PID namespace in order to check the running processes, as well as access to some directories on the host where config files and other files are stored. Master nodes are automatically detected by kube-bench and will run master checks when possible. -The detection is done by verifying that mandatory components for master are running. (see [config file](#configuration). +The detection is done by verifying that mandatory components for master, as defined in the config files, are running (see [Configuration](#configuration)). The supplied `job.yaml` file can be applied to run the tests as a job. For example: @@ -121,6 +123,9 @@ go build -o kube-bench . ./kube-bench ``` +## Running on OpenShift + +kube-bench includes a set of test files for Red Hat's OpenShift hardening guide for OCP 3.10 and 3.11. To run this you will need to specify `--version ocp-3.10` when you run the `kube-bench` command (either directly or through YAML). This config version is valid for OCP 3.10 and 3.11. ## Configuration