ubuntu下部署envoy并作為前端代理方法
前言
Envoy 是一個開源的高性能、可擴展的代理服務(wù)，最初由 Lyft 公司開發(fā)。它設(shè)計用于處理現(xiàn)代的微服務(wù)架構(gòu)中的網(wǎng)絡(luò)通信，并提供了許多功能，包括負載均衡、服務(wù)發(fā)現(xiàn)、路由、認證、授權(quán)等。Envoy 被廣泛用于構(gòu)建和部署云原生應(yīng)用程序以及微服務(wù)體系結(jié)構(gòu)。
本文將通過將envoy作為前端代理來演示envoy的安裝、配置和簡單使用。
本文使用環(huán)境
Ubuntu 22.04.3 LTS Desktop 64-bit
1 安裝
envoy 編譯比較復(fù)雜，可以使用Envoy 社區(qū)提供的docker鏡像和getenvoy項目，不過getenvoy所使用的版本比較老。在Linux下最簡單的方式還是直接使用官方的envoy預(yù)編譯二進制文件。
1.1 下載
從Envoy 的 GitHub 發(fā)行版頁面下載 Ubuntu 的最新版的envoy預(yù)編譯二進制文件，這里選擇“envoy-1.28.0-linux-x86_64”
https://github.com/envoyproxy/envoy/releases
1.2 安裝envoy
新建項目目錄，將文件復(fù)制到該目錄下（本文使用/home/zhg/Mine/Workplace/getenvoy/）
下載完成后如果是.tar.gz則需要解壓
如果是(application/x-executable)可執(zhí)行文件，則需要添加添加可執(zhí)行權(quán)限
# 重命名為"envoy"方便輸入命令 sudo mv envoy-1.28.0-linux-x86_64 envoy # 添加可執(zhí)行權(quán)限 chmod +x envoy
通過以下命令可以查看envoy版本，以驗證envoy是否正確安裝
./envoy --version
2 配置
配置參考官網(wǎng)
www.envoyproxy.io/docs/envoy/…
envoy 可以通過靜態(tài)配置和動態(tài)配置兩種方式實現(xiàn)，靜態(tài)文件通常yaml格式的文件進行配置，主要字段有:
listeners（監(jiān)聽器）
listeners 字段用于定義Envoy監(jiān)聽的網(wǎng)絡(luò)地址和協(xié)議。它描述了Envoy如何接收和處理傳入的連接請求。
listeners: - name：給監(jiān)聽器命名，方便引用。 - address：指定監(jiān)聽的 IP 地址和端口。 - filters：指定用于處理傳入連接的過濾器鏈，包括協(xié)議轉(zhuǎn)碼、路由、TLS 等。
filter（過濾器）
filters字段通常用于通過配置文件引入和加載Envoy的各種過濾器。過濾器是Envoy的功能組件，用于在請求或響應(yīng)的處理過程中執(zhí)行特定的操作。過濾器可以添加、修改或刪除請求或響應(yīng)的頭信息，執(zhí)行轉(zhuǎn)換，執(zhí)行日志記錄等操作。
envoy.http_connection_manager 是Envoy的HTTP連接管理器，它用于處理HTTP請求和響應(yīng)。它是Envoy配置的核心組件之一，負責管理HTTP連接的生命周期、處理HTTP協(xié)議、執(zhí)行各種過濾器等。該連接管理器允許您配置各種HTTP功能，包括路由、重試、負載均衡、超時等
filters: # 過濾器列表
- name: envoy.http_connection_manager # 使用 Envoy 的 HTTP 連接管理器過濾器
typed_config: # 配置該過濾器的類型和參數(shù)
"@type": type.googleapis.com/envoy.extensions.filters.network.http_connection_manager.v3.HttpConnectionManager
codec_type: HTTP2 # 使用 HTTP/2 編解碼器
stat_prefix: ingress_http # 用于生成統(tǒng)計信息的前綴
route_config: # 路由配置
name: local_route # 路由的名稱
virtual_hosts: # 虛擬主機列表
clusters（集群）
clusters 字段用于定義集群（clusters）。集群是Envoy用于負載均衡和路由請求的基本單元，定義后端服務(wù)的地址、端口、協(xié)議等信息
clusters: - name：定義集群的名稱。 - type：指定集群類型，如 static, strict_dns, sds 等。 - connect_timeout：連接超時時間。 - lb_policy：負載均衡策略，如 round_robin, least_request 等。 - hosts：指定集群的后端主機。 - tls_context：配置 TLS。
routes（路由）
routes 字段用于定義路由規(guī)則。路由規(guī)則確定了Envoy在接收到請求時應(yīng)該將其轉(zhuǎn)發(fā)到哪個后端服務(wù)
routes: - prefix：URL 前綴匹配。 - cluster：指定請求應(yīng)該轉(zhuǎn)發(fā)到的集群。 - timeout：設(shè)置請求超時時間。 - retry_policy：配置請求重試策略。
admin（管理控制）
admin是用于提供管理和監(jiān)控功能的配置選項。通過 Envoy 的 admin`接口，用戶可以查看運行時統(tǒng)計信息、配置信息，執(zhí)行一些診斷命令等
admin: - access_log_path：指定訪問日志文件的路徑。 - address：指定 Envoy 管理界面的監(jiān)聽地址和端口。
以下是一份配置實例，在項目目錄打開終端，輸入以下命令創(chuàng)建配置文件，并將配置內(nèi)容復(fù)制到文件中。
touch envoy_conf.yaml
# Envoy 管理配置
admin:
# 訪問日志路徑
access_log_path: "/home/zhg/Mine/Workplace/getenvoy/envoy.log"
# 管理界面監(jiān)聽地址和端口
address:
socket_address:
address: 0.0.0.0
port_value: 10001
# 靜態(tài)資源配置
static_resources:
listeners:
# 定義一個監(jiān)聽器，監(jiān)聽在 0.0.0.0:10000
- address:
socket_address: { protocol: TCP, address: 0.0.0.0, port_value: 10000 }
filter_chains:
- filters:
# 使用 HTTP 連接管理器過濾器
- name: envoy.filters.network.http_connection_manager
typed_config:
"@type": type.googleapis.com/envoy.extensions.filters.network.http_connection_manager.v3.HttpConnectionManager
codec_type: auto
stat_prefix: http
access_log:
# 記錄 HTTP 請求到文件
- name: envoy.access_loggers.file
typed_config:
"@type": type.googleapis.com/envoy.extensions.access_loggers.file.v3.FileAccessLog
path: "/home/zhg/Mine/Workplace/getenvoy/envoy_http.log"
log_format:
text_format: |
>>>>
start_time: "%START_TIME%"
method: "%REQ(:METHOD)%", original_path: "%REQ(X-ENVOY-ORIGINAL-PATH?:PATH)%", protocol: "%PROTOCOL%", response_code: "%RESPONSE_CODE%", response_flags: "%RESPONSE_FLAGS%"
user_agent: "%REQ(USER-AGENT)%"
authority: "%REQ(:AUTHORITY)%"
upstream_host: "%UPSTREAM_HOST%"
request_id: "%REQ(X-REQUEST-ID)%"
custom_header: "%REQ(custom_header)%"
static_header: "%REQ(static_header)%"
route_config:
name: search_route
virtual_hosts:
- name: backend
domains:
- "*"
routes:
- match:
prefix: "/"
route:
# 將請求發(fā)送到 baidu 集群
cluster: baidu
http_filters:
- name: envoy.filters.http.router
typed_config:
"@type": type.googleapis.com/envoy.extensions.filters.http.router.v3.Router
clusters:
- name: baidu
connect_timeout: 1s
# 使用 STRICT_DNS 模式進行 DNS 解析
type: STRICT_DNS
dns_lookup_family: V4_ONLY
lb_policy: round_robin
load_assignment:
cluster_name: baidu
endpoints:
- lb_endpoints:
- endpoint:
address:
socket_address:
# 目標服務(wù)器地址
address: www.baidu.com
port_value: 80
3 運行envoy
寫好配置文件后，就可以在項目目錄打開終端，輸入以下命令啟動envoy
# 通過靜態(tài)配置文件直接啟動 Envoy # -l debug ：設(shè)置日志級別為debug，可省略 ./envoy -c envoy_conf.yaml -l debug //查看幫助 envoy --help
4.測試
4.1 查看envoy admin
打開瀏覽器，輸入localhost:10001，可以看到envoy已經(jīng)啟動起來，可以正常訪問admin頁面
4.2 代理配置驗證
普通 curl 請求
curl -vvv baidu.com
zhg@zhg-pc:~/Mine/Workplace/envoytest$ curl -vvv baidu.com * Trying 39.156.66.10:80... * Connected to baidu.com (39.156.66.10) port 80 (#0) > GET / HTTP/1.1 > Host: baidu.com > User-Agent: curl/7.81.0 > Accept: */* > * Mark bundle as not supporting multiuse < HTTP/1.1 200 OK < Date: Thu, 16 Nov 2023 0354 GMT < Server: Apache < Last-Modified: Tue, 12 Jan 2010 1300 GMT < ETag: "51-47cf7e6ee8400" < Accept-Ranges: bytes < Content-Length: 81 < Cache-Control: max-age=86400 < Expires: Fri, 17 Nov 2023 0354 GMT < Connection: Keep-Alive < Content-Type: text/html < * Connection #0 to host baidu.com left intact
使用 curl 訪問 Envoy，并添加 Header 字段 host: baidu.com
curl -v -H 'Host: baidu.com' 127.0.0.1:10000
可以看到請求被轉(zhuǎn)發(fā)到了 baidu.com，在響應(yīng)頭中，server: envoy表示服務(wù)器使用的是 Envoy 代理。這是 Envoy 代理的標識，表示請求經(jīng)過了 Envoy
zhg@zhg-pc:~/Mine/Workplace/envoytest$ curl -vvv -H 'Host: baidu.com' 127.0.0.1:15001 * Trying 127.0.0.1:15001... * Connected to 127.0.0.1 (127.0.0.1) port 15001 (#0) > GET / HTTP/1.1 > Host: baidu.com > User-Agent: curl/7.81.0 > Accept: */* > * Mark bundle as not supporting multiuse < HTTP/1.1 200 OK < accept-ranges: bytes < cache-control: private, no-cache, no-store, proxy-revalidate, no-transform < content-length: 2381 < content-type: text/html < date: Thu, 16 Nov 2023 03:45:17 GMT < etag: "588604dc-94d" < last-modified: Mon, 23 Jan 2017 13:27:56 GMT < pragma: no-cache < server: envoy < set-cookie: BDORZ=27315; max-age=86400; domain=.baidu.com; path=/ < x-envoy-upstream-service-time: 18 < ...省略...