Container Service for Kubernetes：Nginx Ingress營運相關知識點

Nginx設定檔結構。

下面是一個樣本Nginx.conf檔案，其中包含一些常見的指令塊：

# the number of worker processes to use
worker_processes 4;

# include additional configuration files
include /etc/nginx/conf.d/*.conf;

http {
  # HTTP server settings
  server {
    # listen on port 80
    listen 80;

    # server name
    server_name www.example.com;

    # default location
    location / {
      # root directory
      root /var/www/html;

      # index file
      index index.html;
    }
  }
}

在此樣本中：

• worker_processes：指令指定Nginx應使用的背景工作處理序數。

• include：指令用於包含其他設定檔。

• server：塊包含特定伺服器的設定。

• location：塊指定預設位置的設定，即伺服器的根URL。

瞭解更多的指令詳細資料，請參見Nginx官方文檔。

接下來，我們將概述在Nginx設定檔中最關鍵的幾個部分。

指令塊

HTTP塊

HTTP塊在Nginx設定檔中定義了HTTP伺服器的全域配置參數。這些參數包括啟動並執行背景工作處理序的數量、允許的最大串連數、日誌記錄的細節等。以下是一個Nginx設定檔中HTTP塊的樣本：

http {
    client_max_body_size 128m; 

    access_log /var/log/nginx/access.log; 
    error_log /var/log/nginx/error.log; 

    server {
        ...
    }
}

在該樣本中，HTTP塊設定了背景工作處理序的數量、檔案描述符的最大數量以及用戶端請求允許的最大本文大小。它還指定了訪問和錯誤記錄檔的位置，並且該HTTP塊內嵌了一個server塊，用於指定Web伺服器的配置。

Server塊

在Nginx配置中，Server塊用於定義特定網域名稱或一組網域名稱的流量請求處理規則。允許您為同一伺服器上託管的多個網站或應用程式定義不同的設定和行為。

以下是Nginx設定檔中伺服器塊的樣本：

server {
    listen 80;
    server_name www.example.com;

    location / {
        root /var/www/html/example;
        index index.html index.htm;
    }

    location /app {
        proxy_pass http://localhost:3000;
    }

    error_page 500 502 503 504 /50x.html;
    location = /50x.html {
        root /usr/share/nginx/html;
    }
}

在此樣本中，伺服器只處理連接埠80上www.example.com域的未加密流量。

• listen指定伺服器應偵聽連接埠80上的傳入串連。

• server_name指定此伺服器塊應處理的網域名稱。

• listen和server_name一起使用來定義伺服器應該偵聽和處理流量的域和連接埠。

server_name指令

指定虛擬機器主機網域名稱。

server_name name1 name2 name3

# example：
server_name www.example.com;

網域名稱匹配的四種寫法：

• 精確匹配：server_name www.example.com

• 左側通配：server_name *.example.com

• 右側通配：server_name www.example.*

• 正則匹配：server_name ~^www\.example\.*$

匹配優先順序：精確匹配 > 左側萬用字元匹配 > 右側萬用字元匹配 > Regex匹配。

Location塊

在Nginx中，Location塊是用來定義伺服器對於特定URL路徑或URL模式的請求處理規則。允許您根據網站或應用程式的不同部分定義不同的行為，如為特定目錄提供靜態檔案，或將請求代理到另一台伺服器。

以下是Nginx設定檔中位置塊的樣本：

server {
    ...

    location / {
        root /var/www/html/example;
        index index.html index.htm;
    }

    location /app {
        proxy_pass http://localhost:3000;
    }

    error_page 500 502 503 504 /50x.html;
    location = /50x.html {
        root /usr/share/nginx/html;
    }
}

在此例子中：

• / 的位置塊指定應通過提供/var/www/html/example目錄中的檔案來處理對網站根URL的請求。

• /app的位置塊指定對/appURL的請求應代理到連接埠3000上的localhost。

• /50x.html的位置塊指定伺服器應如何通過提供特定檔案來處理伺服器錯誤。

在Nginx中，當存在多個location塊時，請求的處理將根據location的匹配規則和優先順序被第一個相匹配的location塊捕獲並處理。

文法拼接：

• location [ = | ~ | ~* | ^~ ] uri { ... }

• location @name { ... }

匹配優先順序： = > ^~ > ~ > ~* > 不帶任何字元。

參考樣本如下：

# 通用的預設匹配，所有未匹配location的都會匹配此種匹配；
# 正則和最長字串會優先匹配
location / {

}


# 精確匹配 / ，主機名稱後面不能帶任何字串
location = / {

}

# 首碼匹配
location ^~ /xx/ {
     # 匹配任何以 /xx/ 開頭的請求並且停止搜尋。
}
# 不帶正則描述的首碼匹配；
location  /uri {
}

# 正則匹配
location ~*.(gif|jpg|jpeg)$ {
     # 匹配任何以 gif、jpg 或 jpeg 結尾的請求。
}

Nginx Ingress會將Host下多個Ingress path按長度降序進行排序。瞭解更多詳情，請參見Ingress路徑匹配和Nginx的伺服器和位置塊選擇演算法。

指令繼承和覆蓋

在Nginx配置中，指令遵循從外到內的繼承機制，位於內部的子上下文會從其外層的父上下文中繼承配置指令。例如，在http{}上下文中設定的指令會被所有嵌套於其下的server{}和location{}上下文所繼承，同樣，server{}上下文中的指令會被它所包含的所有location{}上下文繼承。需要注意的是，當同一個指令在父子上下文中均被定義時，子上下文中的配置將覆蓋父上下文中的相應設定，而不是疊加。

參考樣本如下：

http {
    add_header X-HTTP-LEVEL-HEADER 1;
    add_header X-ANOTHER-HTTP-LEVEL-HEADER 1;

    server {
        listen 8080;
        location / {
            return 200 "OK";
        } 
    }

    server {
        listen 8081;
        add_header X-SERVER-LEVEL-HEADER 1;

        location / {
            return 200 "OK";
        }

        location /test {
            add_header X-LOCATION-LEVEL-HEADER 1;
            return 200 "OK";
        }

        location /correct {
            add_header X-HTTP-LEVEL-HEADER 1;
            add_header X-ANOTHER-HTTP-LEVEL-HEADER 1;

            add_header X-SERVER-LEVEL-HEADER 1;
            add_header X-LOCATION-LEVEL-HEADER 1;
            return 200 "OK";
        } 
    }
}

Nginx的反向 Proxy配置

proxy_pass指令

Nginx反向 Proxy配置使得Nginx作為Proxy 伺服器運行，它監聽用戶端請求並將其轉寄至一個或多個後端伺服器。這使得Nginx能夠接收請求並將其路由至合適的後端服務進行處理。配置Nginx反向 Proxy，可以在Nginx配置中的位置塊中使用proxy_pass指令。

以下是配置Nginx反向 Proxy的樣本：

server {
    listen 80;
    server_name www.example.com;

    location / {
        proxy_pass http://localhost:3000;
    }
}

在此樣本中，/的位置塊指定對www.example.com域的所有請求都應代理到連接埠3000上的本地主機。這意味著Nginx將把接收到的請求轉寄到在localhost:3000上啟動並執行伺服器。

proxy_set_header指令

還可以使用proxy_set_header指令指定要添加到代理請求中的其他標題。

樣本如下：

server {
    listen 80;
    server_name www.example.com;

    location / {
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_pass http://localhost:3000;
    }
}

在此樣本中，proxy_set_header指令指定應將Host和X-Real-IP標題添加到代理請求中，並將傳入請求的主機名稱和發出請求的用戶端的IP地址分別設定為對應的值。這對於將傳入請求的資訊傳遞到上遊伺服器非常有用。

Nginx常用指令

Nginx常用命令