https://github.com/turbot/guardrails-agent-kubernetes

Docker container for Guardrails Kubernetes agent
https://github.com/turbot/guardrails-agent-kubernetes

dockerfile kubernetes osquery turbot-guardrails

Last synced: 17 days ago
JSON representation

Docker container for Guardrails Kubernetes agent

• Host: GitHub
• URL: https://github.com/turbot/guardrails-agent-kubernetes
• Owner: turbot
• License: apache-2.0
• Created: 2024-04-30T14:05:10.000Z (9 months ago)
• Default Branch: main
• Last Pushed: 2024-12-02T15:17:47.000Z (about 2 months ago)
• Last Synced: 2024-12-02T16:30:03.602Z (about 2 months ago)
• Topics: dockerfile, kubernetes, osquery, turbot-guardrails
• Language: Dockerfile
• Homepage: https://turbot.com/guardrails
• Size: 33.2 KB
• Stars: 1
• Watchers: 7
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Guardrails Agent for Kubernetes

![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)

[![Docker Image - Build and Release](https://github.com/turbot/guardrails-agent-kubernetes/actions/workflows/release.yaml/badge.svg)](https://github.com/turbot/guardrails-agent-kubernetes/actions/workflows/release.yaml)

This Guardrails agent is used to send Kubernetes cluster details to a [Turbot Guardrails](https://turbot.com/guardrails) workspace using osquery with the [guardrails-agent-kubernetes](https://github.com/turbot/helm-charts/tree/main/charts/guardrails-agent-kubernetes) Helm chart.

Please see [Guardrails Kubernetes Integration](https://turbot.com/guardrails/docs/integrations/kubernetes) for more information.

## Building

To build the image locally run the Docker build command:

```sh

docker build ./kubernetes/docker/ \

    -t guardrails-agent-kubernetes:latest \

    --build-arg OSQUERY_VERSION=5.14.1 \

    --build-arg KUBECTL_VERSION=1.31.3 \

    --build-arg EXTENSION_VERSION=1.2.0

```

- OSQUERY_VERSION: This argument specifies the version of osquery to be installed in the Docker image. osquery is an operating system instrumentation framework that makes operating system analytics and monitoring easier. In your Dockerfile, this version is used to download the specific osquery package from the official osquery repository.

- KUBECTL_VERSION: This argument specifies the version of kubectl to be installed in the Docker image. Kubectl is a command line tool for controlling Kubernetes clusters. In your Dockerfile, this version is used to download the specific kubectl binary from the official Kubernetes release page.

- EXTENSION_VERSION: This argument specifies the version of the osquery extension for Kubernetes to be installed in the Docker image. This extension allows osquery to interact with Kubernetes. In your Dockerfile, this version is used to download the specific osquery extension tarball from the [Steampipe Kubernetes plugin releases](https://github.com/turbot/steampipe-plugin-kubernetes/releases).

## Open Source & Contributing

This repository is published under the [Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0) (source code) and [CC BY-NC-ND](https://creativecommons.org/licenses/by-nc-nd/2.0/) (docs) licenses. Please see our [code of conduct](https://github.com/turbot/.github/blob/main/CODE_OF_CONDUCT.md). We look forward to collaborating with you!

## Get Involved

**[Join #guardrails on Slack →](https://turbot.com/community/join)**

Want to help but don't know where to start? Pick up one of the `help wanted` issues:

* [Guardrails Agent for Kubernetes](https://github.com/turbot/guardrails-agent-kubernetes/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22)