nginx.conf 忽略了 nginx-ingress 配置映射片段

Question

我有一個 kubernetes 集群，在那里我使用helm nginx-ingress chart部署了一個 nginx 入口控制器。

我需要向在 nginx-controller-pod 中生成的 nginx.conf 文件添加一些自定義配置，並且我看到一個問題，如果我添加一個單行選項，例如proxy-buffer-size: "512k"我可以看到這反映在 nginx.conf 文件中，一切都按預期工作。

但是，如果我嘗試添加一個片段來完成同樣的事情：

location-snippet: |
  proxy_buffer_size "512k";

這好像被 nginx.conf 文件忽略了，並且proxy_buffer_size設置保持它的默認值。

我需要能夠添加http-snippet 、 server-snippet和location-snippet覆蓋，但是無論我嘗試將它們添加到 ConfigMap 還是作為 Ingress.yaml 文件中的注釋，它們總是被忽略。

我的入口 yaml 文件：

apiVersion: extensions/v1beta1
kind: Ingress
metadata:
  name: my-ingress
  annotations:
    kubernetes.io/ingress.class: nginx
    ingress.kubernetes.io/ssl-redirect: "true" 
    ingress.kubernetes.io/secure-backends: "true"    
    ingress.kubernetes.io/force-ssl-redirect: "true"

    ingress.kubernetes.io/location-snippet: |
       proxy_buffer_size 512k;     --This does not update the nginx.conf
spec:
  tls:
  - hosts:
    - my.app.co.uk
    secretName: tls-secret

  rules:
  - host: my.app.co.uk
    http:
      paths:
      - path: /
        backend:
          serviceName: myappweb-service
          servicePort: 80

我的 nginx 配置圖：

apiVersion: v1
kind: ConfigMap
metadata:
  labels:
    app: nginx-ingress
    chart: nginx-ingress-0.28.3
    component: controller
    heritage: Tiller
    release: nginx-ingress
  name: nginx-ingress-controller
  namespace: default
data:
  proxy-buffer-size: "512k" -- this works and updates the nginx.conf

  location-snippet: |
    proxy_buffers 4 512k; -- this does not update the nginx.conf

  server-snippet: |       -- this does not update the nginx.conf
    location /messagehub {
      proxy_set_header Upgrade $http_upgrade;
      proxy_http_version 1.1;
      proxy_set_header X-Forwarded-Host $http_host;
      proxy_set_header X-Forwarded-Proto $scheme;
      proxy_set_header X-Forwarded-For $remote_addr;
      proxy_set_header Host $host;
      proxy_set_header Connection "upgrade";
      proxy_cache_bypass $http_upgrade;
   }

Answer 1

如果您想修改 Kubernetes Ingress ，注釋選項如下：

• nginx.ingress.kubernetes.io/configuration-snippet用於 nginx 位置塊片段
• nginx.ingress.kubernetes.io/server-snippet用於 nginx 配置服務塊中的片段

看起來您正在使用nginx.org/location-snippets:對於這種情況。

在 nginx 配置示例中還有一個 YAML 無效語法，根據這個示例，您也應該像在server-snippets一樣使用復數。 在撰寫本文時， 文檔中有一個錯字。 打開這張票跟進。

它應該是這樣的：

  server-snippets: |
    location /messagehub {
      proxy_set_header Upgrade $http_upgrade;
      proxy_http_version 1.1;
      proxy_set_header X-Forwarded-Host $http_host;
      proxy_set_header X-Forwarded-Proto $scheme;
      proxy_set_header X-Forwarded-For $remote_addr;
      proxy_set_header Host $host;
      proxy_set_header Connection "upgrade";
      proxy_cache_bypass $http_upgrade;
      }

而不是這個：

  server-snippet: |
    location /messagehub {
      proxy_set_header Upgrade $http_upgrade;
      proxy_http_version 1.1;
      proxy_set_header X-Forwarded-Host $http_host;
      proxy_set_header X-Forwarded-Proto $scheme;
      proxy_set_header X-Forwarded-For $remote_addr;
      proxy_set_header Host $host;
      proxy_set_header Connection "upgrade";
      proxy_cache_bypass $http_upgrade;
    }

注意最后一個花括號的縮進。

Answer 2

事實證明，我的問題是由於我正在應用的代碼片段的內容。 每次運行kubectl apply -f myconfigmap.yaml ，都會針對您嘗試應用到 nginx.conf 的更改運行驗證。 當此驗證失敗時，它會以靜默方式失敗，並且終端中沒有任何提醒您這一點。

實際上，您仍然會收到configmap/nginx-ingress-controller configured消息。

例如，當我將其添加到配置映射時，它會按預期更新 nginx.conf：

http-snippet: |
  sendfile on;

但是，當我添加它時，沒有任何改變：

http-snippet: |
  sendfile on;
  tcp_nopush on;

原因是這沒有通過驗證，但找到它的唯一方法是查看 nginx 入口控制器 pod 的日志。 在這種情況下，我看到：

Error: exit status 1
2018/10/16 07:45:49 [emerg] 470#470: "tcp_nopush" directive is duplicate in 
/tmp/nginx-cfg468835321:245
nginx: [emerg] "tcp_nopush" directive is duplicate in /tmp/nginx-cfg468835321:245
nginx: configuration file /tmp/nginx-cfg468835321 test failed

所以我復制了一個已經存在的指令。

Answer 3

我花了一天的時間，直到ingress-nginx （來自 Kubernetes）有*-snippet ，但對於nginx-ingress （來自 NGINX）， *-snippets與s 。

看這里：

• 入口-nginx： https : //kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/configmap/#main-snippet
• nginx-ingress: https://docs.nginx.com/nginx-ingress-controller/configuration/global-configuration/configmap-resource/#snippets-and-custom-templates