Skip to content

Huddo Boards Docker

Authentication

Logging-in doesn't work

Please revoke your OAuth access to Huddo Boards Cloud within HCL Connections. Go to https://<YOUR_CONNECTIONS_URL>/connections/oauth/apps (replacing <YOUR_CONNECTIONS_URL>) and press 'Revoke'

Application Access


Kubernetes Ingress Controller Version

To check the version of the ingress controller run this command

kubectl get pods --all-namespaces | grep ingress-controller
kubectl exec -it <POD_NAME> -n <NAMESPACE> -- /nginx-ingress-controller --version

where

  • <POD_NAME> is the name of the Ingress controller pod
  • <NAMESPACE> is the namespace of the Ingress controller pod. e.g. kube-system or connections

For example

kubectl get pods --all-namespaces | grep ingress
kubectl exec -it nginx-ingress-controller-84d4dfc9b-7gv4m -n kube-system -- /nginx-ingress-controller --version

Example

-------------------------------------------------------------------------------
NGINX Ingress controller
  Release:    0.23.0
  Build:      git-be1329b22
  Repository: https://github.com/kubernetes/ingress-nginx
-------------------------------------------------------------------------------

As of 0.22.0 the Ingress controller rewrite-target definition changed. If Boards is installed at a context root, the format must include a regular expression which is now set as the default as of the helm chart v2.0.1. We recommend using the latest kudos-boards-cp-3.0.1.tgz which includes all required annotations (including socket.io cookie fix).

If you have an older Ingress controller version (i.e. 0.20) you will need to apply the following customisations to fix the ingress with charts as of v2.0.1

webfront:
  ingress:
    path: /boards
    annotations:
      nginx.ingress.kubernetes.io/rewrite-target: /

core:
  ingress:
    path: /api-boards
    annotations:
      nginx.ingress.kubernetes.io/rewrite-target: /
      nginx.ingress.kubernetes.io/session-cookie-path: /api-boards; Secure
      nginx.ingress.kubernetes.io/affinity: cookie
      nginx.ingress.kubernetes.io/proxy-body-size: 50m
      nginx.ingress.kubernetes.io/proxy-read-timeout: "3600"
      nginx.ingress.kubernetes.io/proxy-send-timeout: "3600"

Customizing Boards Context Root

If you wish to deploy boards at a path other than /boards & /api-boards please see this example file of all the variables to merge into your YAML config file.

Note: If you are using an older version of the Ingress controller (< 0.22) you will need to use example above


No real time updates (eg Rich Text not editable)

Some deployments may encounter an issue where you are unable to see any real time updates. If this is the case, it is likely that the socket is unable to connect or authenticate. Please update to the latest Boards helm chart (kudos-boards-cp-3.0.1.tgz or kudos-boards-5.0.0.tgz) which includes new annotations for increased browser cookie security requirements.

Note: if you have a core.annotations section in your yaml configuration our updates will be overwritten. Custom annotations should only be required when customizing the context root as per above. Please remove the annotations section otherwise.

Additional for WebSphere IHS

If you are using WebSphere IHS as your reverse proxy in front of Boards, please set the following environment variables to force polling instead of sockets

webfront:
  env:
    FORCE_POLLING: true