appscode/voyager

Voyager Docker镜像文档

镜像概述

Voyager是由AppsCode开发的Kubernetes Ingress Controller，旨在为Kubernetes集群提供安全、可靠的入站流量管理解决方案。作为Ingress Controller，Voyager负责解析Kubernetes Ingress资源，将外部流量路由到集群内部服务，并提供负载均衡、TLS终止、路径路由等核心功能，适用于各类Kubernetes部署环境。

核心功能与特性

• 多负载均衡器支持：兼容多种负载均衡器实现，包括云服务商提供的负载均衡器（如AWS ELB、GCP LB、Azure LB）和基于Nginx的自建负载均衡器。
• TLS安全保障：支持TLS 1.2/1.3终止，自动管理SSL证书（通过Cert-Manager集成），确保流量加密传输。
• 灵活路由规则：支持基于路径、主机名、HTTP方法的路由，以及重定向、重写等高级路由策略。
• 高可用性：通过健康检查、自动故障转移和会话亲和性（Session Affinity）确保服务持续可用。
• 可扩展性：支持水平扩展，可根据流量负载动态调整负载均衡器实例数量。
• 监控与日志：集成Prometheus指标暴露和日志收集，便于监控流量状态和排查问题。

使用场景与适用范围

• 生产环境Kubernetes集群：作为核心Ingress Controller，管理外部流量进入集群内部服务。
• 多租户应用部署：通过基于主机名的路由，实现多租户应用的流量隔离与访问控制。
• 安全HTTPS服务：需提供加密访问的Web应用，通过TLS终止确保数据传输安全。
• 混合云/多云环境：在混合云或多云Kubernetes集群中，统一管理不同云平台的负载均衡资源。

使用方法与配置说明

部署方式

Voyager通常通过Kubernetes资源（如Deployment、DaemonSet）部署，以下是基于Helm的部署示例：

bash
# 添加AppsCode Helm仓库
helm repo add appscode https://charts.appscode.com/stable/
helm repo update

# 安装Voyager（以Nginx模式为例）
helm install voyager appscode/voyager \
  --namespace kube-system \
  --set controller.kind=Deployment \
  --set controller.service.type=LoadBalancer

基本使用示例

创建Ingress资源以路由流量到后端服务：

yaml
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: example-ingress
  annotations:
    kubernetes.io/ingress.class: voyager
spec:
  rules:
  - host: app.example.com
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: example-service
            port:
              number: 80
  tls:
  - hosts:
    - app.example.com
    secretName: example-tls-secret  # 包含TLS证书的Secret

配置参数

Voyager控制器支持通过环境变量和Ingress注解进行配置，关键参数如下：

环境变量

Ingress注解

镜像拉取

Voyager镜像托管在Docker Hub，可通过以下命令拉取：

bash
docker pull appscode/voyager:v12.0.0  # 替换为具体版本号

注意事项

• 确保Kubernetes集群版本与Voyager版本兼容（具体兼容版本见https://github.com/voyagermesh/voyager%EF%BC%89%E3%80%82
• 使用云服务商负载均衡器时，需确保集群具有相应的云平台权限（如AWS IAM权限）。
• TLS证书需通过Kubernetes Secret管理，建议配合Cert-Manager自动签发和续期证书。