Skip to content

Commit 09a81bb

Browse files
docs: Remove Helm Chart V1 documentation for v2.1.0 release (#75964)
Co-authored-by: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
1 parent 0ddd166 commit 09a81bb

19 files changed

Lines changed: 103 additions & 3774 deletions

File tree

docs/platform/access-management/sso-providers/azure-entra-id.md

Lines changed: 2 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,6 @@ sidebar_label: Entra ID
33
products: cloud, oss-enterprise
44
---
55

6-
import Tabs from "@theme/Tabs";
7-
import TabItem from "@theme/TabItem";
8-
96
# Set up single sign on using Entra ID
107

118
This guide shows you how to set up Microsoft Entra ID (formerly Azure ActiveDirectory) and Airbyte so your users can log into Airbyte using your organization's identity provider (IdP) and OpenID Connect (OIDC).
@@ -197,11 +194,6 @@ To set up single sign on for Airbyte Self-Managed Enterprise, complete the follo
197194
- [Update Airbyte's values.yaml file](#sme-update-values)
198195
- [Redeploy Airbyte](#sme-deploy)
199196

200-
:::note
201-
You can only use generic OIDC after you migrate to Helm chart V2.
202-
<!-- [Helm chart V2](../../enterprise-setup/chart-v2-enterprise). -->
203-
:::
204-
205197
### Create application {#sme-entra-id-app}
206198

207199
To start, you create a new Entra ID application for Airbyte.
@@ -317,8 +309,8 @@ You collect these values from Microsoft in the locations shown below.
317309
In your command-line tool, deploy Airbyte using your updated values file.
318310

319311
```bash
320-
helm upgrade airbyte-enterprise airbyte-v2/airbyte \
321-
--namespace airbyte-v2 \ # Target Kubernetes namespace
312+
helm upgrade airbyte-enterprise airbyte/airbyte \
313+
--namespace airbyte \ # Target Kubernetes namespace
322314
--values ./values.yaml \ # Custom configuration values
323315
--version 2.x.x # Helm chart version to use
324316
```

docs/platform/access-management/sso-providers/okta.md

Lines changed: 5 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,6 @@ sidebar_label: Okta
33
products: oss-enterprise, cloud
44
---
55

6-
import Tabs from "@theme/Tabs";
7-
import TabItem from "@theme/TabItem";
8-
96
# Set up single sign on using Okta
107

118
This guide shows you how to set up Okta and Airbyte so your users can log into Airbyte using your organization's identity provider (IdP).
@@ -203,10 +200,10 @@ Create the application with the following parameters:
203200

204201
Once your Okta app is set up, you're ready to deploy Airbyte with SSO. Take note of the following configuration values, as you will need them to configure Airbyte to use your new Okta SSO app integration:
205202

206-
* Okta domain ([How to find your Okta domain](https://developer.okta.com/docs/guides/find-your-domain/main/))
207-
* App Integration Name
208-
* Client ID
209-
* Client Secret
203+
- Okta domain ([How to find your Okta domain](https://developer.okta.com/docs/guides/find-your-domain/main/))
204+
- App Integration Name
205+
- Client ID
206+
- Client Secret
210207

211208
(Optional) To allow users to access Airbyte directly from their Okta dashboard, configure IdP-Initiated Login. In the **General** tab of your Airbyte application, scroll to **Login initiated by** and configure the following settings:
212209

@@ -229,11 +226,6 @@ To set up single sign using generic OIDC for Airbyte Self-Managed Enterprise, co
229226
- [Update Airbyte's values.yaml file](#sme-values)
230227
- [Redeploy Airbyte](#sme-deploy)
231228

232-
:::note
233-
You can only use generic OIDC after you migrate to Helm chart V2.
234-
<!-- [Helm chart V2](../../enterprise-setup/chart-v2-enterprise). -->
235-
:::
236-
237229
### Create an Okta app for Airbyte {#sme-create-okta-app}
238230

239231
Follow these steps to set up an Okta app integration for Airbyte. If you need more help setting up an app integration, see [Okta's documentation](https://help.okta.com/en-us/content/topics/apps/apps_app_integration_wizard_oidc.htm).
@@ -370,6 +362,6 @@ helm upgrade -i \
370362
--namespace airbyte \
371363
--values ./values.yaml \
372364
airbyte \
373-
airbyte-v2/airbyte \
365+
airbyte/airbyte \
374366
--version 2.x.x
375367
```

docs/platform/connector-development/connector-builder-ui/custom-components.md

Lines changed: 2 additions & 60 deletions
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,6 @@
22
products: oss-community, oss-enterprise
33
---
44

5-
import Tabs from '@theme/Tabs';
6-
import TabItem from '@theme/TabItem';
7-
85
# Custom components for the Connector Builder
96

107
Use Custom Components to extend the Connector Builder with your own Python implementations when Airbyte's built-in components don't meet your specific needs.
@@ -59,22 +56,6 @@ If you deploy Airbyte with abctl, follow the steps below to update your values a
5956

6057
1. Edit your existing `values.yaml` file or create a new override file with this configuration:
6158

62-
<Tabs groupId="helm-chart-version">
63-
<TabItem value='helm-1' label='Helm chart V1' default>
64-
65-
```yaml title="values.yaml"
66-
workload-launcher:
67-
extraEnv:
68-
- name: AIRBYTE_ENABLE_UNSAFE_CODE
69-
value: "true"
70-
connector-builder-server:
71-
extraEnv:
72-
- name: AIRBYTE_ENABLE_UNSAFE_CODE
73-
value: "true"
74-
```
75-
</TabItem>
76-
<TabItem value='helm-2' label='Helm chart V2' default>
77-
7859
```yaml title="values.yaml"
7960
workloadLauncher:
8061
extraEnv:
@@ -86,10 +67,6 @@ If you deploy Airbyte with abctl, follow the steps below to update your values a
8667
value: "true"
8768
```
8869
89-
</TabItem>
90-
</Tabs>
91-
92-
9370
2. Use this file during deployment with the abctl command:
9471
9572
```bash
@@ -102,22 +79,6 @@ If you're deploying Airbyte using public Helm charts without abctl, follow the s
10279

10380
1. Edit your existing `values.yaml` file or create a new override file with this configuration:
10481

105-
<Tabs groupId="helm-chart-version">
106-
<TabItem value='helm-1' label='Helm chart V1' default>
107-
108-
```yaml title="values.yaml"
109-
workload-launcher:
110-
extraEnv:
111-
- name: AIRBYTE_ENABLE_UNSAFE_CODE
112-
value: "true"
113-
connector-builder-server:
114-
extraEnv:
115-
- name: AIRBYTE_ENABLE_UNSAFE_CODE
116-
value: "true"
117-
```
118-
</TabItem>
119-
<TabItem value='helm-2' label='Helm chart V2' default>
120-
12182
```yaml title="values.yaml"
12283
workloadLauncher:
12384
extraEnv:
@@ -129,34 +90,15 @@ If you're deploying Airbyte using public Helm charts without abctl, follow the s
12990
value: "true"
13091
```
13192
132-
</TabItem>
133-
</Tabs>
134-
13593
2. Apply the configuration during Helm installation or upgrade:
13694
137-
<Tabs groupId="helm-chart-version">
138-
<TabItem value='helm-1' label='Helm chart V1' default>
139-
14095
```bash
141-
helm upgrade airbyte airbyte-v2/airbyte \
142-
--namespace airbyte \ # Target Kubernetes namespace
143-
--values ./values.yaml \ # Custom configuration values
144-
```
145-
146-
</TabItem>
147-
<TabItem value='helm-2' label='Helm chart V2' default>
148-
149-
```bash
150-
helm upgrade airbyte airbyte-v2/airbyte \
151-
--namespace airbyte-v2 \ # Target Kubernetes namespace
96+
helm upgrade airbyte airbyte/airbyte \
97+
--namespace airbyte \ # Target Kubernetes namespace
15298
--values ./values.yaml \ # Custom configuration values
15399
--version 2.x.x # Helm chart version to use
154100
```
155101

156-
</TabItem>
157-
</Tabs>
158-
159-
160102
:::caution
161103
Monitor your deployment for any security or performance issues. Remember that this feature allows execution of arbitrary code in your Airbyte environment.
162104
:::

docs/platform/deploying-airbyte/chart-v2-community.mdx

Lines changed: 7 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -9,21 +9,19 @@ import HelmSyntaxConversion from '@site/static/_helm-chart-2-syntax-changes.md';
99

1010
# Upgrade to Helm chart V2 (Core)
1111

12-
Airbyte has upgraded its Helm chart to a new version called "V2." Using 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 user, you can skip the upgrade altogether and start with the new chart.
12+
As of Airbyte v2.1.0, Helm chart V1 is no longer supported. Helm chart V2 is now the only supported chart. If you haven't already upgraded, you must migrate to Helm chart V2 to continue receiving updates. If you're a new Airbyte user, you can skip this guide and start directly with the current chart — see [Deploying Airbyte](../deploying-airbyte/deploying-airbyte.md).
1313

1414
:::important Enterprise customers
1515
Follow the [Self-Managed Enterprise guide](../enterprise-setup/chart-v2-enterprise) instead.
1616
:::
1717

18-
## Why you should upgrade
18+
## Why you must upgrade
1919

20-
Upgrading to the new Helm chart now has the following benefits.
20+
Helm chart V1 is no longer supported as of Airbyte v2.1.0. You must upgrade to Helm chart V2 to continue receiving Airbyte updates. In addition to being required, the new chart has the following benefits:
2121

22-
1. 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.
22+
1. The new Helm chart is more aligned with Helm's best practices for chart design.
2323

24-
2. The new Helm chart is more aligned with Helm's best practices for chart design.
25-
26-
3. 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.yaml` file because the chart offers a more detailed interface for customization. If you do need to use environment variables, you can use fewer of them.
24+
2. 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.yaml` file because the chart offers a more detailed interface for customization. If you do need to use environment variables, you can use fewer of them.
2725

2826
## Which versions can upgrade to Helm chart V2
2927

@@ -33,9 +31,9 @@ The following versions of Airbyte can use Helm chart V2:
3331

3432
- Airbyte version 1.6.0 and later, if installed and managed with abctl version 0.30.0 or later (abctl uses Helm chart V2 by default starting with version 0.30.0)
3533

36-
The following versions of Airbyte _can't_ use Helm chart V2:
34+
The following versions of Airbyte _can't_ use Helm chart V2 directly:
3735

38-
- Airbyte versions before 1.6.0
36+
- Airbyte versions before 1.6.0 — you must first upgrade to at least 1.6.0 on Helm chart V1 before migrating to V2
3937

4038
- Airbyte installed and managed with abctl versions before 0.30.0
4139

0 commit comments

Comments
 (0)