api_controller

README

API Controller

Overview

The Kyma API Controller is a core component that manages Istio authentication policies and VirtualServices, and allows to expose services using the Kyma Console or API resources. It is implemented according to the Kubernetes Operator principles and operates on api.gateway.kyma-project.io CustomResourceDefinition (CRD) resources.

This Helm chart defines the component's installation.

Prerequisites

You need these tools to work with the API Controller:

• Go distribution
• Docker

Details

This section describes how to run the controller locally, how to build the Docker image for the production environment, how to use the environment variables, and how to test the Kyma API Controller.

Run the component locally

Run Minikube with Istio to use the API Controller locally. Run this command to run the application without building the binary:

$ go run cmd/controller/main.go

Use environment variables

Use these environment variables to configure the application:

Name	Required	Default	Description	Possible values
API_CONTROLLER_LOG_LEVEL	No	info	Show detailed logs in the application.	info, debug
DEFAULT_ISSUER	Yes	-	Used to set default issuer in NetworkPolicy.	any string
DEFAULT_JWKS_URI	Yes	-	Used to set default jwksUri in NetworkPolicy.	any string
GATEWAY_FQDN	Yes	-	Used to set gateway in the VirtualServices specification.	any string
DOMAIN_NAME	Yes	-	Used to set a hostname in the VirtualServices specification if a short version of the hostname is provided.	any string

Test

Run all tests:

$ go test -v ./...

Run all tests with coverage:

$ go test -coverprofile=coverage_report.out -v ./...

Run unit tests only:

$ go test -short -v ./...

Run unit tests with coverage:

go test -short -coverprofile=coverage_report.out -v ./...

Run integration tests only:

$ go test -run Integration -v ./...