Skip to main content

Prerequisites

Before installing Jafra, prepare a local Kubernetes environment and the tools used by the installation workflow.

Local Kind environment​

Install the following command-line tools:

  • Docker
  • kubectl
  • Kind
  • Git

Confirm they are available:

docker version
kubectl version --client
kind version
git --version

Jafra's installer can install cert-manager for you. cert-manager is required because the Jafra Controller receives Kubernetes admission requests over TLS.

Create a cluster​

The examples use a Kind cluster named jafra:

kind create cluster --name jafra
kubectl cluster-info --context kind-jafra

If you use another name, set KIND_CLUSTER when running Jafra's scripts.

Building from source​

The standard installation builds images with Docker when they are not already available. The standalone multi-platform image builder uses Podman.

Install these toolchains only when developing or testing an individual component outside its container build:

  • Go for the Jafra Controller
  • Rust and protoc for the Jafra Agent
  • Java 21 and Maven for the Jafra Analyzer

The image build guide provides the correct command and build context for each component.

Kubernetes compatibility​

Jafra v0.0.1 uses node-local recording storage shared through a hostPath. The target cluster must allow those volumes for profiled workloads and the Jafra Agent. OpenShift is not supported by this release.