portworx/teleport-server-charts

Custom Teleport Server Chart for PDS SM 镜像文档

1. 镜像概述与主要用途

本镜像为基于Teleport官方功能定制的服务器Chart，专为PDS SM（PDS Service Management）环境设计。通过集成PDS SM环境特定配置与优化策略，提供开箱即用的Teleport服务器部署方案，旨在简化PDS SM环境下Teleport服务的部署流程、配置管理及运维操作，支持安全远程访问、服务间加密通信等核心场景。

2. 核心功能与特性

• PDS SM环境适配：针对PDS SM基础设施规范优化，支持与PDS SM监控、日志、认证体系无缝集成。
• 自定义配置支持：提供丰富的配置项，支持根据业务需求调整服务器参数（如端口、认证策略、资源限制等）。
• 简化部署流程：基于Helm Chart封装，支持一键部署与版本管理，降低运维复杂度。
• 安全强化：默认集成PDS SM安全基线配置，包括TLS加密、最小权限原则及审计日志功能。
• 高可用性支持：支持多实例部署与自动扩缩容配置，适配PDS SM高可用架构要求。

3. 使用场景与适用范围

适用场景

• PDS SM环境下的跨节点/跨区域服务远程访问管理。
• 微服务架构中服务间的安全通信与身份认证。
• 开发/测试/生产环境的统一接入与权限控制。
• 需要符合PDS SM安全规范的远程运维场景。

适用范围

• PDS SM认证的Kubernetes集群环境。
• 基于Helm 3.x的包管理系统。
• 需部署Teleport 10+版本服务器的业务场景。

4. 使用方法与配置说明

4.1 前置条件

• 已安装Helm 3.x及以上版本。
• 已配置Kubernetes集群访问权限（kubectl可正常连接）。
• PDS SM环境已提供必要的存储（如PVC）、网络策略及密钥管理服务。

4.2 部署步骤

1. 添加Chart仓库（如已内置，可跳过）：

   bash
   helm repo add pds-sm-teleport https://charts.example.com/pds-sm-teleport
   helm repo update
   

2. 部署Chart：

   bash
   helm install teleport-server pds-sm-teleport/teleport \
     --namespace pds-sm-services \
     --create-namespace \
     --set serverName=teleport-pds-sm-01 \
     --set service.port=3023 \
     --set auth.type=pds-sm-oauth \
     --set resources.limits.cpu=1 \
     --set resources.limits.memory=2Gi
   

3. 验证部署：

   bash
   kubectl get pods -n pds-sm-services
   kubectl logs <pod-name> -n pds-sm-services | grep "Teleport server started"
   

4.3 核心配置参数

4.4 自定义配置文件

如需更复杂的自定义配置（如角色权限、反向代理规则等），可通过config.customConfig参数挂载本地配置文件：

bash
helm install teleport-server pds-sm-teleport/teleport \
  --namespace pds-sm-services \
  --set-file config.customConfig=./custom-teleport.yaml

其中custom-teleport.yaml需符合Teleport服务器配置规范，并包含PDS SM环境特定参数（如PDS SM OAuth端点、监控指标暴露路径等）。

4.5 升级与卸载

• 升级Chart：

  bash
  helm upgrade teleport-server pds-sm-teleport/teleport \
    --namespace pds-sm-services \
    --set serverName=teleport-pds-sm-01 \
    --reuse-values
  

• 卸载Chart：

  bash
  helm uninstall teleport-server -n pds-sm-services
  kubectl delete namespace pds-sm-services  # 可选：删除命名空间
  

5. 环境变量说明

容器运行时支持通过环境变量覆盖部分配置（优先级低于values.yaml）：

• TELEPORT_SERVER_NAME：覆盖serverName配置。
• TELEPORT_LOG_LEVEL：覆盖logs.level配置。
• PDS_SM_OAUTH_ENDPOINT：自定义PDS SM OAuth认证端点（当auth.type=pds-sm-oauth时生效）。

6. 注意事项

• 部署前需确保PDS SM环境已开放Chart所需端口（如3023/TCP、3025/TCP）。
• 敏感信息（如OAuth密钥、TLS证书）建议通过Kubernetes Secrets管理，通过secrets.existingSecret参数引用。
• 版本升级前请参考PDS SM环境兼容性矩阵，确保Teleport版本与PDS SM组件兼容。