node-agent

README

NodeAgent

Prerequisites

1. Minikube Start minikube with the following command:

minikube start

1. Linux kernel version 5.4 and above.

Running the Node Agent

Make sure to set the NODE_NAME environment variable to the name of the node you want to scan. Also make sure you have the KUBECONFIG environment variable set to the path of your kubeconfig file. You can then build the binary by running:

go build .

Then run the binarty with root privileges:

sudo ./node-agent

Running Node Agent in Kubernetes

You can run the Node Agent in a Kubernetes cluster as part of Kubescape by using helm. Please refer to the docs for more information.

Limitations:

1. This feature is using eBPF technology that is implemented only on linux.
2. the linux kernel version that supported it 5.4 and above.

Debugging

file for vscode:

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Launch Package",
            "type": "go",
            "request": "launch",
            "mode": "auto",
            "program": "${workspaceFolder}/main.go",
            "env": {
                "NODE_NAME": "<node name>",
                "KUBECONFIG": "<path_to_kubeconfig>",
            },
            "console": "integratedTerminal",
            "asRoot": true,
        }
    ]
}

Changelog

Kubescape Node-agent changes are tracked on the release page