开源项目 Envoy 使用教程

最新推荐文章于 2025-04-22 10:20:45 发布

费发肠Norman

最新推荐文章于 2025-04-22 10:20:45 发布

阅读量386

点赞数 3

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_01193/article/details/141544350

开源项目 Envoy 使用教程

envoyA ssh/gpg-agent wrapper leveraging cgroups and systemd/socket activation项目地址:https://gitcode.com/gh_mirrors/envoy2/envoy

1. 项目的目录结构及介绍

Envoy 项目的目录结构如下：

envoy/
├── .github/
├── api/
├── ci/
├── docs/
├── examples/
├── generated/
├── source/
├── test/
├── tools/
├── BUILD
├── CONTRIBUTING.md
├── LICENSE
├── README.md
├── WORKSPACE

目录介绍

.github/: GitHub 配置文件和模板。
api/: Envoy 的 API 定义文件。
ci/: 持续集成配置文件。
docs/: 项目文档。
examples/: 示例配置和使用案例。
generated/: 生成的代码文件。
source/: 源代码文件。
test/: 测试代码文件。
tools/: 开发工具和脚本。
BUILD: Bazel 构建文件。
CONTRIBUTING.md: 贡献指南。
LICENSE: 项目许可证。
README.md: 项目介绍和使用说明。
WORKSPACE: Bazel 工作区文件。

2. 项目的启动文件介绍

Envoy 的启动文件位于 source/exe/main.cc。这个文件包含了 Envoy 的主函数入口，负责初始化和启动 Envoy 进程。

// source/exe/main.cc

int main(int argc, char** argv) {
  // 初始化 Envoy
  Envoy::MainCommon main_common(argc, argv);
  // 启动 Envoy
  return main_common.run();
}

3. 项目的配置文件介绍

Envoy 的配置文件通常是一个 YAML 文件，用于定义 Envoy 的运行时行为和网络配置。配置文件的示例可以在 examples/ 目录中找到。

配置文件示例

node:
  id: node_1
  cluster: cluster_1

static_resources:
  listeners:
  - name: listener_0
    address:
      socket_address: { address: 0.0.0.0, port_value: 10000 }
    filter_chains:
    - filters:
      - name: envoy.filters.network.http_connection_manager
        typed_config:
          "@type": type.googleapis.com/envoy.extensions.filters.network.http_connection_manager.v3.HttpConnectionManager
          stat_prefix: ingress_http
          route_config:
            name: local_route
            virtual_hosts:
            - name: local_service
              domains: ["*"]
              routes:
              - match: { prefix: "/" }
                route: { cluster: service_foo }
          http_filters:
          - name: envoy.filters.http.router
  clusters:
  - name: service_foo
    connect_timeout: 0.25s
    type: LOGICAL_DNS
    lb_policy: ROUND_ROBIN
    load_assignment:
      cluster_name: service_foo
      endpoints:
      - lb_endpoints:
        - endpoint:
            address:
              socket_address: { address: foo.example.com, port_value: 80 }