TrueChartsClone/docs/manual/development/portal.md

2.2 KiB

Portal Button

After installation almost every app should have a "portal" button. This button is an easy and streamlined way of entering the Applications after installation. However, one should be aware that it does not magically follow changes inside the application (for example: from http to https).

questions.yaml example

Every questions.yaml file should contain the following snippets to enable the portal button. Please be aware to change "http" to "https" in services.main.port.protocol if your application uses http instead of https when running using "NodePort".

Also please be aware that the portal only(!) points towards the main service, main service port and main ingress.

portals:
  web_portal:
    protocols:
      - "$kubernetes-resource_configmap_portal_protocol"
    host:
      - "$kubernetes-resource_configmap_portal_host"
    ports:
      - "$kubernetes-resource_configmap_portal_port"
		path: "/"

questions:

  - variable: portal
    group: "Container Image"
    label: "Configure Portal Button"
    schema:
      type: dict
      hidden: true
      attrs:
        - variable: enabled
          label: "Enable"
          description: "enable the portal button"
          schema:
            hidden: true
            editable: false
            type: boolean
            default: true

There are also some additional (advanced) options availale, these can be added below the above required portion as required:

ingressPort:

        - variable: ingressPort
          label: "Port when ingress is not using 443"
          description: "Advanced setting, please enter a different port to use if Ingress uses something other than port 443"
          schema:
            hidden: true
            editable: false
            type: int
            default: 8443

host:

        - variable: host
          label: "override Host when using NodePort"
          description: "Overrides the host setting when using NodePort. Example usecase would be loadbalanced NodePorts."
          schema:
            hidden: true
            editable: false
            type: string
            default: "test.com"
Known issues
  • Portal currently doesn't work (yet) when setting the servicetype to "Loadbalancer"