Skip to content

Commit 8e76cf6

Browse files
committed
cleanup
1 parent 238da3a commit 8e76cf6

File tree

1 file changed

+7
-58
lines changed

1 file changed

+7
-58
lines changed

docs/http/http-installation-guide.md

Lines changed: 7 additions & 58 deletions
Original file line numberDiff line numberDiff line change
@@ -37,60 +37,6 @@ This Solution provides a replacement, using an NGINX Server, and a new K8s Contr
3737

3838
## Installation Steps
3939

40-
1. Install NGINX Ingress Controller in your Cluster
41-
2. Install NGINX Cafe Demo Application in your Cluster
42-
3. Install NGINX Plus on the Loadbalancer Server(s)
43-
4. Configure NGINX Plus for HTTP MultiCluster Load Balancing
44-
5. Install NLK NGINX Loadbalancer for Kubernetes Loadbalancing Controller in your Cluster
45-
6. Install NLK LoadBalancer or NodePort Service manifest
46-
7. Test out NLK
47-
8. Test MultiCluster Load Balancing Solution
48-
9. Optional - Monitor traffic with Prometheus / Grafana
49-
50-
<br/>
51-
52-
### Pre-Requisites
53-
54-
1. Working kubernetes clusters, with admin privleges
55-
56-
2. Running `nginx-ingress controller`, either OSS or Plus. This install guide followed the instructions for deploying an NGINX Ingress Controller here: https://docs.nginx.com/nginx-ingress-controller/installation/installation-with-manifests/
57-
58-
3. Demo application, this install guide uses the NGINX Cafe example, found here: https://github.com/nginxinc/kubernetes-ingress/tree/main/examples/ingress-resources/complete-example
59-
60-
4. A bare metal Linux server or VM for the external NGINX Loadbalancing Server, connected to a network external to the cluster. Two of these will be required if High Availability is needed, as shown here.
61-
62-
5. NGINX Plus software loaded on the Loadbalancing Server(s). This install guide follows the instructions for installing NGINX Plus on Centos 7, located here: https://docs.nginx.com/nginx/admin-guide/installing-nginx/installing-nginx-plus/
63-
64-
6. The NGINX Loadbalancer for Kubernetes (NLK) Controller, new software from NGINX for this Solution.
65-
66-
<br/>
67-
68-
### Kubernetes Clusters
69-
70-
<br/>
71-
72-
### This Solution from NGINX provides Enterprise class features which address common challenges with networking, traffic management, and High Availability for On-Premises Kubernetes Clusters.
73-
74-
<br/>
75-
76-
1. Provides a `replacement Loadbalancer Service.` The Loadbalancer Service is a key component provided by most Cloud Providers. However, when running a K8s Cluster On Premises, the `Loadbalancer Service is not available.`
77-
This Solution provides a replacement, using an NGINX Server, and a new K8s Controller from NGINX. These two components work together to watch the `nginx-ingress Service` in the cluster, and immediately update the NGINX Loadbalancing Server when changes occur.
78-
79-
2. Provides `MultiCluster Load Balancing`, traffic steering, health checks, TLS termination, advanced Loadbalancing algorithms, and enhanced metrics.
80-
81-
3. Provides dynamic, ratio-based Load Balancing for Multiple Clusters. This allows for advanced traffic steering, and operation efficiency with no Reloads or downtime.
82-
- MultiCluster Active/Active Load Balancing
83-
- Horizontal Cluster Scaling
84-
- HTTP Split Clients - for A/B, Blue/Green, and Canary test and production traffic steering. Allows Cluster operations/maintainence like upgrades, patching, expansion and troubleshooting
85-
- NGINX Zone Sync of KeyVal data
86-
- Advanced TLS Processing - MutualTLS, OCSP, FIPS, dynamic cert loading
87-
- Advanced Security features - App Protect WAF Firewall, Oauth, JWT, Dynamic Rate and Bandwidth limits, GeoIP, IP block/allow lists
88-
- NGINX Java Script (NJS) for custom solutions
89-
90-
<br/>
91-
92-
## Installation Steps
93-
9440
1. Install NGINX Ingress Controller in your Cluster
9541
2. Install NGINX Cafe Demo Application in your Cluster
9642
3. Install NGINX Plus on the Loadbalancing Server(s)
@@ -117,6 +63,8 @@ This Solution provides a replacement, using an NGINX Server, and a new K8s Contr
11763

11864
6. The `NGINX Loadbalancer for Kubernetes (NLK) Controller`, new software from NGINX for this Solution.
11965

66+
7. Optional - additional Docker Host to run the Prometheus and Grafana Servers containers.
67+
12068
<br/>
12169

12270
### Kubernetes Clusters
@@ -127,7 +75,7 @@ This Solution provides a replacement, using an NGINX Server, and a new K8s Contr
12775

12876
<br/>
12977

130-
A standard K8s cluster is all that is required, two or more Clusters if you want the `Active/Active MultiCluster Load Balancing Solution` using HTTP Split Clients. There must be enough resources available to run the NGINX Ingress Controller, and the NGINX Loadbalancer for Kubernetes Controller, and test application like the Cafe Demo. You must have administrative access to be able to create the namespace, services, and deployments for this Solution. This Solution was tested on Kubernetes version 1.23.
78+
A standard K8s cluster is all that is required, two or more Clusters if you want the `Active/Active MultiCluster Load Balancing Solution` using HTTP Split Clients. There must be enough resources available to run the NGINX Ingress Controller, and the NGINX Loadbalancer for Kubernetes Controller, and a test application like the Cafe Demo. You must have administrative access to be able to create the namespace, services, and deployments for this Solution. This Solution was tested on Kubernetes version 1.23.
13179

13280
<br/>
13381

@@ -262,9 +210,10 @@ Nginx Config Files
262210
etc/
263211
└── nginx/
264212
├── conf.d/
265-
│ ├── clusters.conf.......... MultiCluster Loadbalancing and split clients config
266-
│ ├── dashboard.conf......... NGINX Plus API and Dashboard config
267-
│ └── prometheus.conf........ NGINX Prometheus config
213+
├── clusters.conf.......... MultiCluster Loadbalancing and split clients config
214+
├── dashboard.conf......... NGINX Plus API and Dashboard config
215+
├── prometheus.conf........ NGINX Prometheus config
216+
├── single-cluster.conf.... NGINX config for just one cluster
268217
├── nginx.conf................. New nginx.conf
269218
└── stream
270219
└── zonesync.conf.......... NGINX Zone Sync config

0 commit comments

Comments
 (0)