針對 NCP 2.5.0 和更早版本
在 NCP 2.5.0 和更早版本中，會使用規則運算式字元「.」和「*」自動啟用所有子路徑比對。例如，路徑
/coffee/.*
會比對後面不跟字元或後跟一或多個字元的
/coffee/
，例如
/coffee/
、
/coffee/a
和
/coffee/b
，而非
/coffee
、
/coffeecup
或
/coffeecup/a
。
入口規格範例：
kind: Ingress
metadata:
  name: cafe-ingress
spec:
  rules:
  - http:
      paths:
      - path: /coffee/.*    #Matches /coffee/, /coffee/a but NOT /coffee, /coffeecup, etc.
        backend:
          serviceName: coffee-svc
          servicePort: 80
針對 NCP 2.5.1 及更新版本
您可以將使用註解
ncp/use-regex
的入口
path
(但不是
host
) 參數的規則運算式比對啟用或停用。如果設定為
false
，則會透過執行
equals
比對來執行精確路徑比對。如果設定為
true
，則會透過將字串字元開頭 (^) 和字串字元結尾 ($) 新增至路徑來執行規則運算式比對，使得整個要求 URI 符合模式。請注意，使用
OR
運算子 (|) 時，一律使用括弧指定範圍，使得 ^ 和 $ 適用於所有運算元。例如，
path: /(tea|coffee|milk)
。入口規格範例：
kind: Ingress
metadata:
  name: cafe-ingress
  annotations:
    kubernetes.io/ingress.class: "nsx"
    ncp/use-regex: "true"
spec:
  rules:
  - host: cafe.example.com
    http:
      paths:
      - path: /tea/.*
        backend:
          serviceName: tea-svc
          servicePort: 80
在將 NCP 升級至 2.5.1 及更新版本之前更新入口
僅當您的入口需要使用字元「.」和「*」的進行所有子路徑比對時，才需要此選項。
更新入口以包含註解
ncp/use-regex: true
。
對於所有子路徑比對，如果您具有
/coffee/*
或
/*
之類的路徑，請將其變更為
/coffee/.*
和
/.*
。
/coffee/.*
將比對
/coffee/
、
/coffee/a
、
/coffee/b
、
/coffee/a/b
，依此類推。
/.*
將比對
/coffee
、
/tea
、
/coffee/a
，依此類推。省略路徑會產生與
path: /.*
相同的行為。

kind: Ingress
metadata:
  name: cafe-ingress
  annotations:
    ingress.kubernetes.io/rewrite-target: /
spec:
  rules:
  - host: cafe.example.com
    http:
      paths:
      - path: /tea
        backend:
          serviceName: tea-svc
          servicePort: 80
      - path: /coffee
        backend:
          serviceName: coffee-svc
          servicePort: 80

kind: Ingress
metadata:
  name: cafe-ingress
  annotations:
    kubernetes.io/ingress.class: "nsx"
    ncp/use-regex: "true"
    #/tea/cup will be rewritten to /cup before sending request to endpoint
    ingress.kubernetes.io/rewrite-target: /$1
spec:
  rules:
  - host: cafe.example.com
    http:
      paths:
      - path: /tea/(.*)
        backend:
          serviceName: tea-svc
          servicePort: 80

如果註解設定為
false
，則會為 HTTPS 虛擬伺服器建立規則。
如果註解設定為
true
或遺失，則會同時為 HTTP 和 HTTPS 虛擬伺服器建立規則。請注意，只有在入口規格中存在 TLS 區段時才會建立 HTTPS 規則。

如果註解設定為
false
，則不會將對 HTTP 虛擬伺服器的傳入 HTTP 流量 (連接埠 80) 重新導向至 HTTPS 虛擬伺服器。
如果註解設定為
true
，則會將對 HTTP 虛擬伺服器的傳入 HTTP 流量 (連接埠 80) 重新導向至 HTTPS 虛擬伺服器 (連接埠 443)。

如果值為
nsx
，則此入口將由 NCP 進行處理。如果指定任何其他值，NCP 將忽略該入口。如需詳細資訊，請參閱第三方入口控制器。

設定時，僅當傳入要求的來源 IP 包含在此註解中時，才會予以接受。否則，將會捨棄流量。

您可以指定 CIDR、IP 位址和 IP 範圍的組合。例如，1.1.1.1/24、2.2.2.2、3.3.3.3-4.4.4.4。

範例 YAML：

kind: Ingress
metadata:
  name: cafe-ingress
  annotations:
    kubernetes.io/ingress.class: "nsx"
    ncp/whitelist-source-range: "192.168.128.0/17, 192.168.64.0-192.168.64.255, 192.168.16.32"
spec:
  tls:
  - hosts:
    - cafe.example.com
  rules:
  - host: cafe.example.com
    http:
      paths:
      - path: /tea
        backend:
          serviceName: tea-svc
          servicePort: 80

此註解適用於入口中的所有規則，且負載平衡器將在選取的 SSL 模式下針對這些規則運作。
附註：如果
ncp/ssl-mode
設定為
reencrypt
或
passthrough
，則
kubernetes.io/ingress.allow-http
必須設定為
False
。如果已設定
ingress.kubernetes.io/rewrite-target
、
ncp/use-regex
或
ncp/whitelist-source-range
註解，則無法將此註解設定為
passthrough
。

若要為入口下方的所有規則啟用 JWT 用戶端驗證，則需要將
ncp/jwt-alg
和
ncp/jwt-secret
設為有效的值。啟用時，只有在承載有效的 JSON Web Token 時，才會將傳入 HTTP 流量傳遞至後端。否則，流量將遭到拒絕，且具有 401 狀態。
此功能與下列註解不相容：
kubernetes.io/ingress.allow-http: true
ncp/http-redirect: true
ncp/ssl-mode: passthrough
ncp/jwt-alg
:
支援的對稱演算法：HS256
支援的非對稱演算法：RS256
ncp/jwt-secret
:
對稱金鑰或公用憑證必須在 Kubernetes 密碼中進行設定，且在與入口相同的命名空間下方具有此註解中指定的名稱。
對於對稱演算法，密碼必須儲存在
jwt.key
欄位中。
對於非對稱演算法，公用憑證必須儲存在
tls.crt
欄位中。
如果對稱密碼或公開憑證未儲存在上述位置中，或如果儲存在密碼中的資料無效，則會停用 JWT 用戶端驗證。
ncp/jwt-token
:
只能在此註解中設定一個項目。
_arg_<param_name>
：針對以 URI 參數形式傳入的 JWT。指定包含 JWT 的參數名稱。
_cookie_<cookie_name>
：針對以 Cookie 形式傳入的 JWT。指定包含 JWT 的 Cookie 名稱。