Skip to content

setup-development-env.md

Latest commit

 

History

History
73 lines (52 loc) · 2.51 KB

setup-development-env.md

File metadata and controls

73 lines (52 loc) · 2.51 KB
Raw

Setup Development Environments

Runtime enforcer supports Tilt to run development environment in your local.

Pre-requisite

  • On a supported Linux host to run a local kubernetes cluster, install a one node kubernetes cluster.
  • Setup golang development environments.

Steps

  1. Clone the repository: git clone https://github.com/rancher-sandbox/runtime-enforcer.git.
  2. Install kubectl and helm.
  3. Install tilt.
  4. Install libbpf, so you can build ebpf programs at your local.
  5. Create tilt-settings.yaml based on tilt-settings.yaml.example.
  6. Run tilt up. Related resources should be built and deployed.

You can use this command to list the policy proposals:

kubectl get workloadpolicyproposals.security.rancher.io -A

Optional

golangci-lint

You may want to install a pre-commit hook for golangci-lint, so you can fix linter issues at your local.

  1. Install golangci-lint, e.g., go install github.com/golangci/golangci-lint/v2/cmd/golangci-lint@v2.6.0
  2. Install pre-commit hooks. You can also use tools like husky or pre-commit.
cat << EOF > .git/hooks/pre-commit
#!/bin/sh
golangci-lint-v2 run
EOF
chmod +x .git/hooks/pre-commit

If you are using pre-commit, you can run the following command to install the hooks we define in .pre-commit-config.yaml:

pre-commit install --install-hooks --hook-type pre-commit --overwrite
# if you want to disable the hook
pre-commit uninstall --hook-type pre-commit

Verified environment

  • Kind v1.32.2
  • Ubuntu 22.04.5 LTS with 6.8.0-52-generic kernel.

Run bpfvalidator on our ebpf instrumentation

As a first thing, install bpfvalidator on you machine downloading it from https://github.com/Andreagit97/bpfvalidator/releases, or build it from source.

From the root of the repo

# generate a binary with bpf tests called `tester`
go test -c ./internal/bpf/... -o tester
# install bpfvalidator on you machine https://github.com/Andreagit97/bpfvalidator/releases
bpfvalidator --config ./bpfvalidator-amd64-config.yaml --cmd="./tester -test.v"