Progetto Kube-Knark

Traccia il tuo runtime Kubernetes !!

Kube-Knark è un tracer open source che utilizza la tecnologia pcap & ebpf per eseguire il tracciamento runtime su un cluster Kubernetes distribuito. Traccia le chiamate di esecuzione dell'API Kubernetes e le modifiche alle autorizzazioni dei file di configurazione del nodo master. Gli eventi di tracciamento corrispondenti vengono sfruttati tramite webhook dei plugin Go.

kube-knark traccia quanto segue :

• L'intera specifica dell'API Kubernetes chiamate di esecuzione, in particolare le mutazioni
  
• modifiche alle autorizzazioni dei file di configurazione del nodo master specifica CIS Kubernetes Benchmark

I dati di tracciamento di kube-knark vengono riportati :

• Dashboard della console
• Hook dei plugin Go

Console di kube-Knark:

• Requisiti
• Installazione
• Avvio rapido
• Utilizzo dei plugin utente
• Specifiche supportate
• Contributi

Requisiti

• Go 1.13+
• Linux Kernel 4.15+
• Clang 10+
• LLVM
• Kernel Headers
• Pcap

Installazione

git clone https://github.com/chen-keinan/kube-knark
cd kube-knark
make build

Avvio rapido

Esegui kube-knark senza plugin

 ./kube-knark 

Utilizzo dei plugin utente (tramite plugin Go)

Kube-knark espone 2 hook per i plugin utente Esempio :

• OnK8sAPICallHook - questo hook accetta l'evento di chiamata API k8s con tutti i dettagli (richiesta/risposta HTTP, specifica API corrispondente)
• OnK8sFileConfigChangeHook - questo hook accetta l'evento di modifica della configurazione del file master con i dettagli del comando (chown o chmod, argomenti e specifica di modifica del file corrispondente)

Compila il plugin utente

go build -buildmode=plugin -o=~/<cartella plugin>/<plugin>.so ~/<cartella plugin>/<plugin>.go

Copia il plugin nella cartella (la cartella .kube-knark viene creata al primo avvio)

cp ~/<cartella plugin>/<plugin>.so ~/.kube-knark/plugins/compile/<plugin>.so

Specifiche supportate

Kube-knark supporta 2 specifiche e può essere facilmente esteso:

• La specifica completa dell'API k8s Kubernetes API specification
• specifica di modifica del file di configurazione del master Master Node Config

entrambe le specifiche possono essere facilmente estese modificando i file delle specifiche nella cartella ~/.kube-knark/spec

Contributi

• contributi al codice sono benvenuti!! contributi con test e superamento del linter sono più che benvenuti :)
• la cartella /.dev include il file vagrantfile da utilizzare per lo sviluppo: Istruzioni per lo sviluppo