Skip to content

feat: Clarify NIC install & upgrade steps #816

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 40 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from 12 commits
Commits
Show all changes
40 commits
Select commit Hold shift + click to select a range
7035076
feat: Clarify NIC install & upgrade steps
ADubhlaoich Jul 15, 2025
2386768
Merge branch 'main' into nic/upgrade-instructions
ADubhlaoich Jul 15, 2025
1ce25d2
Merge branch 'main' into nic/upgrade-instructions
ADubhlaoich Jul 16, 2025
cab2b43
Merge branch 'main' into nic/upgrade-instructions
ADubhlaoich Jul 16, 2025
fcb0ea5
Merge branch 'main' into nic/upgrade-instructions
ADubhlaoich Jul 17, 2025
cea2a56
Merge branch 'main' into nic/upgrade-instructions
ADubhlaoich Jul 17, 2025
fe71933
Merge branch 'main' into nic/upgrade-instructions
ADubhlaoich Jul 17, 2025
5d8a199
Merge branch 'main' into nic/upgrade-instructions
ADubhlaoich Jul 18, 2025
00b5ba8
feat: Move and rename old upgrade instructions
ADubhlaoich Jul 18, 2025
b2b0195
Merge branch 'main' into nic/upgrade-instructions
ADubhlaoich Jul 18, 2025
b8d700d
Merge branch 'main' into nic/upgrade-instructions
ADubhlaoich Jul 18, 2025
c7ccbde
Merge branch 'main' into nic/upgrade-instructions
ADubhlaoich Jul 18, 2025
d011d29
Merge branch 'main' into nic/upgrade-instructions
ADubhlaoich Jul 21, 2025
7848959
Apply suggestion from @travisamartin
ADubhlaoich Jul 21, 2025
6b14dfc
Apply suggestion from @travisamartin
ADubhlaoich Jul 21, 2025
2f6db7c
Apply suggestion from @travisamartin
ADubhlaoich Jul 21, 2025
a87e651
Apply suggestion from @travisamartin
ADubhlaoich Jul 21, 2025
027cacc
Apply suggestion from @travisamartin
ADubhlaoich Jul 21, 2025
de6344e
Apply suggestion from @travisamartin
ADubhlaoich Jul 21, 2025
c094fc2
Apply suggestion from @travisamartin
ADubhlaoich Jul 21, 2025
a5b72f7
Apply suggestion from @travisamartin
ADubhlaoich Jul 21, 2025
3dc1027
Apply suggestion from @travisamartin
ADubhlaoich Jul 21, 2025
a0f591b
Apply suggestion from @travisamartin
ADubhlaoich Jul 21, 2025
92759bd
Apply suggestion from @travisamartin
ADubhlaoich Jul 21, 2025
4c72e55
Apply suggestion from @travisamartin
ADubhlaoich Jul 21, 2025
c8ba079
Apply suggestion from @travisamartin
ADubhlaoich Jul 21, 2025
40bd224
Apply suggestion from @travisamartin
ADubhlaoich Jul 21, 2025
ce3b5db
Apply suggestion from @travisamartin
ADubhlaoich Jul 21, 2025
6cc93b5
Apply suggestion from @travisamartin
ADubhlaoich Jul 21, 2025
7c098ef
Apply suggestion from @travisamartin
ADubhlaoich Jul 21, 2025
26bfffc
feat: Incorporate suggestions, rename image pages
ADubhlaoich Jul 21, 2025
a9534e8
Merge branch 'main' into nic/upgrade-instructions
ADubhlaoich Jul 21, 2025
2b3281a
Merge branch 'main' into nic/upgrade-instructions
ADubhlaoich Jul 21, 2025
a062bc4
fix: Update tech specs with new links
ADubhlaoich Jul 21, 2025
7063cf5
feat: Rename image docs, update references
ADubhlaoich Jul 22, 2025
a039bc8
Merge branch 'main' into nic/upgrade-instructions
ADubhlaoich Jul 22, 2025
cbbef0e
feat: Update Helm IA for add image to cluster
ADubhlaoich Jul 22, 2025
6c8b30b
Merge branch 'main' into nic/upgrade-instructions
ADubhlaoich Jul 23, 2025
707df12
Merge branch 'main' into nic/upgrade-instructions
ADubhlaoich Jul 24, 2025
701b6aa
Merge branch 'main' into nic/upgrade-instructions
ADubhlaoich Jul 25, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 4 additions & 6 deletions content/nic/installation/ingress-nginx.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,10 @@
---
nd-docs: DOCS-1469
doctypes:
- tutorial
tags:
- docs
title: Migrate from Ingress-NGINX Controller to NGINX Ingress Controller
toc: true
weight: 500
weight: 700
nd-content-type: how-to
nd-product: NIC
nd-docs: DOCS-1469
---

This document describes how to migrate from the community-maintained Ingress-NGINX Controller to F5 NGINX Ingress Controller.
Expand Down
296 changes: 74 additions & 222 deletions content/nic/installation/installing-nic/installation-with-helm.md

Large diffs are not rendered by default.

Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,8 @@
title: Installation with Manifests
toc: true
weight: 200
type: how-to
product: NIC
nd-content-type: how-to
nd-product: NIC
nd-docs: DOCS-603
---

Expand Down
137 changes: 0 additions & 137 deletions content/nic/installation/installing-nic/upgrade-to-v4.md

This file was deleted.

2 changes: 1 addition & 1 deletion content/nic/installation/integrations/_index.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Integrations
description:
weight: 600
weight: 800
url: /nginx-ingress-controller/installation/integrations
---
14 changes: 4 additions & 10 deletions content/nic/installation/run-multiple-ingress-controllers.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
---
nd-docs: DOCS-606
doctypes:
- ''
title: Run multiple NGINX Ingress Controllers
toc: true
weight: 400
weight: 600
nd-content-type: how-to
nd-product: NIC
nd-docs: DOCS-606
---

This document describes how to run multiple F5 NGINX Ingress Controller instances.
Expand All @@ -17,8 +17,6 @@ It explains the following topics:

{{< note >}} This document refers to [Ingress]({{< ref "/nic/configuration/ingress-resources/basic-configuration.md" >}}), [VirtualServer]({{< ref "/nic/configuration/virtualserver-and-virtualserverroute-resources.md#virtualserver-specification" >}}), [VirtualServerRoute]({{< ref "/nic/configuration/virtualserver-and-virtualserverroute-resources.md#virtualserverroute-specification" >}}), and [TransportServer]({{< ref "/nic/configuration/transportserver-resource.md" >}}) resources as "configuration resources".{{< /note >}}

---

## Ingress class

The [IngressClass](https://kubernetes.io/docs/concepts/services-networking/ingress/#ingress-class) resource allows for multiple Ingress Controller to operate in the same cluster. It also allow developers to select which Ingress Controller implementation to use for their Ingress resource.
Expand All @@ -35,16 +33,12 @@ The default Ingress class of NGINX Ingress Controller is `nginx`, which means th
{{< note >}}- If the class of an Ingress resource is not set, Kubernetes will set it to the class of the default Ingress Controller. To make the Ingress Controller the default one, the `ingressclass.kubernetes.io/is-default-class` property must be set on the IngressClass resource. To learn more, see Step 3 *Create an IngressClass resource* of the [Create Common Resources]({{< ref "/nic/installation/installing-nic/installation-with-manifests.md#create-common-resources" >}}) section.
- For VirtualServer, VirtualServerRoute, Policy and TransportServer resources, NGINX Ingress Controller will always handle resources with an empty class.{{< /note >}}

---

## Run NGINX Ingress Controller and another Ingress Controller

It is possible to run NGINX Ingress Controller and an Ingress Controller for another load balancer in the same cluster. This is often the case if you create your cluster through a cloud provider's managed Kubernetes service that by default might include the Ingress Controller for the HTTP load balancer of the cloud provider, and you want to use NGINX Ingress Controller.

To make sure that NGINX Ingress Controller handles specific configuration resources, update those resources with the class set to the value that is configured in NGINX Ingress Controller. By default, this is `nginx`.

---

## Run multiple NGINX Ingress Controllers

When running NGINX Ingress Controller, you have the following options with regards to which configuration resources it handles:
Expand Down
Loading