Upgrade to Helm chart V2 (Self-Managed Enterprise)
Airbyte has upgraded its Helm chart to a new version called "V2." Upgrading to Helm chart V2 is currently optional. At some future date the V2 Helm chart will become the standard, so we advise that you upgrade your existing deployment to use the new chart before the transition. If you're a new Airbyte customer, you can skip the upgrade altogether and start with the new chart.
Follow the Core guide instead.
Why you should upgrade
Upgrading to the new Helm chart now has the following benefits.
-
By upgrading in advance, you can schedule this upgrade for a convenient time. Avoid blocking yourself from upgrading Airbyte to a future version when the new chart is mandatory and you're busy.
-
The new Helm chart doesn't require Keycloak. If you don't want to use Keycloak for authentication, or want to use generic OIDC, you must run Helm chart V2.
-
The new Helm chart is more aligned with Helm's best practices for chart design.
-
The new Helm chart has broader and more detailed options to customize your deployment. In most cases, it's no longer necessary to specify environment variables in your
values.yamlfile because the chart offers a more detailed interface for customization. If you do need to use environment variables, you can use fewer of them.
Which versions can upgrade to Helm chart V2
The following versions of Airbyte can use Helm chart V2:
- Airbyte version 1.6.0 and later, if installed and managed with Helm
The following versions of Airbyte can't use Helm chart V2:
-
Airbyte versions before 1.6.0
-
Airbyte versions installed and managed with abctl
Schedule time with Airbyte
Engage your Airbyte Solution Architect for help with this migration. We caution against doing it alone. Airbyte can provide guidance to help you manage uncommon customizations and verify the migration is successful.
How to upgrade
In most cases, upgrading is straightforward. To upgrade to Helm chart V2, you complete the following steps.
-
Ensure you have configured Airbyte to use an external database and external bucket storage
-
Prepare to deploy a fresh installation of Airbyte.
-
Create a new
values.yamlfile. -
Deploy a new version of Airbyte using your new
values.yamlfile and the new Helm chart version.