用途:在需要访问 Kubernetes 集群内服务(如 RabbitMQ、PostgreSQL、内部 API)时,建立本地到集群的端口转发连接,并处理服务发现、凭证获取、连通性验证与清理。
主要能力:提供常见服务的注册表参考(服务名、命名空间、DEV/PROD svc、端口),例如 RabbitMQ 管理端口 15672、AMQP 5672、PostgreSQL 6432、backoffice-api 与 obligations-api 的 8000 端口。支持转发到 Service 或具体 Pod,并说明优先使用 Service 以在 Pod 重启后仍可用。
使用方式:先查找服务,例如 kubectl --context=<env> get svc -n <namespace> | grep <keyword>;再启动端口转发,例如 kubectl --context=<env> port-forward -n <namespace> svc/<service> <local>:<remote>,或转发到 Pod:kubectl --context=<env> port-forward -n <namespace> <pod-name> <local>:<remote>。建议后台运行,多个转发使用不同本地端口。完成后清理:kill $(lsof -ti:<local-port>) 或 pkill -f "kubectl.*port-forward"。
凭证:禁止硬编码,优先询问用户,再尝试 Kubernetes secrets 或从应用 Pod 配置读取;若 secret 不匹配则询问用户。
限制与注意:端口转发可能静默断开,需验证连通性;端口占用先用 lsof -i:<port> 检查,或改用其他本地端口;注意命名空间(RabbitMQ 在 shared-infra,多数应用在 plataformadato);用完及时关闭;若可在集群内直接查询数据库或调用 API,优先使用 kubectl exec。