Skip to content

How to upgrade the HAProxy Package chart📜

BigBang makes modifications to the upstream helm chart. The full list of changes is at the end of this document.

  1. Find the current and latest release notes from the release page. Be aware of changes that are included in the upgrade. Take note of any manual upgrade steps that customers might need to perform, if any.
  2. Do diff of upstream chart between old and new release tags to become aware of any significant chart changes. A graphical diff tool such as Meld is useful. You can see where the current helm chart came from by inspecting /chart/kptfile or for an easier way to see the changes skip forward to the KPT instructions.
  3. Create a development branch and merge request from the Gitlab issue.
  4. Merge/Sync the new helm chart with the existing HAProxy package code. A graphical diff tool like Meld is useful. Reference the “Modifications made to upstream chart” section below.
    1. An easy way to do this is with KPT
    2. In chart/Kptfile update .upstream.git.ref to the tag of the release you found earlier.
    3. Run the following.
      kpt pkg update chart --strategy force-delete-replace
  5. Do the modifications found below.
  6. Update / with an entry for “upgrade HAProxy to app version X.X.X chart version X.X.X-bb.X”. Or, whatever description is appropriate.
  7. Update the / following the gluon library script
  8. Update /chart/Chart.yaml to the appropriate versions. The annotation version should match the appVersion (you will likely need to change that in the modifications below).
    version: X.X.X-bb.X
    appVersion: X.X.X
    annotations: |
        - HAProxy: vX.X.X
  9. Use a development environment to deploy and test HAProxy. See more detailed testing instructions below. Also test an upgrade by deploying the old version first and then deploying the new version.
  10. When the Package pipeline runs expect the cypress tests to fail due to UI changes.
  11. Update the / again if you have made any additional changes during the upgrade/testing process.

Testing a new HAProxy version📜

  1. Create a k8s dev environment. One option is to use the Big Bang with no arguments which will give you the default configuration. The following steps assume you are using the script.
  2. Follow the instructions at the end of the script to connect to the k8s cluster and install flux.
  3. Deploy HAProxy with these dev values overrides. Core apps are disabled for quick deployment.
      enabled: true
      enabled: true
        enabled: true
        injection: "disabled"
  4. Ensure that the pod authservice-haproxy-sso-* comes up.
  5. Browse to
  6. You should get redirected to an SSO page.

Note: if you’d like to test further you can use the instructions for authservice to spin up a local sso workflow and test it to get to prometheus using haproxy.

Modifications made to upstream chart📜

This is a high-level list of modifications that Big Bang has made to the upstream helm chart. You can use this as as cross-check to make sure that no modifications were lost during the upgrade process.


  • Append -bb.0 to .version.
  • Update the .appVersion to the value that you find for .image.tag in chart/values.yaml
  • Add the annotations."" as described above.


  • After the license add the BigBang additions back.
    ## BigBang additions:
    - name: private-registry
    usePSP: false
  • Switch the .image.repository back to the registry1 upstream.
      repository:    # can be changed to use CE or EE images
  • Switch the .image.tag to the latest version on ironbank.
  • Update the .existingImagePullSecret to private-registry.
  • Merge this in.
      create: false
  • Update the .securityContext
      enabled: false
      runAsUser: 1000
      runAsGroup: 1000
  • Update the .resources
        cpu: 100m
        memory: 500Mi
        cpu: 100m
        memory: 500Mi

Last update: 2023-10-24 by Michael Martin