Configuration

The Tekton loads configuration data from a file (typically backed by a Kubernetes config map). The location of the configuration file is sourced from an environment variable. If the service is unable to retrieve the configuration data, it will not start. Refer to the configuration for details.

Service configuration structure

The recommended configuration format is YAML. The below sections describe the officially supported configuration options that influence various aspects of the service functionality. The service may support options other than the ones listed below, but those are not a part of the public API and may be changed or deleted at any time.

General

Tekton uses its service instance name and replica ID for communication with other services and load balancing across replicas (for example, see 3/ISM). You can control the values with the following configuration options:

service:
  instance:
    name: <string>          # Service instance name, should be unique cluster-wide. "tekton" by default.
    replica.id: <string>    # Service instance replica ID, should be unique cluster-wide. Random string by default.
  graceful-shutdown: <uint> # Allowed service graceful shutdown period in seconds. 30 seconds by default.

Tekton manages configuration of service instances defined by the below option.

kaa:
  service-instances: <map of service instances> # Map of service instance names that receive configuration from Tekton. Required.
    <service-instance-name>:                    # Service instance name.
      serviceName: <string>                     # Service name.
      serviceGroup: <string>                    # Service group name ("Communication", "Identity management", etc.).
      description: <string>                     # Service instance description.
      urlPrefix: <string>                       # Service instance REST API URL prefix (where applicable).
      appConfigurationSchema: <json>            # Service application-specific configuration JSON schema.
      appVersionConfigurationSchema: <json>     # Service application version-specific configuration JSON schema.

The REST API server is controlled with the following options.

server:
  port: <integer>           # Server port used to expose the REST API at, 80 by default.

Data persistence interface

Tekton uses MongoDB for persisting configuration data.

kaa:
  mongodb:
    name: <string>            # MongoDB database name. "tekton" by default.
    url: <string>             # MongoDB URL. "mongodb://mongodb:27017" by default.
    user: <string>            # MongoDB user (see note below)
    password: <string>        # MongoDB password (see note below)

NOTE For security reasons, username and password must be sourced from the environment variables.

NATS

The below parameters configure Tekton’s connection to NATS. Note that for security reasons NATS username and password are sourced from the environment variables.

nats:
  urls: <comma separated list of URL>  # NATS connection URLs. "nats://nats:4222" by default.

Authentication and authorization

Tekton’s REST API security is implemented according to OAuth2 protocol with a UMA profile.

Tekton security is controlled with the following configuration options (for security reasons it is advised to set these via environment variables).

kaa:
  security:
    enabled: <boolean>      # Enables authentication and authorization. False by default.
    issuer: <string>        # URL of the auth service.
    clientID: <string>      # Client ID for making requests to the auth service.
    clientSecret: <string>  # Client secret for making requests to the auth service.
    resource-url: <string>  # Auth server UMA-compliant endpoint for resource management. Defaults to issuer + "/authz/protection/resource_set".

Management

To control the Tekton management interface, use the following configuration options.

service.monitoring:
  disabled: <boolean>   # Disables the monitoring interface entirely. False by default (enabled).
  port: <uint>          # TCP port to expose the monitoring server on. 8080 by default.

Logging

Tekton writes logs to stdout. By default, the service only produces logs at startup, shutdown, or in case of errors. To enable debug level logging, use the following option:

service:
  debug: <boolean>    # Enables debug level logging, false by default (disabled).

Keep in mind that enabling debug level logging will produce significantly more log output and degrade the service performance.

Default configuration

Summarizing the above, the default Tekton configuration is as follows. Note that no Kaa service instances are defined by default—you have to configure those for any specific Kaa-based solution.

service:
  instance:
    name: "tekton"
    replica.id: "<random string generated on boot>"
  graceful-shutdown: 30
  monitoring:
    disabled: false
    port: 8080
  debug: false
server.port: 80
kaa:
  mongodb:
    name: "tekton"
    url: "mongodb://mongodb:27017"
  security.enabled: false
nats.urls: "nats://nats:4222"