Skip to content

Latest commit

 

History

History
108 lines (104 loc) · 7.87 KB

README.helm.md

File metadata and controls

108 lines (104 loc) · 7.87 KB
Raw

Korifi Helm chart

This documents the Helm chart for Korifi.

The chart is a composition of subcharts, one per component, with each individual component configuration nested under a top-level key named after the component itself. Values under the top-level global key apply to all components. Each component can be excluded from the deployment by the setting its include value to false. See Customizing the Chart Before Installing for details on how to specify values when installing a Helm chart.

Here are all the values that can be set for the chart:

  • global: Global values that are shared between Korifi and its subcharts.
    • containerRegistrySecret (String): Name of the Secret to use when pushing or pulling from package, droplet and kpack-build repositories. Required if eksContainerRegistryRoleARN not set. Ignored if eksContainerRegistryRoleARN is set.
    • containerRepositoryPrefix (String): The prefix of the container repository where package and droplet images will be pushed. This is suffixed with the app GUID and -packages or -droplets. For example, a value of index.docker.io/korifi/ will result in index.docker.io/korifi/<appGUID>-packages and index.docker.io/korifi/<appGUID>-droplets being pushed.
    • debug (Boolean): Enables remote debugging with Delve.
    • defaultAppDomainName (String): Base domain name for application URLs.
    • eksContainerRegistryRoleARN (String): Amazon Resource Name (ARN) of the IAM role to use to access the ECR registry from an EKS deployed Korifi. Required if containerRegistrySecret not set.
    • generateIngressCertificates (Boolean): Use cert-manager to generate self-signed certificates for the API and app endpoints.
    • rootNamespace (String): Root of the Cloud Foundry namespace hierarchy.
  • adminUserName (String): Name of the admin user that will be bound to the Cloud Foundry Admin role.
  • api:
    • apiServer:
      • internalPort (Integer): Port used internally by the API container.
      • port (Integer): API external port. Defaults to 443.
      • timeouts: HTTP timeouts.
        • idle (Integer): Idle timeout.
        • read (Integer): Read timeout.
        • readHeader (Integer): Read header timeout.
        • write (Integer): Write timeout.
      • url (String): API URL.
    • authProxy: Needed if using a cluster authentication proxy, e.g. Pinniped.
      • caCert (String): Proxy's PEM-encoded CA certificate (not as Base64).
      • host (String): Must be a host string, a host:port pair, or a URL to the base of the apiserver.
    • builderName (String): ID of the builder used to build apps. Defaults to kpack-image-builder.
    • expose (Boolean): Expose the API component via Contour. Set to false if you want to expose the API using other means.
    • image (String): Reference to the API container image.
    • include (Boolean): Deploy the API component.
    • lifecycle: Default lifecycle for apps.
      • stack (String): Stack.
      • stagingRequirements:
        • diskMB (Integer): Disk in MB for staging.
        • memoryMB (Integer): Memory in MB for staging.
      • type (String): Lifecycle type (only buildpack accepted currently).
    • replicas (Integer): Number of replicas.
    • resources: ResourceRequirements for the API.
      • limits: Resource limits.
        • cpu (String): CPU limit.
        • memory (String): Memory limit.
      • requests: Resource requests.
        • cpu (String): CPU request.
        • memory (String): Memory request.
    • userCertificateExpirationWarningDuration (String): Issue a warning if the user certificate provided for login has a long expiry. See time.ParseDuration for details on the format.
  • contourRouter:
    • include (Boolean): Deploy the contour-router component.
  • controllers:
    • image (String): Reference to the controllers container image.
    • namespaceLabels: Key-value pairs that are going to be set as labels on the namespaces created by Korifi
    • processDefaults:
      • diskQuotaMB (Integer): Default disk quota for the web process.
      • memoryMB (Integer): Default memory limit for the web process.
    • reconcilers:
      • app (String): ID of the workload runner to set on all AppWorkload objects. Defaults to statefulset-runner.
      • build (String): ID of the image builder to set on all BuildWorkload objects. Has to match api.builderName. Defaults to kpack-image-builder.
    • replicas (Integer): Number of replicas.
    • resources: ResourceRequirements for the API.
      • limits: Resource limits.
        • cpu (String): CPU limit.
        • memory (String): Memory limit.
      • requests: Resource requests.
        • cpu (String): CPU request.
        • memory (String): Memory request.
    • taskTTL (String): How long before the CFTask object is deleted after the task has completed. See time.ParseDuration for details on the format, an additional d suffix for days is supported.
    • workloadsTLSSecret (String): TLS secret used when setting up an app routes.
  • jobTaskRunner:
    • include (Boolean): Deploy the job-task-runner component.
    • jobTTL (String): How long before the Job backing up a task is deleted after completion. See time.ParseDuration for details on the format, an additional d suffix for days is supported.
    • replicas (Integer): Number of replicas.
    • resources: ResourceRequirements for the API.
      • limits: Resource limits.
        • cpu (String): CPU limit.
        • memory (String): Memory limit.
      • requests: Resource requests.
        • cpu (String): CPU request.
        • memory (String): Memory request.
  • kpackImageBuilder:
    • builderRepository (String): Container image repository to store the ClusterBuilder image. Required when clusterBuilderName is not provided.
    • clusterBuilderName (String): The name of the ClusterBuilder Kpack has been configured with. Leave blank to let kpack-image-builder create an example ClusterBuilder.
    • clusterStackBuildImage (String): The image to use for building defined in the ClusterStack. Used when kpack-image-builder is blank.
    • clusterStackRunImage (String): The image to use for running defined in the ClusterStack. Used when kpack-image-builder is blank.
    • include (Boolean): Deploy the kpack-image-builder component.
    • replicas (Integer): Number of replicas.
    • resources: ResourceRequirements for the API.
      • limits: Resource limits.
        • cpu (String): CPU limit.
        • memory (String): Memory limit.
      • requests: Resource requests.
        • cpu (String): CPU request.
        • memory (String): Memory request.
  • statefulsetRunner:
    • include (Boolean): Deploy the statefulset-runner component.
    • replicas (Integer): Number of replicas.
    • resources: ResourceRequirements for the API.
      • limits: Resource limits.
        • cpu (String): CPU limit.
        • memory (String): Memory limit.
      • requests: Resource requests.
        • cpu (String): CPU request.
        • memory (String): Memory request.