如何构建修改部分Envoy代码后的新版proxyv2镜像？

前置环境准备 #

• 提前装好对应依赖：开启buildx功能的Docker、和你所用Envoy分支指定版本完全一致的Bazel、Python3、git、gcc/g++等基础编译工具链，Bazel版本别错配，否则大概率编译中途报莫名错误。
• 确认你本地修改后的Envoy源码目录权限正常，避免后续Docker挂载或编译时出现文件读取失败问题。

对齐构建适配配置 #

proxyv2为Istio生态的标准Sidecar镜像，不能直接用裸编译的Envoy二进制打包，需要先对齐Istio侧的适配逻辑：

• 拉取和你目标使用环境版本完全匹配的istio/proxy仓库源码，切换到对应版本tag，将你修改后的Envoy代码替换到仓库内的envoy子模块路径，注意不要覆盖istio/proxy预置的Envoy补丁、编译规则文件，否则编出的二进制会和Istio控制面不适配。
• 检查仓库根目录下的WORKSPACE、.bazelrc配置文件，将其中远程拉取官方Envoy源码的逻辑改为指向你本地修改后的源码路径。
• 如果你不需要适配Istio生态，仅需自定义打包proxyv2镜像，可以跳过这步，直接准备好对应镜像的基础Dockerfile即可。

本地预编译验证 #

• 在Envoy源码根目录执行优化编译，先验证自定义代码可正常编译通过：bazel build //source/exe:envoy-static -c opt，该模式编译出的二进制为生产可用的优化版本，编译速度也比调试版本快。
• 编译完成后先做基础冒烟校验：执行bazel-bin/source/exe/envoy-static --version确认版本输出正常，再用一份最小可用的Envoy测试配置执行bazel-bin/source/exe/envoy-static -c test_config.yaml，确认进程可以正常启动，你的自定义修改没有导致核心逻辑崩溃。

镜像构建 #

• 进入镜像构建上下文目录，如果你用istio/proxy的标准构建流程，直接使用仓库内预置的docker/Dockerfile.proxyv2即可，有自定义基础镜像、内置启动脚本、iptables规则需求的可以在这一步调整Dockerfile。
• 执行构建命令，指定你本地编译好的Envoy静态二进制路径：

docker buildx build \
  -f docker/Dockerfile.proxyv2 \
  --build-arg ENVOY_BINARY_PATH=./bazel-bin/source/exe/envoy-static \
  -t 自定义镜像仓库地址/自定义镜像名:自定义版本tag \
  --load .

• 如果需要直接将构建好的镜像推送到私有仓库，把命令里的--load替换为--push即可，执行前记得提前通过docker login完成私有仓库的认证。

构建后校验 #

• 本地启动临时容器校验镜像内二进制正确性：docker run --rm 你构建的镜像名:tag /usr/local/bin/envoy --version，输出的版本信息、编译时间和你本地编译结果一致即为正常。
• 建议搭最小测试环境替换原有proxyv2镜像做流量测试，确认你的自定义修改逻辑正常生效，没有兼容性问题。

注意：如果你的修改涉及xDS协议处理、控制面交互相关逻辑，一定要和你使用的Istio版本支持的Envoy API版本对齐，不要跨大版本修改代码，否则会出现xDS连接失败、配置不生效等问题。

内容的提问来源于stack exchange，提问作者张萨慕