service-binding-usage-controller/

README

Service Binding Usage Controller

Overview

The Service Binding Usage Controller injects the ServiceBindings into a given application using the ServiceBindingUsage resource, which allows this application to bind to a given ServiceInstance. The ServiceBindingUsage is a Kubernetes custom resource which is Namespace-scoped. For the custom resource definition, see the ServiceBindingUsage CRD file. For more detailed information on the Service Binding Usage Controller, see the docs folder in this repository.

Prerequisites

To set up the project, download these tools:

• Go 1.11.4
• Dep v0.5.0
• Docker

These Go and Dep versions are compliant with the buildpack used by Prow. For more details read this document.

Usage

This section explains how to use the Service Binding Usage Controller.

Run a local version

To run the application without building the binary file, run this command:

APP_KUBECONFIG_PATH=/Users/$User/.kube/config APP_LOGGER_LEVEL=debug go run cmd/controller/main.go

For the description of the available environment variables, see the Use environment variables section.

Use environment variables

Use the following environment variables to configure the application:

Name	Required	Default	Description
APP_PORT	No	3000	The port on which the HTTP server listens.
APP_LOGGER_LEVEL	No	info	Show detailed logs in the application.
APP_KUBECONFIG_PATH	No	None	The path to the kubeconfig file that you need to run an application outside of the cluster.
APP_PLUGGABLE_SBU	No	false	The feature flag that enables pluggable binding usage by UsageKind resources.

Development

Use the make verify command to test your changes before each commit. To build an image, use the make build-image command with DOCKER_PUSH_REPOSITORY and DOCKER_PUSH_DIRECTORY variables, for example:

DOCKER_PUSH_REPOSITORY=eu.gcr.io DOCKER_PUSH_DIRECTORY=/kyma-project/develop make build-image