官方文档: https://www.envoyproxy.io/docs
1.6.0版官方文档: https://www.envoyproxy.io/docs/envoy/v1.6.0/
一、 编译和安装
1、 编译
Envoy使用 Bazel工具 构建系统。
为了简化初次构建以及快速入门，我们提供了一个基于Ubuntu16的Docker容器镜像，其中包含了构建静态链接Envoy所需的所有内容，请参阅 ci/README.md
目前有3个基础的编译用的镜像:
(1) envoyproxy/envoy-build 等同于 envoyproxy/envoy-build-ubuntu.
(2) envoyproxy/envoy-build-ubuntu 基于 Ubuntu 16.04 (Xenial) ,使用 GCC 5.4 compiler.
(3) envoyproxy/envoy-build-centos 基于 CentOS 7,使用 GCC 5.3.1 compiler (devtoolset-4).
构建envoy二进制文件:
# 首先 clone 代码
git clone https://github.com/envoyproxy/envoy.git
cd envoy
# 构建 dev 版本的 envoy
./ci/run_envoy_docker.sh './ci/do_ci.sh bazel.dev' # 构建默认使用的是 envoyproxy/envoy-build-ubuntu 镜像, 如果要使用其他的镜像,则如下 IMAGE_NAME=envoyproxy/envoy-build-centos \ ./ci/run_envoy_docker.sh './ci/do_ci.sh bazel.dev' # 如果要使用代理 IMAGE_NAME=envoyproxy/envoy-build-centos \ http_proxy=http://10.0.209.105:17012 \ https_proxy=http://10.0.209.105:17012 \ ./ci/run_envoy_docker.sh './ci/do_ci.sh bazel.dev' # dev 版本编译后的envoy二进制文件默认位于宿主机的 /tmp/envoy-docker-build/envoy/source/exe/envoy-fastbuild # 你可以通过变量 ENVOY_DOCKER_BUILD_DIR=~/build 更改此位置为 ~/build # 构建 release 版本的 envoy IMAGE_NAME=envoyproxy/envoy-build-centos \ ./ci/run_envoy_docker.sh './ci/do_ci.sh bazel.release.server_only' # release 版本编译后的envoy二进制文件默认位于宿主机的 /tmp/envoy-docker-build/envoy/source/exe/envoy # 你可以通过变量 ENVOY_DOCKER_BUILD_DIR=~/build 更改此位置为 ~/build # 构建 debug 版本的 envoy IMAGE_NAME=envoyproxy/envoy-build-centos \ ./ci/run_envoy_docker.sh './ci/do_ci.sh bazel.debug.server_only' # debug 版本编译后的envoy二进制文件默认位于宿主机的 /tmp/envoy-docker-build/envoy/source/exe/envoy-debug # 你可以通过变量 ENVOY_DOCKER_BUILD_DIR=~/build 更改此位置为 ~/build # 使用自定义的镜像tag IMAGE_NAME=envoyproxy/envoy-build-centos \ IMAGE_ID=latest \ ./ci/run_envoy_docker.sh './ci/do_ci.sh bazel.release.server_only' # 最终的构建命令 (IMAGE_ID=latest可选) # 代理只是在外面执行命令时访问网络有用,在容器内编译时如果不能直接访问网络,编译仍然会失败 # 至于如何设置容器内的环境变量，以及设置哪些环境变量，待续 IMAGE_NAME=envoyproxy/envoy-build-centos \ http_proxy=http://10.0.209.105:17012 \ https_proxy=http://10.0.209.105:17012 \ ./ci/run_envoy_docker.sh './ci/do_ci.sh bazel.release.server_only'