rt-bootstrapper

README

RT Bootstrapper

This repository contains the source code for the RT Bootstrapper Kyma component used to configure Kyma runtime components running in markets with individual infrastructure setups.

Overview

RT Bootstrapper contains two functional parts:

• Kubernetes admission webhook that intercepts the creation of Pods. It modifies the Pod specifications to include necessary configurations, modifies image paths to use the configured remote registry, and provides pull secrets with credentials.

• Kubernetes Controller that watches for namespaces and ensures that the secrets with required credentials are present and synchronized in those namespaces.

[!NOTE] This component is implemented as part of the Kyma runtime delivery.
Installing RT Bootstrapper in SAP BTP, Kyma runtime, or in a self-managed Kyma runtime cluster may negatively impact your workloads.

Installation

Prerequisites

• SAP BTP, Kyma runtime instance
• Access to the Kyma runtime cluster with kubeconfig

Installation with Kyma Control Plane

In environments with individual infrastructure setups, RT Bootstrapper is installed and configured automatically by Kyma Control Plane in all provisioned Kyma runtimes.

Installation with kubectl

To enable RT Bootstrapper in your Kyma cluster, apply the release manifest using kubectl:

kubectl apply -f https://github.com/kyma-project/rt-bootstrapper/releases/latest/download/rt-bootstrapper.yaml

Architectural Documentation

See README.md in docs/contributor folder.

Development

Prerequisites

• Access to a Kubernetes cluster
• Go
• k3d
• Docker
• kubectl
• Kubebuilder
• yq

Installation in the k3d Cluster Using Make Targets

1. Clone the project.

   git clone https://github.com/kyma-project/rt-boostrapper.git && cd rt-boostrapper/
   

2. Create a new k3d cluster and run RT Bootstrapper from the main branch:

   k3d cluster create test-cluster
   make deploy
   

Usage

To use RT Bootstrapper, label your Kubernetes namespaces and Pods accordingly.
The admission webhook intercepts the creation of these resources and applies the necessary configurations.

Contributing

See the Contributing Rules.

Code of Conduct

See the Code of Conduct document.

License

See the license file.