kube-router 开发镜像文档

镜像概述和主要用途

本镜像为kube-router的开发镜像，用于支持kube-router项目的开发、测试与构建流程。kube-router是一款面向Kubernetes的分布式负载均衡器、防火墙及路由器，可在集群节点上提供服务代理、网络策略 enforcement 及跨节点路由功能。本开发镜像包含多种构建类型，满足不同开发阶段的需求。

核心功能与特性

构建类型支持

• 主分支构建：基于项目主分支（main branch）代码构建，反映最新开发进度。
• PR构建：针对Pull Request（PR）的代码变更进行构建，用于验证PR功能及兼容性。
• 分支构建：支持基于特定开发分支的独立构建，适用于功能分支的并行开发。

使用场景和适用范围

适用场景

• 开发人员：用于本地构建、测试kube-router代码变更，验证功能实现。
• 测试人员：基于不同构建版本（如PR构建）测试新功能或问题修复。
• CI/CD集成：嵌入自动化构建流程，实现代码提交后自动生成对应版本镜像。

适用范围

• kube-router项目开发团队
• 参与kube-router贡献的开发者
• 需要定制或测试kube-router版本的用户

使用方法和配置说明

获取镜像

通过Docker拉取命令获取开发镜像，镜像标签对应不同构建类型：

bash
# 拉取主分支构建镜像
docker pull cloudnativelabs/kube-router-dev:main

# 拉取PR构建镜像（示例PR编号1234）
docker pull cloudnativelabs/kube-router-dev:pr-1234

# 拉取分支构建镜像（示例分支名feature-new-route）
docker pull cloudnativelabs/kube-router-dev:branch-feature-new-route

运行镜像

可通过docker run命令启动镜像，结合挂载本地代码目录进行开发或测试：

bash
# 挂载本地kube-router源码目录，运行主分支构建镜像
docker run -v /path/to/local/kube-router:/kube-router cloudnativelabs/kube-router-dev:main /bin/bash

配置说明

• 镜像标签：通过标签指定构建类型，格式包括main（主分支）、pr-<PR编号>（PR构建）、branch-<分支名>（分支构建）。
• 环境变量：暂无特殊环境变量配置，如需定制构建参数，可在运行容器时通过命令行参数传递。

注意事项

• 本镜像为开发用途，不建议用于生产环境。
• 不同构建类型的镜像可能存在兼容性差异，使用时需对应具体代码版本。
• 镜像拉取前需确保网络通畅，且已配置Docker环境访问对应镜像仓库。