groups:
  - name: Image
    description: |
      Configured the images to be used for the Chart.
      It's wise to use "digest pinned" tags and to avoid using "latest".

      Checkout the following documentation for more information:
      - https://truecharts.org/common/#images


  - name: General
    description: |
      For TrueNAS SCALE We've grouped a number of settings here, that all effact how apps run in general.

      Checkout the following documentation for more information:
        - https://truecharts.org/common/global/
        - https://truecharts.org/common/#tz
        - https://truecharts.org/common/podoptions/
        - Image Pull Secrets


  - name: Workload
    description: |
      These settings configure how the actual Pods and containers are running.
      Generally, on SCALE, we only expose a limited subset of these settings for the primary workload and container.

      Checkout the following documentation for more information:
      - https://truecharts.org/common/workload/
      - https://truecharts.org/common/container/


  - name: App Configuration
    description: |
       Every application has different values that may be required to run or have multiple options that the user may choose to enable or disable to change the behavior of the application.
       Most options should have a Tooltip (Circled Question Mark) to further describe said option.

       To find more information, lookup your chart-specific documentation in the Charts List: https://truecharts.org/charts/description-list/

  - name: Services
    description: |
      Service and Networking options for any applications are contained here.
      Some applications may have complicated networking setups with multiple options or some may have no options here at all.

      Options here include the service and port configurations for the application, and more may be enabled or changed under the Advanced Settings and Show Expert Config boxes.

      Checkout the following documentation for more information:
      - https://truecharts.org/common/service/

  - name: Networking
    description: |
      Contains advanced networking options that are not actively supported by the TrueCharts team.
      Currently only contains scaleExternalInterfaces.

      Checkout the following documentation for more information:
      - https://truecharts.org/common/scaleexternalinterface/

  - name: Persistence
    description: |
      Many applications will have certain options for storage to be configurable by the user, the main two being PVC and hostpath but may include other types.
      This storage is called Persistence since it is not deleted upon restart or upgrade of an application.

      Checkout the following documentation for more information:
      - https://truecharts.org/common/persistence/
      - https://truecharts.org/scale/guides/nfs-share/
      - https://truecharts.org/general/faq/#why-pvc-is-recommended-over-hostpath


  - name: Ingress
    description: |
      Ingress (more commonly known as Reverse Proxy) settings can be configured here. This is how Kubernetes connects your Applications in containers to FQDNs (fully qualified domain names).
      If you choose to enable this you must have a "Ingress Provider" aka "Reverse Proxy" installed (We highly advice Traefik: https://truecharts.org/charts/premium/traefik/)
      It also requiresa DNS service to actually resolve the DNS name of the FQDN specified.

      Checkout the following documentation for more information:
      - https://truecharts.org/common/ingress/


  - name: SecurityContext
    description: |
      The security settings for each application and/or permissions that each application may have for the files/directories created.
      Each application will come with predefined permissions but users may want to change certain setting depending on their usage or capabilities.

      Unless necessary users are advised to keep this section mostly to defaults.

      Checkout the following documentation for more information:
      - https://truecharts.org/common/securitycontext/


  - name: Resources
    description: |
      Resources limits that have been defined by each application are in this section.
      Most will have a specific default that some users may want to change based on their specific hardware or needs.

      This also contains the options to mount GPUs or, more precisely, "request" GPU's to be mounted.

      Checkout the following documentation for more information:
      - https://truecharts.org/common/resources/

  - name: Devices
    description: |
      These are special "mountpoints" that can be used to mount miscelanious USB and PCI devices using special hostPath mounts.
      For clearity we've decided to seperate this from persistence on SCALE.

      Checkout the following documentation for more information:
      - https://truecharts.org/common/persistence/device/
      - https://truecharts.org/scale/guides/pci-passthrough/

  - name: Middlewares
    description: Traefik Middlewares

  - name: StorageClass
    description: |
      StorageClasses define where to storage Storage.

      Checkout the following documentation for more information:

  - name: Metrics
    description: |
      Contains options to configure Prometheus metrics for the application.

      Checkout the following documentation for more information:
      - https://truecharts.org/common/metrics/


  - name: Addons
    description: |
      Addons that are supplied by the TrueCharts team to add additional capabilities for users to use on top of the application’s defaults.
      Things included here are VPN addons, Codeserver for editing files inside the application’s container, Netshoot for network troubelshooting, etc.

      Generally not required for use but may be necessary or usefull at times for specific applications.

      Checkout the following documentation for more information:
      - https://truecharts.org/common/addons/
      - https://truecharts.org/scale/guides/vpn-setup/


  - name: Experimental
    description: |
      Experimental Configuration Options
      Often these are not fully flushed-out, could randomly break or might not work at-all.

  - name: Postgresql
    description: |
      For Postgresql we use "CloudNative-PG" as a backend, which has to be installed first.

      Checkout the following documentation for more information:
      - https://truecharts.org/common/cnpg/
      - https://truecharts.org/scale/guides/sql-export/
      - https://truecharts.org/scale/guides/recover-cnpg/

  - name: Dependencies
    description: |
      contains dependency setting for which we, currently, do not have seperate catagories (yet)


  - name: Documentation
    description: |
      We added this section to make everyone aware that OpenSource isn't always easy.
      It doesn't keep existing without signficant ongoing support, so please consider supporting TrueCharts and other OpenSource projects.

      Before installing, be sure you've followed the https://truecharts.org/scale/guides/getting-started/
      We would also advice going over our https://truecharts.org/scale/guides/scale-intro/
      and many of the other documentation pages...

questions:
  - variable: global
    group: General
    label: "Global Settings"
    schema:
      additional_attrs: true
      type: dict
      attrs:
        - variable: stopAll
          label: Stop All
          description: "Stops All Running pods and hibernates cnpg"
          schema:
            type: boolean
            default: false



  - variable: zfs-localpv
    group: "App Configuration"
    label: "ZFS Localpv Settings"
    schema:
      type: dict
      additional_attrs: true
      hidden: true
      attrs:
        - variable: enabled
          label: "enabled"
          schema:
            type: boolean
            default: true
            hidden: true
  - variable: localpv-provisioner
    group: "App Configuration"
    label: "localpv-provisioner Settings"
    schema:
      type: dict
      additional_attrs: true
      hidden: true
      attrs:
        - variable: enabled
          label: "enabled"
          schema:
            type: boolean
            default: false
            hidden: true
        - variable: hostpathClass
          label: "hostpathClass"
          schema:
            additional_attrs: true
            type: dict
            attrs:
              - variable: enabled
                label: "enabled"
                schema:
                  type: boolean
                  default: false
                  hidden: true


  - variable: storageClass
    group: StorageClass
    label: "StorageClass Settings"
    schema:
      type: dict
      additional_attrs: true
      attrs:
        - variable: zfs-main
          label: "ZFS Localpv Settings"
          schema:
            type: dict
            additional_attrs: true
            attrs:
              - variable: enabled
                label: "enabled"
                schema:
                  type: boolean
                  default: true
              - variable: provisioner
                label: "provisioner"
                schema:
                  type: string
                  default: "zfs.csi.openebs.io"
                  hidden: true
                  required: true
              - variable: isDefault
                label: "Default Class"
                schema:
                  type: boolean
                  default: true
              - variable: reclaimPolicy
                label: "reclaimPolicy"
                schema:
                  type: string
                  required: true
                  default: "Retain"
                  enum:
                    - value: Retain
                      description: Retain (Keep Data on App Deletion)
                    - value: Delete
                      description: Delete (Delete data on App Deletion)
              - variable: allowVolumeExpansion
                label: "Allow VolumeExpansion"
                schema:
                  type: boolean
                  default: true
              - variable: parameters
                label: "parameters"
                schema:
                  type: dict
                  additional_attrs: true
                  attrs:
                    - variable: poolname
                      label: "Pool/Dataset"
                      description: "Please use a correct Poolname/datasetname. Do NOT use /mnt/ thats a path not a pool/dataset name, use something like tank/apps"
                      schema:
                        type: string
                        default: ""
                        valid_chars: '^(?!.*\\)(?!.*ix-applications)[^\/]+(\/[^\/]+)+$'
                        required: true
                    - variable: fstype
                      label: "fstype"
                      schema:
                        type: string
                        default: "zfs"
                        hidden: true
                        required: true
                    - variable: shared
                      label: "shared"
                      schema:
                        type: string
                        default: "yes"
                        hidden: true
                    - variable: thinprovision
                      label: "thinprovision"
                      schema:
                        type: string
                        default: "yes"
                        hidden: true
                    - variable: compression
                      label: "compression"
                      schema:
                        type: string
                        default: "zstd-6"
                        hidden: true
                    - variable: recordsize
                      label: "recordsize"
                      schema:
                        type: string
                        default: "64k"
                        hidden: true
                    - variable: dedup
                      label: "dedup"
                      schema:
                        type: string
                        default: "off"
                        hidden: true
                    ## TODO: Add later
                    #- variable: encryption
                    #  label: "dedup"
                    #  schema:
                    #    type: string
                    #    default: "off"
                    #    hidden: true