porterhub/controller

Porter构建的Chainguard ingress-nginx镜像

镜像概述

本镜像由Porter构建，基于Chainguard的ingress-nginx分支。ingress-nginx是Kubernetes生态中广泛使用的入口控制器，负责管理外部流量进入Kubernetes集群。Chainguard的分支注重镜像的安全性和精简性，Porter则提供可靠的构建流程，确保镜像质量与一致性。

核心功能与特性

• Kubernetes入口控制：支持HTTP/HTTPS流量路由、基于域名的虚拟主机配置
• 安全精简：基于Chainguard基础镜像，具有更小的镜像体积和更少的***面
• 标准兼容：遵循Kubernetes Ingress资源规范，支持IngressClass、TLS配置等标准特性
• 负载均衡：支持对后端服务的负载均衡，可配置多种负载均衡策略
• SSL终止：支持SSL证书配置，实现HTTPS流量的终止与解密

使用场景与适用范围

• Kubernetes集群中外部流量管理场景
• 对镜像安全性、精简性有较高要求的生产环境
• 需要实现基于域名、路径的流量路由及SSL加密的应用部署
• 适用于各类Kubernetes发行版（自建集群、云厂商托管集群等）

使用方法与配置说明

基本部署（Kubernetes）

通常通过Kubernetes Deployment或DaemonSet部署，以下是Deployment示例：

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: ingress-nginx-controller
  namespace: ingress-nginx
spec:
  replicas: 1
  selector:
    matchLabels:
      app.kubernetes.io/name: ingress-nginx
  template:
    metadata:
      labels:
        app.kubernetes.io/name: ingress-nginx
    spec:
      containers:
      - name: controller
        image: <镜像名称>  # 替换为实际镜像名称
        args:
        - /nginx-ingress-controller
        - --default-backend-service=ingress-nginx/default-backend
        - --publish-service=ingress-nginx/ingress-nginx-controller
        ports:
        - containerPort: 80
        - containerPort: 443

常用配置参数

通过容器启动参数配置，主要参数包括：

• --default-backend-service：指定默认后端服务，处理未匹配Ingress规则的请求
• --publish-service：指定用于更新Ingress状态的Service
• --enable-ssl-passthrough：启用SSL透传，将HTTPS流量直接转发至后端服务
• --ingress-class：指定IngressClass名称，用于匹配Ingress资源

环境变量

常用环境变量：

• NGINX_CONFIG_MAP：存储Nginx配置的ConfigMap名称
• POD_NAME：当前Pod名称（通常由Kubernetes自动注入）
• POD_NAMESPACE：当前Pod所在命名空间（通常由Kubernetes自动注入）

注意事项

• 部署前需确保Kubernetes集群满足ingress-nginx运行要求（如RBAC权限、网络策略等）
• 建议使用固定版本标签而非latest，确保部署稳定性
• 自定义Nginx配置可通过ConfigMap实现，并通过NGINX_CONFIG_MAP环境变量指定