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.cx Custom Resource Definition (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:

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 ./...