# Nginx Plus

## Nginx Plus คืออะไร

เอกสารที่เกี่ยวข้อง

* <https://www.f5.com/products/nginx/nginx-plus>

***

&#x20;

<figure><img src="https://t9003005656.p.clickup-attachments.com/t9003005656/1a7bdd80-2787-4fda-bfa2-bf6dce98bc06/image.png" alt=""><figcaption></figcaption></figure>

คือแพ็คเก็จระดับ enterprise grade ที่มีความสามารถทุกอย่างที่ Nginx open source ทำได้ อีกทั้งยังมีฟีเจอร์หลักที่ช่วยให้ระบบมี **High Availability (HA)** ที่ทั้ง **ปรับขยายได้ (scalable)** และ **เชื่อถือได้ (reliable)** พร้อมเครื่องมือสำหรับ **Monitoring** เพื่อช่วย **debug** และ **วิเคราะห์ปัญหา** ในสถาปัตยกรรมแอปพลิเคชันที่ซับซ้อน&#x20;

**Advanced security** ลดความเสี่ยงด้านความปลอดภัยด้วยฟีเจอร์ ดังนี้

* request and connection limiting เพื่อป้องกันปัญหา overload, abuse, หรือ DoS attack
* รองรับ protocol TLS1.3
* สามารถทำ dynamic certificate loading ได้ คือความสามารถที่ NGINX Plus สามารถ โหลดหรืออัปเดต SSL/TLS certificates ได้แบบไดนามิก (ขณะรันอยู่) โดย ไม่ต้อง reload หรือ restart NGINX process
* มีการใช้ JWT authentication&#x20;

**Best-of-breed support** มี assistance support สำหรับการช่วยเหลือ

* installation and deployment
* debugging and error correction
* security notifications
* software updates

**Load balancer** ที่ชาญฉลาด

* รองรับระบบขนาดใหญ่ (High scale) สำหรับ HTTP, TCP, UDP traffic
* มีการรองรับ Load Balancing Algorithms ที่หลากหลาย&#x20;

**API gateway** เป็นตัวกลางหรือ entry point ระหว่าง client กับ backend services หรือ microservices

* มีการทำ edge gateway with TLS termination และ rate limiting
* สามารถทำ request routing เพื่อกำหนดเส้นทาง route ของ request ว่าจะส่งไปยัง service backend ใด
* สามารถทำ request manipulation เพื่อปรับแต่ง request/response ให้ตรงตามเงื่อนไขหรือ policy&#x20;

**Reverse proxy** คือเซิร์ฟเวอร์กลางที่ รับ request จาก client แล้วส่งต่อไปยัง backend server

* Session persistence
* caching
* multiple algorithms to maximize speed and capacity for resiliency and scale&#x20;

## ขั้นตอนการติดตั้ง NGINX Plus Ingress Controller บน Kubernetes ด้วย Helm

ขั้นตอนการติดตั้ง NGINX Plus Ingress Controller บน Kubernetes Cluster โดยใช้ Helm Chart และค่า config ที่จำเป็น เอกสารที่เกี่ยวข้อง

* <https://docs.nginx.com/nginx-ingress-controller/installation/installing-nic/installation-with-helm/#configuration>

***

#### ขั้นตอนที่ 1 เตรียมข้อมูลยืนยันตัวตน (Authentication)

เริ่มต้นต้องสร้าง Kubernetes Secret เพื่อให้ Cluster สามารถยืนยันตัวตนและ pull image ของ NGINX Plus จาก Private Registry ของ NGINX ได้

1. **รับ Certificate/Key หรือ JWT Token** เข้าสู่ระบบที่ [my.f5.com](https://my.f5.com) เพื่อดาวน์โหลดไฟล์ `nginx-repo.crt` และ `nginx-repo.key` หรือคัดลอก JWT token สำหรับ Docker Registry
2. **สร้าง Kubernetes Secret:** รันคำสั่ง `kubectl` เพื่อสร้าง `docker-registry` secret ใน namespace ที่ต้องการ (ตัวอย่างนี้ใช้ `nginx-ingress`)

```bash
kubectl create secret docker-registry nginx-repo-secret \
    --namespace nginx-ingress \
    --docker-server=private-registry.nginx.com \
    --docker-username=<your-username> \
    --docker-password=<your-password-or-jwt> \
    --docker-email=<your-email>
```

> **Note:** หากยังไม่มี namespace `nginx-ingress` คุณสามารถสร้างก่อนด้วยคำสั่ง `kubectl create namespace nginx-ingress` หรือใช้ flag `--create-namespace` ในขั้นตอนการติดตั้ง Helm

***

#### ขั้นตอนที่ 2 เตรียมไฟล์คอนฟิกสำหรับ Helm (values.yaml)

เราจะใช้ Helm Chart อย่างเป็นทางการของ NGINX และทำการ override ค่าคอนฟิกบางส่วนเพื่อให้ชี้ไปยัง NGINX Plus

1. **เพิ่ม NGINX Helm repository:** หากยังไม่เคยเพิ่ม ให้รันคำสั่งต่อไปนี้

```bash
helm repo add nginx-ingress oci://ghcr.io/nginx/charts/nginx-ingress	
```

2. **สร้างไฟล์** **`values.yaml`\*\*\*\*:** สร้างไฟล์ใหม่ชื่อ `values.yaml` และใส่เนื้อหาดังนี้เพื่อเปิดใช้งาน NGINX Plus และระบุ Image ที่ถูกต้อง

```yaml
controller:
  appprotect:
    configManager:
      image:
        repository: registry.nipa.cloud/nap/waf-config-mgr
    enforcer:
      image:
        repository: registry.nipa.cloud/nap/waf-enforcer
  config:
    entries:
      allow-snippet-annotations: "true"
      client-max-body-size: 250m
      enable-underscores-in-headers: "true"
      error-log-level: debug
      large-client-header-buffers: 4 64k
      proxy-buffers: 128 4k
      redirect-to-https: "true"
      server-name-hash-bucket-size: "1024"
      ssl-redirect: "false"
      use-forwarded-headers: "true"
      worker-processes: "40"
  customConfigMap: null
  image:
    repository: registry.nipa.cloud/nginx-ic/nginx-plus-ingress
  nginxplus: true
  customPorts:
    - name: nginx-dashboard
      containerPort: 8080
      protocol: TCP

serviceInsight:
  create: true
```

***

#### ขั้นตอนที่ 3 ติดตั้งด้วย Helm

เมื่อเตรียม Secret และไฟล์ `values.yaml` เรียบร้อยแล้ว ก็สามารถติดตั้ง NGINX Plus Ingress Controller ได้ด้วยคำสั่ง `helm install`

```bash
helm install nginx-ingress-my-release nginx-ingress/nginx-ingress \
  --version 2.2.1 \
  --values xxxxxxx.yaml
```

* `nginx-ingress-my-release` คือชื่อ release ที่คุณตั้งเอง
* `nginx-ingress/nginx-ingress` คือ `[repo/chart]`
* `--version` ช่วยให้แน่ใจว่าใช้เวอร์ชันที่ต้องการ
* `--values` หรือ `-f` ใช้กำหนดไฟล์ค่า override **หลังจากรันคำสั่งนี้สำเร็จ NGINX Plus Ingress Controller จะถูกติดตั้งและพร้อมใช้งานใน Kubernetes Cluster ของคุณโดยจะได้เป็น service type loadbalancer โดย default**

```yaml
apiVersion: v1
kind: Service
metadata:
    name: nginx-dashboard
  namespace: nginx-ingress
spec:
  ports:
    - name: dashboard
      port: 8080
      protocol: TCP
      targetPort: 8080
  selector:
    app.kubernetes.io/name: nginx-ingress
  type: ClusterIP
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs-epc.gitbook.io/ncs-documents/load-balancing/nginx-plus.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.