/package-for-service-binding

Kubernetes-native package for Service Binding, a standard and automated way for communicating service secrets to workloads

Primary LanguageMakefileApache License 2.0Apache-2.0

Service Binding

Test Workflow Release Workflow The SLSA Level 3 badge The Apache 2.0 license badge Follow us on Twitter

A Carvel package for Service Binding, a standard and automated way for communicating service secrets to workloads.

🚀  Getting Started

Prerequisites

  • Kubernetes 1.29+

  • Carvel kctrl CLI.

  • Carvel kapp-controller deployed in your Kubernetes cluster. You can install it with Carvel kapp (recommended choice) or kubectl.

    kapp deploy -a kapp-controller -y \
  -f https://github.com/carvel-dev/kapp-controller/releases/latest/download/release.yml

Dependencies

Service Binding requires cert-manager. You can install it from the Kadras package repository.

Installation

Add the Kadras package repository to your Kubernetes cluster:

kctrl package repository add -r kadras-packages \
  --url ghcr.io/kadras-io/kadras-packages \
  -n kadras-system --create-namespace
Installation without package repository The recommended way of installing the Service Binding package is via the Kadras package repository. If you prefer not using the repository, you can add the package definition directly using kapp or kubectl. 
kubectl create namespace kadras-system
kapp deploy -a service-binding-package -n kadras-system -y \
  -f https://github.com/kadras-io/package-for-service-binding/releases/latest/download/metadata.yml \
  -f https://github.com/kadras-io/package-for-service-binding/releases/latest/download/package.yml

Install the Service Binding package:

kctrl package install -i service-binding \
  -p service-binding.packages.kadras.io \
  -v ${VERSION} \
  -n kadras-system

Note You can find the ${VERSION} value by retrieving the list of package versions available in the Kadras package repository installed on your cluster.

kctrl package available list -p service-binding.packages.kadras.io -n kadras-system

Verify the installed packages and their status:

kctrl package installed list -n kadras-system

📙  Documentation

Documentation, tutorials and examples for this package are available in the docs folder. For documentation specific to Service Binding, check out servicebinding.io.

🛡️  Security

The security process for reporting vulnerabilities is described in SECURITY.md.

🖊️  License

This project is licensed under the Apache License 2.0. See LICENSE for more information.