公司网站建设组织架构,国内消息最新新闻,个人网站做淘宝客会怎样,python网页版编程Kubernetes Ingress Annotations 是与特定 Ingress 控制器#xff08;如 Nginx、Traefik、HAProxy 等#xff09;配合使用#xff0c;用于扩展和定制 Ingress 资源行为的关键配置项。它们通常以键值对的形式添加在 Ingress 资源的 metadata部分。Ingress Annotations参数速查…Kubernetes Ingress Annotations 是与特定 Ingress 控制器如 Nginx、Traefik、HAProxy 等配合使用用于扩展和定制 Ingress 资源行为的关键配置项。它们通常以键值对的形式添加在 Ingress 资源的 metadata部分。Ingress Annotations参数速查表下面我用一个表格汇总常见的、主要用于 Nginx Ingress 控制器 的 Annotations并按其功能分类方便你快速查阅功能分类注解名称 (Annotation)类型说明与示例值路由与路径nginx.ingress.kubernetes.io/rewrite-targetURI重写请求路径。例: /old重写为 /newnginx.ingress.kubernetes.io/app-rootstring将根路径重定向。例: 访问 /重定向到 /homenginx.ingress.kubernetes.io/use-regexbool启用正则表达式匹配路径。例: trueSSL/TLSnginx.ingress.kubernetes.io/ssl-redirectbool将HTTP请求重定向到HTTPS (需配置TLS)。例: truenginx.ingress.kubernetes.io/force-ssl-redirectbool强制所有HTTP重定向到HTTPS (即使未配置TLS)。例: truenginx.ingress.kubernetes.io/ssl-passthroughboolSSL流量直接透传到后端。例: true认证与安全nginx.ingress.kubernetes.io/auth-typestring认证类型。例: basic(基本认证) 或 digest(摘要认证) nginx.ingress.kubernetes.io/auth-secretstring包含认证凭据的Secret。例: namespace/secret-namenginx.ingress.kubernetes.io/auth-realmstring认证域提示信息。例: Authentication Requirednginx.ingress.kubernetes.io/auth-urlstring外部认证服务URL。例: http://auth-service/authnginx.ingress.kubernetes.io/whitelist-source-rangestringIP白名单。例: 192.168.0.0/24流量控制nginx.ingress.kubernetes.io/limit-rpsnumber限制每秒请求数。例: 50nginx.ingress.kubernetes.io/limit-connectionsnumber限制单个IP的并发连接数。例: 100nginx.ingress.kubernetes.io/proxy-body-sizestring请求体最大大小。例: 20mnginx.ingress.kubernetes.io/proxy-connect-timeoutnumber与上游服务器连接超时时间(秒)。例: 30nginx.ingress.kubernetes.io/proxy-read-timeoutnumber读取上游响应的超时时间(秒)。例: 60会话保持nginx.ingress.kubernetes.io/affinitystring启用会话保持。例: cookie(目前仅支持cookie方式) nginx.ingress.kubernetes.io/session-cookie-namestring自定义会话Cookie名称。例: MYCOOKIEnginx.ingress.kubernetes.io/affinity-modestring会话保持模式。例: balanced(均衡) 或 persistent(持久) Canary发布nginx.ingress.kubernetes.io/canarybool启用金丝雀发布。例: truenginx.ingress.kubernetes.io/canary-weightnumber流量权重 (0-100)。例: 30(30%流量到Canary) nginx.ingress.kubernetes.io/canary-by-headerstring基于请求头路由。例: X-Canarynginx.ingress.kubernetes.io/canary-by-header-valuestring指定请求头的值。例: enablenginx.ingress.kubernetes.io/canary-by-cookiestring基于Cookie路由。例: canary(Cookie存在即路由到Canary) CORSnginx.ingress.kubernetes.io/enable-corsbool启用跨域资源共享(CORS)。例: truenginx.ingress.kubernetes.io/cors-allow-originstring允许的跨域来源。例: *或 https://example.comnginx.ingress.kubernetes.io/cors-allow-methodsstring允许的HTTP方法。例: GET, PUT, POSTnginx.ingress.kubernetes.io/cors-allow-headersstring允许的请求头。例: DNT,User-Agent,X-Requested-With后端协议nginx.ingress.kubernetes.io/backend-protocolstring指定与后端服务通信的协议。例: HTTPS、GRPC、GRPCS自定义配置nginx.ingress.kubernetes.io/server-snippetstring在Nginx的server块中插入自定义配置 nginx.ingress.kubernetes.io/configuration-snippetstring在Nginx的location块中插入自定义配置 使用注意事项注解值格式所有注解的键和值都必须是字符串。布尔值如 true/false或数字如权重、超时时间必须用引号包裹例如 true、100。控制器特异性绝大多数注解都依赖于特定的 Ingress 控制器如 Nginx、Traefik、HAProxy不同控制器的注解前缀和名称可能不同例如 Nginx 使用 nginx.ingress.kubernetes.io/Traefik 使用 traefik.ingress.kubernetes.io/AWS ALB 使用 alb.ingress.kubernetes.io/。使用时请确认你的集群使用的控制器类型并查阅其官方文档 。金丝雀发布优先级当同时配置多种金丝雀规则如按头、按Cookie、按权重时优先级通常为请求头 Cookie 权重。会话保持基于 Cookie 的会话保持是目前常见的方式可通过 affinity-mode选择 balanced均衡或 persistent持久模式 。
