Skip to content

replace nginx with traefik based documentation references - #1109

Open
ibrokethecloud wants to merge 1 commit into
harvester:mainfrom
ibrokethecloud:nginx-removal
Open

replace nginx with traefik based documentation references#1109
ibrokethecloud wants to merge 1 commit into
harvester:mainfrom
ibrokethecloud:nginx-removal

Conversation

@ibrokethecloud

Copy link
Copy Markdown
Contributor

Problem:

With Harvester v1.9.0 we are deprecating nginx as the ingress controller.

Solution:

The PR introduces docs updates to deprecate nginx based ssl settings and introduce new traefik-default-tls-options setting.

In addition the latest documentation is updated to reflect common debugging / status check scenarios for traefik components.

Related Issue(s):

harvester/harvester#10067

Test plan:

Additional documentation or context

…acked settings

Signed-off-by: Gaurav Mehta <gaurav.mehta@suse.com>
@github-actions

Copy link
Copy Markdown
Name Link
🔨 Latest commit ae23294
😎 Deploy Preview https://6a86799acfd3423a293943c7--harvester-preview.netlify.app

@jillian-maroket jillian-maroket left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review done

Comment thread docs/advanced/settings.md
```

### `ssl-parameters`
### `ssl-parameters` Deprecated as of v1.9.0 (Use traefik-default-tls-options instead.)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
### `ssl-parameters` Deprecated as of v1.9.0 (Use traefik-default-tls-options instead.)
### `ssl-parameters`
**Versions**: Deprecated as of v1.9.0 (Use `traefik-default-tls-options` instead.)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is how we present the deprecation info for vip-pools.

Comment thread docs/advanced/settings.md
Comment on lines +912 to +924
:::info important

Replaces `ssl-parameters` setting applicable for nginx ingress controller.

If you misconfigure this setting and are unable to access the Harvester UI and API, see [Troubleshooting](../troubleshooting/harvester.md#i-cant-access-harvester-after-i-changed-ssltls-enabled-protocols-and-ciphers).

:::

`ssl-parameters`

**Versions**: v1.9.0 and later

**Definition**: Setting that applies default [TLSOptions](https://doc.traefik.io/traefik/reference/routing-configuration/http/tls/tls-options/) for traefik ingress controller

@jillian-maroket jillian-maroket Aug 20, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
:::info important
Replaces `ssl-parameters` setting applicable for nginx ingress controller.
If you misconfigure this setting and are unable to access the Harvester UI and API, see [Troubleshooting](../troubleshooting/harvester.md#i-cant-access-harvester-after-i-changed-ssltls-enabled-protocols-and-ciphers).
:::
`ssl-parameters`
**Versions**: v1.9.0 and later
**Definition**: Setting that applies default [TLSOptions](https://doc.traefik.io/traefik/reference/routing-configuration/http/tls/tls-options/) for traefik ingress controller
**Versions**: v1.9.0 and later
**Definition**: Setting that applies default [TLS options](https://doc.traefik.io/traefik/reference/routing-configuration/http/tls/tls-options/) for the Traefik Ingress Controller.
:::info important
This setting replaces the `ssl-parameters` setting for the Ingress NGINX Controller (`ingress-nginx`).
If you misconfigure this setting and are unable to access the Harvester UI and API, see [Troubleshooting](../troubleshooting/harvester.md#i-cant-access-harvester-after-i-changed-ssltls-enabled-protocols-and-ciphers).
:::

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The NGINX naming is confusing. There are two similarly named controllers.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants