Envoy数据平面API项目启动与配置教程

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

Envoy数据平面API项目的目录结构如下：

data-plane-api/
├── api/
│   ├──_aggregate/
│   ├── cashier/
│   ├── clamp/
│   ├── config/
│   ├── doc/
│   ├── eds/
│   ├── endpoint/
│   ├── http_connection_manager/
│   ├── listener/
│   ├── route/
│   ├── tcp_proxy/
│   └── udp/
├── bazel/
├── buildovers/
├── ci/
├── docs/
├── examples/
├── test/
├── test/integration/
├── test/mocks/
├── test/common/
├── test/server/
└── tools/

这里简要介绍几个主要目录：

• api/: 包含了Envoy数据平面API的protobuf定义文件，这些定义了Envoy的各种资源和配置。
• examples/: 提供了一些使用Envoy数据平面API的示例代码。
• docs/: 存放项目的文档。
• test/: 包含了测试代码，包括单元测试和集成测试。

2. 项目的启动文件介绍

在examples/目录中，可以找到一些启动Envoy的示例配置文件，例如simple_httpProxy.yaml。以下是一个简化的启动文件示例：

admin:
  access_log_path: /tmp/admin_access.log
  address:
    socket_address:
      address: 0.0.0.0
      port_value: 9901

static_resources:
  listeners:
  - name: listener_0
    address:
      socket_address:
        address: 0.0.0.0
        port_value: 10000
    filter_chains:
    - filters:
      - name: envoy.http_connection_manager
        config:
          codec_type: AUTO
          stat_prefix: ingress_http
          route_config:
            name: local_route
            virtual_hosts:
            - name: local_service
              domains:
                - "*"
              routes:
              - match:
                  prefix: "/"
                route:
                  cluster: some_service
  clusters:
  - name: some_service
    connect_timeout: 1s
    type: STATIC
    lb_policy: ROUND_ROBIN
    hosts:
    - socket_address:
        address: 127.0.0.1
        port_value: 10001

这个配置文件定义了一个监听器，它监听HTTP请求并转发到一个名为some_service的集群。

3. 项目的配置文件介绍

Envoy的配置文件通常使用YAML格式，上面已经展示了一个简单的配置文件示例。以下是对配置文件中一些关键部分的解释：

• admin: 定义了Envoy管理接口的监听地址和端口，以及访问日志文件路径。
• static_resources: 包含了静态资源配置，如监听器和集群。
• listeners: 定义了Envoy要监听的端点，以及与这些端点关联的过滤器链。
• filter_chains: 过滤器链定义了如何处理进入和出去的流量。
• clusters: 集群定义了Envoy将流量转发到的上游服务。

正确配置这些元素是确保Envoy正确处理网络流量的关键。详细的配置选项和最佳实践可以在Envoy的官方文档中找到。