當您需要從外部系統或客戶端訪問部署在SAE中的服務時,可以通過在云原生API網關中創建HTTP API,從而實現訪問SAE里應用提供的服務,提升了服務的可訪問性和外部集成能力。本文介紹如何通過配置HTTP API來訪問SAE應用中的服務。
前提條件
已完成云原生API網關創建,具體操作,請參見創建網關實例。
已完成SAE應用創建,且應用的VPC和網關的VPC一致, 具體操作,請參見在SAE控制臺使用JAR文件部署微服務應用。
應用配置基于K8s ServiceName配置應用服務訪問,具體操作,請參見基于K8s ServiceName配置應用服務訪問。
方案概覽
創建HTTP API:配置API的基本信息。
創建路由:
配置路由規則:定義API與SAE應用K8s Service的映射關系,確保請求能夠準確地被路由到正確的目標服務。
關聯環境:選擇合適的環境(如開發、測試或生產環境),確保路由配置在實際部署時能夠正確應用。
關聯服務:將服務實例與路由規則關聯,實現服務的動態發現與調用,提升系統的靈活性和擴展性。
路由調試:通過模擬請求和分析響應,驗證云原生API網關與SAE應用K8s Service的集成是否符合預期,確保服務調用的高效性和穩定性。
操作步驟
步驟一:創建HTTP API
登錄云原生API網關控制臺。
在左側導航欄,選擇API,并在頂部菜單欄選擇地域。
在API頁面單擊左上角創建API。
選擇HTTP API,單擊創建,在創建HTTP API頁面填寫API名稱和描述。
步驟二:創建路由
單擊目標API名稱,進入API詳情頁,單擊創建路由,在創建路由面板,配置相關參數。
1.配置路由基本信息
基本信息參數如下:
路由名稱:自定義路由名稱,創建后路由名稱不可修改。
域名:您可以直接單擊右側的添加域名,在添加域名面板中創建。
路徑(Path):匹配Path參數以
/
開頭的HTTP請求。
2.關聯環境/網關/VPC
在創建網關實例時,系統將自動創建默認環境自動關聯該實例,默認環境以default開頭,您可以選擇默認環境。
(可選)如果您不想使用默認環境,可單擊環境/網關/VPC配置項后方的創建環境,自定義環境創建:配置環境名稱、所屬實例、描述。
使用場景:選擇單服務。
3.創建服務
在后端服務配置項中的服務名稱下拉選項框中,單擊創建服務。
選擇來源類型為SAE Kubernetes 服務。
創建服務基本信息參數如下:
命名空間:選擇SAE中的命名空間。
服務列表:在服務列表中選擇您的SAE應用注冊的K8s service 服務名稱。
保存并發布路由。
步驟三:路由調試
路由發布成功后,單擊目標路由操作列的調式。
在調試面板中輸入相關接口參數,并單擊發送,在右側即可看到服務接口的返回結果。
相關文檔
當您容器服務中的應用需要通過外部訪問時,請參考通過HTTP API訪問容器服務中的應用。
當您在使用云原生API網關過程中遇到問題時,請查看常見問題。