*作者：落語｜阿里雲 Serverless 技術研發*

## 背景

阿里雲函式計算產品 **[** **1]** 在較早的時候支援了 HTTP 觸發器 **[2** **]** 能力，支援使用者使用 HTTP 協議進行函式呼叫。函式計算後端透過一個共享的 APIServer 元件對所有客戶提供響應 HTTP 觸發器呼叫的服務，需要依賴 URL 中的 Path 將客戶流量路由到客戶的函式容器內部。容器內收到的 HTTP 請求 Path 會帶有函式計算的路由標識，如果客戶在函式計算部署 REST 風格的應用，那麼就會遇見 404 問題。

![1.png](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/84e6e743d46045438f208e34f4512807~tplv-k3u1fbpfcp-zoom-1.image "1.png")

在一開始，函式計算並不是為客戶執行中小型規模應用而設計的。函式計算提供了原生的 REST 架構，將每個函式視為一個獨立的資源，通常一個函式只負責一小塊功能，也就是一個 API。如果一個函式只對應一個 API，那麼在函式程式碼中也不必去實現一套路由邏輯去響應不同 URL Path 路徑的請求了。

![2.png](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/dcbdf9d5558a4ce9b04f5f47b2277ce2~tplv-k3u1fbpfcp-zoom-1.image "2.png")

函式計算在近兩年引入了 Custom Runtime/Custom Container Runtime **[3** **]** 型別的函式，客戶可以直接在函式計算上執行自己存量的應用，而不必按照函式計算推薦的架構去拆分自己的應用。客戶以及社群內比較成熟的專案的開發習慣是採用 MVC 等架構，在一個程式中開發大量的 REST API，在程式內按照報文中的 HTTP Path 進行路由，將不同路徑的請求“轉發”至不同的方法或函式進行處理。

![3.png](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/33137fddf98848c78bf39bb4220ce4ee~tplv-k3u1fbpfcp-zoom-1.image "3.png")

在這樣的背景下，客戶可以在函式計算執行存量的 REST 應用，但應用無法正常對外提供服務。客戶花費大量的精力對存量的應用進行改造，而且這個改造僅僅在函式計算是必須的，是一種典型的平臺攜裹使用者的產品設計。

## 使用 fcapp.run 呼叫函式

為了解決上述的問題，併相容存量的函式以及客戶習慣，函式計算為每個新建立的 HTTP 觸發器分配了一個獨立的域名，例如`{random-string}.cn-shanghai.fcapp.run`。使用該域名訪問函式計算，函式計算會按照域名進行路由，將流量轉發至函式容器內，避免對客戶程式碼造成侵入性。

![4.png](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/054615bb99104d4486ba6c0719aa60a2~tplv-k3u1fbpfcp-zoom-1.image "4.png")

## 使用 fcapp-test.run 進行本地網頁測試

由於中國大陸政策的影響，函式計算主域名無法在網際網路為客戶提供網站型別的業務，所有的函式請求結果將被轉為下載行為 **[4** **]** 。對於純 API 型別的函式，我們認為將請求結果轉為下載是沒有影響的。但對於網站屬性的函式，返回的 HTML 文字以及 JavaScript 程式碼強依賴瀏覽器的直譯器才能正常展示。我們判斷讓開發者能夠實時看到函式返回的頁面是一個強訴求。

在生產場景，我們推薦客戶為函式繫結已備案的域名來解決這個問題，而在測試環境有更加簡潔的方案。在測試階段可以臨時透過測試域名 fcapp-test.run 以及新增本地的 host 解析繞過這個問題，請求結果將不會被轉為下載行為，可以正常進行網頁除錯。

```
# 1. 從頁面獲取fcapp.run的域名
FC_DOMAIN='wordpress-xxxxx-serverlordpress-ydziwvakfn.cn-shenzhen.fcapp.run'
FC_TEST_DOMAIN=`echo ${FC_DOMAIN} | sed 's/fcapp.run/fcapp-test.run/g'`
echo "FC域名: ${FC_DOMAIN}"
echo "FC測試域名: ${FC_TEST_DOMAIN}"

# 2. 查詢域名解析的IP
FC_IP=`ping ${FC_DOMAIN} -c 1 | HEAD -1 | awk '{print $3}' | sed 's/[():]//g'`
echo "FC IP: ${FC_IP}"

# 3. 修改host檔案，將測試域名的本地解析指向fcapp.run的解析
#    如果沒有許可權需要手動加
sudo -- sh -c  "printf '\n${FC_IP} ${FC_TEST_DOMAIN}\n' >> /etc/hosts"
cat /etc/hosts

# 4. 使用測試域名在瀏覽器訪問函式
curl -v "${FC_TEST_DOMAIN}"
```

瞭解 TCP 協議以及 HTTP 協議的同學可以很容易地理解背後的技術細節。客戶端在發起 HTTP 請求時，首先會透過域名解析查詢到域名對應的 IP 地址，併發起 TCP 連線。接下來會透過建立的 TCP 連線，將 HTTP Request 報文傳送至 Server 端。如果客戶端直接向函式計算的 Server 發起 TCP 連線，並將可以與函式關聯的域名傳送至函式計算，那麼函式計算就可以返回客戶期望的內容。

函式計算在後端進行了處理，相容了 fcapp-test.run 域名的訪問，但並不提供權威 DNS 解析。客戶只需要在本地進行 Host 配置或者使用自建的 DNS 伺服器，將 fcapp-test.run 的域名解析至函式計算 Server，就能夠正常測試函式。該方案既滿足了中國大陸法律法規的要求，又以極低的成本滿足了客戶除錯頁面的需求，極大地最佳化了客戶在函式計算的研發體驗。

## 使用函式計算執行 wordpress 官方映象

透過以上的方案，函式計算支援客戶在**不修改任何業務**程式碼的前提下遷移自己的 REST 應用。下面使用 wordpress 官方映象進行說明。

### 前置條件

1.  開通函式計算賬號。

1.  將 wordpress 映象轉存到阿里雲容器映象服務中。

1.  建立或使用已有的 mysql 例項，併為 wordpress 服務初始化相應的賬號以及資料庫。如果使用阿里雲 RDS 例項，請確保函式服務的 VPC 配置與 RDS 例項的 VPC 配置一致，且白名單配置正確。

### 建立相應的函式以及服務

使用 wordpress 官方映象建立函式，並設定容器內監聽埠為 80。

![5.png](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/05af379d1d4f421189e2a030c941abf4~tplv-k3u1fbpfcp-zoom-1.image "5.png")

### 注入資料庫配置

修改函式配置，將 mysql 的資料庫配置以環境變數的方式注入函式容器內。

**![6.png](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/1455d3ed868e46d98fa030588ba33e72~tplv-k3u1fbpfcp-zoom-1.image "6.png")**

### 無需備案，測試 wordpress 函式功能

檢視建立的觸發器分配的域名 **[5** **]** ，按照上述文件配置，使用 fcapp-test.run 域名進行測試。

![7.png](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/bf4eb096775746259fef16161cb6b0e0~tplv-k3u1fbpfcp-zoom-1.image "7.png")

![8.png](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/9a1fd334fa6149e5a56918065e723a4f~tplv-k3u1fbpfcp-zoom-1.image "8.png")

### 上線你的函式

對外提供網站型別服務只能透過已備案域名來實現。函式計算使用者可以透過配置自定義域名 **[6** **]** 的功能，將域名與函式進行繫結，使用自己的域名對外提供服務。同時也可以使用任意標準的閘道器型別的雲產品或者開源產品，使用 fcapp.run 的內網域名上線你的函式。

## 小結

作為 Serverless 技術的標誌性產品之一，函式計算長久以來專注於提升產品適用的場景。fcapp.run 域名以及相關產品特性的引入，標誌著函式計算在 REST  場景以及 Web 場景的很大一步。客戶從此可以將 REST 應用零改造地部署在函式計算上，研發測試的體驗以及正式上線的方案都做到了優秀。非常歡迎同學們使用函式計算，並提出寶貴的意見。

## 相關連結
[1] 函式計算產品

*<https:>*

[2] HTTP 觸發器

*<https:>*

[3] Custom Runtime/Custom Container Runtime

*<https:>*

[4] 下載行為

*<https:>*

[5] 分配的域名

*<https:>*

[6] 自定義域名

*<https:>*

點選[**此處**](https://www.aliyun.com/product/fc)，前往函式計算官網檢視更多！</https:></https:></https:></https:></https:></https:>

無需修改程式碼，用 fcapp.run 執行你的 REST 應用

相關文章