Application

The KOTS Application custom resource enables features such as branding, release notes, port forwarding, dashboard buttons, app status indicators, and custom graphs.

With ports specified, the KOTS CLI can establish port-forwarding, to simplify connections to the deployed application.
When statusInformers are specified, the dashboard can provide timely feedback when the application deployment is complete and the application is ready for use. This CR is optional for KOTS applications.

There is some overlap between the KOTS Application spec and the Kubernetes SIG Application spec. In time, it’s likely that the SIG Application spec will grow to include all the necessary metadata to support the full KOTS features.

In the meantime, enabling features (such as dashboard buttons to the application) requires the use of both the KOTS Application spec and the SIG Application spec.

The Application spec contains vendor-supplied metadata about the application.

apiVersion: kots.io/v1beta1
kind: Application
metadata:
  name: my-application
spec:
  title: My Application
  icon: https://support.io/img/logo.png
  releaseNotes: These are our release notes
  allowRollback: false
  kubectlVersion: latest
  kustomizeVersion: latest
  requireMinimalRBACPrivileges: false
  additionalImages:
    - jenkins/jenkins:lts
  additionalNamespaces:
    - "*"
  ports:
    - serviceName: web
      servicePort: 9000
      localPort: 9000
      applicationUrl: "http://web"
  statusInformers:
    - deployment/my-web-svc
    - deployment/my-worker
  graphs:
    - title: User Signups
      query: 'sum(user_signup_events_total)'

title

The application title. This will be used on the license upload and in various places in the Admin Console.

icon

The icon file for the application. This will be used on the license upload and in various places in the Admin Console.

releaseNotes

The release notes for this version. These can also be set when promoting a release.

allowRollback

This defaults to false. Enable to create a “Rollback” button on the end-customer Verison History page.

additionalNamespaces

An optional array of namespaces as strings. In addition to creating these namespaces, the Admin Console will ensure that a secret named kotsadm-replicated-registry exists in them, and that this secret has access to pull the application images (both images that are used and additionalImages). For access to dynamically created namespaces, "*" can be specified. See the Additional Namespaces documentation for more information.

additionalImages

An optional array of strings that reference images to be included in airgap bundles and pushed to the local registry during installation. While KOTS detects images from the PodSpecs in the application, some applications (Operators) may need to include additional images that will not be referenced until runtime.

kubectlVersion

This defaults to latest which will use the newest version from the list below. Valid values are:

• 1.14.9
• 1.16.3
• 1.17.13 (added in KOTS 1.22.0)
• 1.18.10 (added in KOTS 1.22.0)
• 1.19.3 (added in KOTS 1.22.0) Semver ranges are also supported, as defined in blang semver range (like >1.16.0 <1.17.0). The latest version within the provided range will be used. If the specified version or range does not match any supported versions, the latest version from the above list will be used.

kustomizeVersion

This defaults to latest, but can be changed to 3.5.4 to use a specific version of kustomize to render your app’s yaml. Currently only 3.5.4 is supported, but patch versions may change and newer versions may be added in the future.

requireMinimalRBACPrivileges

When set to true, this will instruct the KOTS installer to create a namespace-scoped Role and RoleBinding, instead of the default cluster-scoped ClusterRole and ClusterRoleBinding. For more information, see the RBAC documentation.

ports

These are extra ports (additional to the :8800 admin console port) that should be port-forwarded when running the kots admin-console command.

serviceName

The name of the service that has a ClusterIP type that should receive the traffic.

servicePort

The ClusterIP port to forward traffic to.

localPort

If set, the port to map on the local workstation. If not set, this will be the same as servicePort.

applicationUrl

This should match a service found in the k8s.io Application spec.

statusInformers

Resources to watch and report application status back to the user. In the format [namespace/]type/name where namespace is optional. Entries support template functions. For example, a specific status informer can be excluded based on an application config value like so:

statusInformers:
    - deployment/my-web-svc
    - '{{repl if ConfigOptionEquals "option" "value"}}deployment/my-worker{{repl else}}{{repl end}}'

graphs

Custom graphs to include on your Admin Console application dashboard.

title

The graph title.

query

The Prometheus query.

legend

The legend to use for the query line. Can be templated with each element returned from the Prometheus query. Template escape sequence is {{}}.

queries

A list of queries containing a query and legend.

• query: The Prometheus query
• legend: The legend to use for the query line. Can be templated with each element returned from the Prometheus query. Template escape sequence is {{}}.

yAxisFormat

The format of the Y axis labels with support for all Grafana units.

yAxisTemplate

Y axis labels template. Use {{ value }}.