快速入門：使用 Visual Studio Code 在 Azure 中建立 Go 或 Rust 函式

發行項
03/11/2024

在本文中，您會使用 Visual Studio Code 來建立可回應 HTTP 要求的自訂處理常式。在本機測試程式碼之後，您可以將其部署到 Azure Functions 的無伺服器環境。

自訂處理常式可用來透過執行 HTTP 伺服器程序，以任何語言或執行階段建立函式。本文同時支援 Go 和 Rust。

完成本快速入門後，您的 Azure 帳戶中會產生幾美分或更少的少許費用。

設定您的環境

開始使用之前，請先確定您具備下列必要項目︰

Go
Rust

具有有效訂用帳戶的 Azure 帳戶。免費建立帳戶。
其中一個支援平台上的 Visual Studio Code。
適用於 Visual Studio Code 的 Azure Functions 延伸模組。
Go，建議使用最新版本。請使用 go version 命令來檢查您的版本。

安裝或更新 Core Tools

適用於 Visual Studio Code 的 Azure Functions 延伸模組會整合 Azure Functions Core Tools，讓您可以使用 Azure Functions 執行階段，在 Visual Studio Code 本機執行和偵錯函式。開始之前，最好在本機安裝 Core Tools，或更新現有的安裝以使用最新版本。

在 Visual Studio Code 中，選取 F1 以開啟命令選擇區，然後搜尋並執行命令 Azure Functions: 安裝或更新 Core Tools。

此命令會啟動最新版 Core Tools 的套件型安裝。

建立本機專案

在本節中，您會使用 Visual Studio Code 來建立本機 Azure Functions 自訂處理常式專案。稍後在本文中，您會將函式程式碼發佈至 Azure。

選擇 [活動] 列中的 Azure 圖示。然後，在 [工作區] (本地) 區域中，選取 + 按鈕，然後選擇下拉式清單中的 [建立函式]。收到提示時，選擇 [建立新專案]。
選擇您專案工作區的目錄位置，然後選擇 [選取]。您應建立新資料夾，或為專案工作區選擇空白資料夾。請勿選擇已屬於工作區一部分的專案資料夾。

提示中會提供下列資訊：

提示	選取項目
為您的函式專案選取語言	選擇 `Custom Handler`。
為專案的第一個函式選取範本	選擇 `HTTP trigger`。
提供函式名稱	輸入 `HttpExample`。
授權等級	選擇 `Anonymous`，讓任何人都能呼叫您的函式端點。若要了解授權層級，請參閱授權金鑰。
選取您開啟專案的方式	選擇 `Open in current window`。

使用此資訊，Visual Studio Code 會產生具有 HTTP 觸發程序的 Azure Functions 專案。您可以在 Explorer 中檢視本機專案檔。

建立和建置您的函式

HttpExample 資料夾中的 function.json 檔案會宣告 HTTP 觸發程序函式。您可以藉由新增處理常式並將其編譯為可執行檔來完成函式。

Go
Rust

按 Ctrl + N (macOS 上為 Cmd + N) 以建立新檔案。在函式應用程式根目錄中將它儲存為 handler.go (在與 host.json 相同的資料夾中)。

在 handler.go 中，新增下列程式碼並儲存檔案。這是您的 Go 自訂處理常式。

package main

import (
    "fmt"
    "log"
    "net/http"
    "os"
)

func helloHandler(w http.ResponseWriter, r *http.Request) {
    message := "This HTTP triggered function executed successfully. Pass a name in the query string for a personalized response.\n"
    name := r.URL.Query().Get("name")
    if name != "" {
        message = fmt.Sprintf("Hello, %s. This HTTP triggered function executed successfully.\n", name)
    }
    fmt.Fprint(w, message)
}

func main() {
    listenAddr := ":8080"
    if val, ok := os.LookupEnv("FUNCTIONS_CUSTOMHANDLER_PORT"); ok {
        listenAddr = ":" + val
    }
    http.HandleFunc("/api/HttpExample", helloHandler)
    log.Printf("About to listen on %s. Go to https://127.0.0.1%s/", listenAddr, listenAddr)
    log.Fatal(http.ListenAndServe(listenAddr, nil))
}

按 Ctrl + Shift +` 或從 [終端機] 功能表中選取 [新增終端機]，以在 VS Code 中開啟新的整合式終端機。
使用下列命令編譯您的自訂處理常式。名為 handler 的可執行檔 (Windows 上為 handler.exe) 會在函式應用程式根資料夾中輸出。
```
go build handler.go
```

按 Ctrl + Shift +` 或從 [終端機] 功能表中選取 [新增終端機]，以在 VS Code 中開啟新的整合式終端機。
在函式應用程式根目錄 (與 host.json 相同的資料夾中)，初始化名為 handler 的 Rust 專案。
```
cargo init --name handler
```
在 Cargo.toml 中，新增完成本快速入門所需的下列相依性。該範例使用變形網頁伺服器架構。
```
[dependencies]
warp = "0.3"
tokio = { version = "1", features = ["rt", "macros", "rt-multi-thread"] }
```

在 src/main.rs 中，新增下列程式碼並儲存檔案。這是您的 Rust 自訂處理常式。

use std::collections::HashMap;
use std::env;
use std::net::Ipv4Addr;
use warp::{http::Response, Filter};

#[tokio::main]
async fn main() {
    let example1 = warp::get()
        .and(warp::path("api"))
        .and(warp::path("HttpExample"))
        .and(warp::query::<HashMap<String, String>>())
        .map(|p: HashMap<String, String>| match p.get("name") {
            Some(name) => Response::builder().body(format!("Hello, {}. This HTTP triggered function executed successfully.", name)),
            None => Response::builder().body(String::from("This HTTP triggered function executed successfully. Pass a name in the query string for a personalized response.")),
        });

    let port_key = "FUNCTIONS_CUSTOMHANDLER_PORT";
    let port: u16 = match env::var(port_key) {
        Ok(val) => val.parse().expect("Custom Handler port is not a number!"),
        Err(_) => 3000,
    };

    warp::serve(example1).run((Ipv4Addr::LOCALHOST, port)).await
}

編譯自訂處理常式的二進位檔案。名為 handler 的可執行檔 (Windows 上為 handler.exe) 會在函式應用程式根資料夾中輸出。
```
cargo build --release
cp target/release/handler .
```

設定函式應用程式

函式主機必須設定為在啟動時執行您的自訂處理常式二進位檔案。

開啟 host.json。
在 customHandler.description 區段中，將 defaultExecutablePath 的值設定為 handler (在 Windows 上，將其設定為 handler.exe)。
在 customHandler 區段中，新增名為 enableForwardingHttpRequest 的屬性，並將其值設定為 true。對於只包含 HTTP 觸發程序的函式，此設定透過允許您使用一般 HTTP 要求，而不是自訂處理常式要求承載來簡化程式設計。

確認 customHandler 區段看起來像此範例。儲存檔案。

"customHandler": {
  "description": {
    "defaultExecutablePath": "handler",
    "workingDirectory": "",
    "arguments": []
  },
  "enableForwardingHttpRequest": true
}

函式應用程式已設定為啟動您的自訂處理常式可執行檔。

在本機執行函式

您可以先在本機開發電腦上執行此專案，之後再發佈至 Azure。

在整合式終端機中，使用 Azure Functions Core Tools 啟動函式應用程式。
```
func start
```
在 Core Tools 執行時，瀏覽至下列 URL 以執行 GET 要求 (其中包含 ?name=Functions 查詢字串)。

http://localhost:7071/api/HttpExample?name=Functions
此時會傳回回應，其內容在瀏覽器中會顯示如下：
要求的相關資訊會顯示在 [終端機] 面板中。
按 Ctrl + C 來停止 Core Tools。

確認函式可在本機電腦上正常執行之後，即可使用 Visual Studio Code 將專案直接發佈至 Azure。

您必須先登入 Azure，才能建立 Azure 資源或發布應用程式。

如果您尚未登入，請選擇 [活動] 列中的 Azure 圖示。然後在 [資源] 區域中，選擇 [登入 Azure...]。

如果您已登入，而且可以看到現有的訂閱，請移至下一節。如果您尚未擁有 Azure 帳戶，請選擇 [建立 Azure 帳戶...]。學生可以選擇 [建立 Azure 學生版帳戶...]。
當在瀏覽器中收到提示時，請使用您的 Azure 帳戶認證選擇 Azure 帳戶並登入。如果您建立新的帳戶，可以在帳戶建立之後登入。
成功登入之後，即可關閉新的瀏覽器視窗。屬於您 Azure 帳戶的訂用帳戶會顯示在提要欄位中。

編譯 Azure 的自訂處理常式

在本節中，您會在執行 Linux 的函式應用程式中將專案發佈至 Azure。在大部分情況下，您必須先重新編譯您的二進位檔案，並調整您的設定以符合目標平台，之後再將其發佈至 Azure。

Go
Rust

在整合式終端機中，將處理常式編譯為 Linux/x64。即會在函式應用程式根目錄中建立名為 handler 的二進位檔案。
- macOS
- Linux
- Windows
```
GOOS=linux GOARCH=amd64 go build handler.go
```
```
GOOS=linux GOARCH=amd64 go build handler.go
```
```
set GOOS=linux
set GOARCH=amd64
go build handler.go
```
將 host.json 中的 defaultExecutablePath 從 handler.exe 變更為 handler。這會指示函式應用程式執行 Linux 二進位檔案。

在 .cargo/config 建立檔案。新增下列內容並儲存檔案。
```
[target.x86_64-unknown-linux-musl]
linker = "rust-lld"
```
在整合式終端機中，將處理常式編譯為 Linux/x64。名為 handler 的二進位檔案隨即建立。將它複製到函式應用程式根目錄。
```
rustup target add x86_64-unknown-linux-musl
cargo build --release --target=x86_64-unknown-linux-musl
cp target/x86_64-unknown-linux-musl/release/handler .
```
如果您使用 Windows，請將 host.json 中的 defaultExecutablePath 從 handler.exe 變更為 handler。這會指示函式應用程式執行 Linux 二進位檔案。
將以下這行新增至 .funcignore 檔案：
```
target
```
這可防止發佈 target 資料夾的內容。

在 Azure 中建立函數應用程式

在此區段中，您會在 Azure 訂用帳戶中建立函式應用程式和相關的資源。

選擇 [活動] 列中的 Azure 圖示。然後在 [資源] 區域中，選取 + 圖示並選擇 [在 Azure 中建立函數應用程式] 選項。

提示中會提供下列資訊：

提示	選取項目
選取訂用帳戶	選擇要使用的訂用帳戶。當您只有一個訂用帳戶顯示在 [資源] 底下時，就不會看到此提示。
輸入函數應用程式的全域唯一名稱	輸入在 URL 路徑中有效的名稱。您鍵入的名稱會經過驗證，確定其在 Azure Functions 中是唯一。
選取執行階段堆疊	選擇 [自訂處理常式]。
選取新資源的位置	若要獲得較佳的效能，請選擇您附近的區域。

該延伸模組會在 [Azure：活動記錄] 面板顯示正在 Azure 建立的個別資源狀態。

建立 Azure 資源的記錄

建立完成時，您的訂閱中會建立下列 Azure 資源。資源會根據您的函數應用程式名稱命名：
- 資源群組，這是相關資源的邏輯容器。
- 標準 Azure 儲存體帳戶，其可維護專案的狀態和其他資訊。
- 函數應用程式，其提供執行函式程式碼的環境。函數應用程式可讓您將函式以邏輯單位分組，方便您在相同的主控方案中管理、部署及共用資源。
- App Service 方案，其定義函數應用程式的基礎主機。
- 連線至函數應用程式的 Application Insights 執行個體，可追蹤應用程式中函式的使用量。
建立函式應用程式並套用部署套件之後，即會顯示通知。

提示

根據預設，系統會依照您提供的函數應用程式名稱建立函數應用程式所需的 Azure 資源，並且預設會建立在與函數應用程式相同的新資源群組中。如果您想自訂這些資源的名稱或重複使用現有的資源，必須改為使用進階建立選項發佈專案。

將專案部署至 Azure

重要

部署至現有的函數應用程式一律會覆寫該應用程式在 Azure 中的內容。

在 Azure 活動的 [資源] 區域中，找出您剛才建立的函數應用程式資源，以滑鼠右鍵按一下該資源，然後選取 [部署至函數應用程式...]。
當系統提示您覆寫先前的部署時，請選取 [部署]，將函式程式碼部署至新的函數應用程式資源。
部署完成時，選取 [檢視輸出] 即可檢視建立和部署結果，包括您所建立的 Azure 資源。如果您錯過通知，請選取右下角的鈴鐺圖示，以再次查看。

在 Azure 中執行函數

返回提要欄位中的 [資源] 區域，依序展開您的訂閱和新函數應用程式，以及 [函式]。以滑鼠右鍵按一下 (Windows) 或 Ctrl - 點擊 (macOS) HttpExample 函式，並選擇 [立即執行函式...]。
在 [輸入要求本文] 中，會看到 { "name": "Azure" } 的要求訊息本文值。請按 Enter 鍵，將此要求訊息傳送至您的函式。
當函式在 Azure 執行並傳回回應時，會在 Visual Studio Code 中引發通知。

清除資源

當您繼續進行下一個步驟並將 Azure 儲存體佇列繫結新增至您的函式時，您必須保留所有資源，以您所完成的工作為基礎。

否則，您可以使用下列步驟來刪除函式應用程式及其相關資源，以避免產生任何額外的成本。

在 Visual Studio Code 中，按 F1 開啟命令選擇區。在命令選擇區中，搜尋並選取 Azure: Open in portal。
選擇您的函數應用程式，並按下 Enter。函式應用程式頁面會在 Azure 入口網站中開啟。
在 [概觀] 索引標籤中，選取 [資源群組] 旁的具名連結。
在 [資源群組] 分頁上，檢閱所含資源的清單，並確認這些是您想要刪除的項目。
選取 [刪除資源群組]，並遵循指示。

刪除需要幾分鐘的時間。完成時，通知會出現幾秒鐘的時間。您也可以選取分頁頂端的鈴鐺圖示以檢視通知。

若要深入了解 Functions 成本，請參閱估計使用量方案成本。

下一步

了解 Azure Functions 自訂處理常式