官方文档: 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'