應用上游

# 目錄結構

|-- upstreams/
  |-- upstreams.yaml
  |-- ...

YAML 檔案中可以包含一個或多個應用上游配置。

# 配置說明

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

# servers 配置

# checker 配置

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

# 配置示例

app_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:
    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: tcp
    fall: 3
    interval: 3
    timeout: 1
    http_req_method: GET
    http_req_host: test.com
    http_req_uri: /status
app_upstream_name2:
  ssl: true
  disable_ssl_verify: false
  enable_checker: true
  servers:
  - host: 1.1.1.3
    port: 443
  checker:
    type: https
    interval: 3
    timeout: 1
    fall: 3
    rise: 2
    http_req_method: GET
    http_req_uri: /status
    valid_statuses:
    - 200
    - 302

此配置定義了兩個應用上游，一個使用 TCP 健康檢查，另一個使用 HTTPS 健康檢查。

# 使用示例

更新配置到 OpenResty Edge 中：

edge-config https://192.168.1.1 -s -t 2051e780-1897-4ea0-92b4-2c2f0169aa94 -l upstreams -i /root/oredge-configs -d test.com

從 OpenResty Edge 中匯出配置：

edge-config -u https://192.168.1.1 -s -t 2051e780-1897-4ea0-92b4-2c2f0169aa94 -E -l upstreams -d test.com

清理 OpenResty Edge 中的配置：

edge-config -u https://192.168.1.1 -s -t 2051e780-1897-4ea0-92b4-2c2f0169aa94 -c -l upstreams -d test.com

示例中均使用 -l upstreams 來指定只操作應用上游相關的配置。

# 注意事項

1. 每個應用上游必須有一個唯一的名稱。

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

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

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

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

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

7. 如果配置中刪除了某個上游，工具會自動從應用中移除該上游。

8. 在處理配置時，如果發生錯誤，工具會自動清除已經進行的更改，以保持配置的一致性。

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

10. 匯出配置時，如果應用不存在，工具會給出警告資訊。

# 相關文件

• 在“頁面規則 - 代理”中使用應用上游
• 在“映象請求”動作中使用應用上游
• 全域性上游配置