Skip to content

Basic App#

Basic apps are apps which do not need to pull from the internet manifests and require manual creation of manifests. This is useful for your own custom applications, where you do not have a manifest file accessible from a public URL or a helm chart.

In principal they are quite similar to manifest typed apps.

The following is a valid kga.yaml configuration:

kind: kga-app
version: v1alpha
name: foo
spec:
  type: basic
  exclude:
  - kind: Secret

Firt run the kga init basic <app\> command, then the user is expected to the add manifests according to the following rules:

  • base/manifests: Generic manifests for the app (e.g. no ingress rules). We should be able to copy/paste this into another kga basic app without any issues.
  • base/kustomization.yaml: List all the manifests from base/manifests in the resources list.
  • overlay/resources: Application instance resources, e.g. Namespace, Ingress, ConfigMap etc.
  • overlay/patches: Patches to fix the base/manifests manifests.
  • overlay/kustomization.yaml: List all the manifests from overlay/resources, list all overlay/patches and import base
  • kustomization.yaml: Import overlay.

Once you finish editing your manifests run:

kustomize build <app>

To verify if the manifests have been correctly overridden, patched and additional resources added.