2 分鐘閱讀 | 最後修改: 0001-01-01, 0:00:00 am

全域性上游

目錄結構

|-- global_upstreams/
  |-- global_upstreams.yaml
  |-- ...

YAML 檔案中可以包含一個或多個全域性上游配置。

配置說明

每個全域性上游配置是一個鍵值對，其中鍵是上游名稱，值是一個包含以下引數的物件：

引數名資料型別是否必選描述
sslboolean否是否啟用 SSL 連線，預設為 false
disable_ssl_verifyboolean否是否禁用 SSL 驗證，預設為 false
enable_checkerboolean否是否啟用健康檢查，預設為 false
serversarray是上游伺服器列表
checkerobject否健康檢查配置，僅在 enable_checker 為 true 時有效

servers 配置

引數名資料型別是否必選描述
hoststring是伺服器主機名或 IP 地址
portinteger是伺服器埠號

checker 配置

健康檢查配置包含多個引數，用於定義如何進行健康檢查。主要引數包括：

引數名資料型別描述
typestring健康檢查型別，如 “tcp”, “http”, “https”
intervalinteger檢查間隔
timeoutinteger超時時間
fallinteger連續失敗次數閾值
riseinteger連續成功次數閾值
http_req_methodstringHTTP 請求方法
http_req_uristringHTTP 請求 URI
valid_statusesarray有效的 HTTP 狀態碼列表

配置示例

global_upstream_name1:
  ssl: false
  disable_ssl_verify: false
  enable_checker: true
  servers:
  - host: 1.1.1.1
    port: 80
  - host: 1.1.1.2
    port: 80
  checker:
    interval_unit: sec
    http_req_method: GET
    ssl_verify: true
    concurrency: 5
    always_check: false
    report_interval_unit: min
    rise: 2
    timeout: 1
    interval: 3
    type: tcp
    http_ver: '1.0'
    report_interval: 3
    fall: 3
global_upstream_name2:
  ssl: true
  disable_ssl_verify: false
  enable_checker: true
  servers:
  - host: 1.1.1.3
    port: 443
  checker:
    user_agent: Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0
    valid_statuses:
    - 200
    - 302
    rise: 2
    type: https
    fall: 3
    ssl_verify: true
    interval_unit: sec
    http_req_method: GET
    concurrency: 5
    http_req_host: test.com
    resp_body_match: abc
    timeout: 1
    interval: 3
    always_check: false
    http_ver: '1.0'
    http_req_uri: /status
    report_interval_unit: min
global_upstream_name3:
  ssl: false
  disable_ssl_verify: false
  enable_checker: false
  servers:
  - host: 1.1.1.1
    port: 80
  - host: 1.1.1.2
    port: 80

此配置定義了三個全域性上游，分別啟用了不同的設定和健康檢查配置。

使用示例

更新配置到 OpenResty Edge 中：

edge-config https://192.168.1.1 -s -t 2051e780-1897-4ea0-92b4-2c2f0169aa94 -l global_upstreams -i /root/oredge-configs

從 OpenResty Edge 中匯出配置：

edge-config -u https://192.168.1.1 -s -t 2051e780-1897-4ea0-92b4-2c2f0169aa94 -E -l global_upstreams

示例中均使用 -l global_upstreams 來指定只匯入/匯出全域性上游相關的配置。

注意事項

  1. 全域性上游是一個全域性配置，為了保持與多個本地配置的相容性，在更新配置時不會執行刪除操作。

  2. 每個全域性上游必須有一個唯一的名稱。

  3. 伺服器的 host 可以是 IPv4 地址、IPv6 地址或域名。

  4. port 必須是一個有效的埠號（1-65535）。

  5. 如果啟用了健康檢查（enable_checker: true），必須提供有效的 checker 配置。

  6. 在更新配置時，工具會比較新舊配置來確定是否需要更新。如果配置有變化，則會執行更新操作。

  7. 在匯入配置時，工具會先檢查配置的有效性，然後再執行新增或更新操作。

  8. 在匯出配置時，工具會將伺服器資訊格式化為統一的結構，便於配置的可讀性和可移植性。

相關文件