騰訊雲雲函數 (SCF) 已經支持十多種編程語言和運行時框架。騰訊雲最近發布的 SCF custom runtime(自定義運行時)更進一步 —— SCF 現在可以支持用任何編程語言編寫的函數。
本文將介紹如何在雲函數 SCF 中運行用 Rust 編寫的 WebAssembly 函數。
我們先介紹一些基本概念,然后回顧一個完整但簡單的 hello world 示例,部署您的第一個 WebAssembly 無服務器函數。最后,我們將用一個機器學習即服務 (MLaaS) 示例來做一些有用的事情。該示例接受數據並以 SVG 格式返回擬合模型和可視化。
這是本教程結束時你將創建的最終應用。它完全是「無服務器」的,只有使用時會產生成本。
HTML 和 JavaScript UI 可以托管在任何計算機上,包括筆記本電腦上。在騰訊雲 Serverless 上的后端函數執行機器學習和 SVG 繪圖。
為什么選擇 WebAssembly 和 Rust
傳統的無服務器函數基於重量級的框架。開發者必須在特定的應用框架中編寫函數,比如 Node.js 中的 JavaScript 或 Python Boto。
騰訊雲 SCF Custom Runtime 打破了這種模式,允許開發者用任何語言編寫無服務器函數。
為了演示這個優勢,本文提供了基於 Bash 腳本的函數、基於 Deno 的 TypeScript 函數和基於 Rust 的本機二進制函數的示例。這使我們能夠在騰訊雲上創建和部署基於 web 組件的無服務器函數。
為什么要這么做?
以下是一些原因:
- WebAssembly 是為性能而設計的。 WebAssembly 函數可以比用JavaScript 或者 Python 快 10 倍。
- WebAssembly 函數是可移植的。雖然可以在 SCF Custom runtime上運行本地二進制文件,但必須將這些二進制文件編譯到 Custom runtime 的確切操作系統環境中。目前在 X86 CPU 上使用的是 CentOS 7.6,之后可能會更改。正如我們將要看到的,WebAssembly 函數是可移植的,並且非常容易部署和管理。
- WebAssembly 函數是安全的。眾所周知,即使使用 Docker,本地二進制應用程序也可能會破壞容器。由於你的應用程序可能依賴於許多第三方庫,因此你的依賴項中存在危險代碼的風險真實存在。 WebAssembly 有着基於能力的安全模型, 為你的代碼提供更好的運行時保護。
- 雖然 WebAssembly 兼容各種編程語言,但 Rust、AssemblyScript (TypeScript)、C/C++ 和 Go 是寫 WebAssembly 函數的最佳語言,尤其是 Rust。Rust 是一種流行且越來越受矚目的編程語言,社區非常活躍。Rust 讓我們能夠寫一個高效但內存安全的函數。
最后,在騰訊雲上編寫和部署 WebAssembly 函數實際上非常簡單,在一個小時內就可以完成。
前期准備
首先,注冊一個騰訊雲賬戶。對大多數開發和個人項目來說,開發工作都可以在免費額度內進行。
確保你已經在地開發計算機或 Docker 容器上安裝了 Rust 和 ssvmup 工具鏈。ssvmup 工具鏈將 Rust 程序編譯並優化為 WebAssembly 字節碼。只需使用以下簡單命令即可安裝。你也可以參考這個指南。
$ curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
$ source $HOME/.cargo/env
... ...
$ curl https://raw.githubusercontent.com/second-state/ssvmup/master/installer/init.sh -sSf | sh
WebAssembly 函數是在 Second State 虛擬機 SSVM 里執行的。SSVM 是專為服務端的用例和應用優化的高性能 WebAssembly 虛擬機。
Hello, world
要在騰訊雲上部署 Rust 和 WebAssembly 函數, 我們建議 clone 或者 fork GitHub 上的模板 repo,並把這個模板作為你自己應用的基礎。
在 main.rs
上的 Rust 函數是我們將部署到 SCF 的無服務函數。正如你能從源代碼看到的那樣,它能從 STDIN 讀取函數的輸入, 然后用 println! macro 把結果發送到 STDOUT。
use std::io::{self, Read};
use serde::Deserialize;
fn main() {
let mut buffer = String::new();
io::stdin().read_to_string(&mut buffer).expect("Error reading from STDIN");
let obj: FaasInput = serde_json::from_str(&buffer).unwrap();
let key1 = &(obj.key1);
let key2 = &(obj.key2);
println!("Hello! {}, {}", key1, key2);
}
#[derive(Deserialize, Debug)]
struct FaasInput {
key1: String,
key2: String
}
Rust main() 函數使用 serde 庫來從 STDIN 解析一個 JSON 字符串。
JSON 看起來像下面這樣。 我們之所以用這種方式編寫函數,是因為SCF 使用內置的 hello world JSON 模板來測試部署好的函數。
{
"key1": "test value 1",
"key2": "test value 2"
}
函數提取 key1 和 key2 值並輸出下面的 hello 消息到 STDOUT。
Hello! test value 1, test value 2
但是,這個函數的 web 請求是如何被轉換成 STDIN 的?如何將 STDOUT 中的函數響應轉換為 HTTP 響應?
這是通過我們模板中的 SCF custom runtime 基礎設施和引導 (bootstrap) 程序完成的。
正如你所看到的那樣,引導程序只是一個 bash shell 程序,它不斷地輪詢雲函數 SCF 以查找傳入的請求。它將傳入的請求轉換為 STDIN,並通過 SSVM 調用 WebAssembly 函數。然后,它接受 STDOUT 輸出,並將其作為函數的響應發給 SCF。
如果你使用我們的模板,就不需要修改引導程序。
現在,可以使用 ssvmup 將 Rust 函數構建到 WebAssembly 字節碼中,然后將 zip 文件打包,從而在騰訊雲 SCF Custom Runtime 上進行部署。
$ ssvmup build
... ...
$ cp pkg/hello_bg.wasm cloud/
$ cd cloud
$ zip hello.zip *
按照這個說明和截圖來部署並測試上面 hello.zip
文件。現在已經成功地部署了一個 WebAssembly 無服務器函數!
接下來,讓我們用 Rust 函數創建一個有價值的 web 服務。
機器學習即服務
這個例子中,我們選擇了一個計算密集型的機器學習任務來演示 Rust WebAssembly 函數的性能。
無服務器函數采用以逗號分隔的數字輸入字符串,這些數字表示二維平面上的一組點。輸入的數據格式是 x1,y1,x2,y2,...
該函數分析數據並計算兩個特征向量,指示數據中最大方差的方向。特征向量為數據科學家提供了關於驅動數據變化的潛在因素的線索。這就是所謂的主成分分析。
我們的函數創建一個 SVG 圖,並且在這個圖上繪制輸入的數據點以及上面計算得到的特征向量。該函數最后以 XML 文本的形式返回這個 SVG 圖。
要開始這個例子,你可以 clone 或者 fork 這個 repo。該項目在 tencentcloud/ssvm/pca
文件夾中。或者你可以復制 Cargo.toml
和 src/*
的內容到上文的 hello world 模板。如果你選擇后者,確保你修改了 Cargo.toml
,將其指向 Rust 機器學習庫的正確源代碼文件夾。
本教程中不會深入探討 PCA 或 SVG 生成的 Rust 源代碼的細節,因為它們涉及大量的計算代碼。
遵照與 hello world 示例中相同的步驟。使用 ssvmup 構建一個 pca.zip
包,並將其部署到騰訊雲 SCF custom runtime 上。
接下來,我們將部署好的函數與 web API 網關關聯起來,以便可以從 web HTTP 或 HTTPS 請求調用它。在 SCF 的 web 控制台的觸發管理選項卡中執行此操作。這里可以查看教程和截圖
API 控制台將 HTTP 請求轉換為無服務器函數的 JSON 輸入。例如,這里有一個對 API 網關 URL 的 HTTP POST 請求。我們將來自 iris.csv
文件的以逗號分隔的數據點放在 POST 主體中。
$ curl -d @iris.csv -X POST https://service-m9pxktbc-1302315972.hk.apigw.tencentcs.com/release/PCASVG
API 網關將以下 JSON 傳到 Rust 函數的 STDIN。POST body 現在是 JSON 中的 body 屬性。
{
"body": "3.5,0.2,3,0.2,...",
"headerParameters": {},
"headers": {
"accept": "/",
"content-length": "11",
"content-type": "application/x-www-form-urlencoded",
"host": "service-aj0plx8u-1302315972.hk.apigw.tencentcs.com",
"user-agent": "curl/7.54.0",
"x-anonymous-consumer": "true",
"x-api-requestid": "e3123014742e7dd79f0652968bf1f62e",
"x-b3-traceid": "e3123014742e7dd79f0652968bf1f62e",
"x-qualifier": "$DEFAULT"
},
"httpMethod": "POST",
"path": "/my_hk",
"pathParameters": {},
"queryString": {},
"queryStringParameters": {},
"requestContext": {
"httpMethod": "ANY",
"identity": {},
"path": "/my_hk",
"serviceId": "service-aj0plx8u",
"sourceIp": "136.49.211.114",
"stage": "release"
}
}
Rust 函數解析主體中的數據,執行 PCA,並生成 SVG 圖形。它將 SVG 內容打印到 STDOUT,后者由 API 網關獲取並作為 HTTP 響應發送回來。
要在 AJAX 請求中使用此 API 網關 URL,還必須配置騰訊雲網關以接受 CORS web 請求。查看指南,了解如何做到這一點。
下面的 HTML JavaScript 例子展示了如何在網頁中使用這個無服務器函數。
它通過 ID csv_data
從 textarea
字段獲取 CSV 數據,向無服務器函數發出 AJAX HTTP POST 請求,然后把返回值(一個 SVG 圖形)放入 ID 為 svg_img
的 HTML 元素中。點擊這里查看 demo。
$.ajax({
method: "POST",
url: "https://service-m9pxktbc-1302315972.hk.apigw.tencentcs.com/release/PCASVG",
data: $('#csv_data').val(),
dataType: "text"
}).done(function(data) {
$('#svg_img').html(data);
})
接下來
騰訊的 SCF Custom runtime 是一個非常強大的無服務運行環境。它為你想要編寫的任何應用程序函數提供了一個通用的 Linux 環境,並提供了標准的 web 接口來與函數的輸入和輸出進行交互。這絕對值得一試。
正如本文所討論的,我們相信 Rust 和 WebAssembly 為無服務器函數提供了一個高性能、安全、可移植、面向未來的堆棧。Rust、WebAssembly 與 SCF costum runtime 代表了未來!
One More Thing
立即體驗騰訊雲 Serverless Demo,領取 Serverless 新用戶禮包 👉 serverless/start
歡迎訪問:Serverless 中文網!