全部產品
Search
文件中心

Function Compute:編譯部署程式碼封裝

更新時間:Jan 11, 2025

本文介紹如何在.NET運行環境編譯器,並打包為ZIP包。編譯打包完成後,您可以在Function Compute控制台或使用Serverless Devs工具上傳程式碼封裝。

C#運行時依賴庫

Function Compute為C#運行時提供以下依賴庫。

您可以通過Nuget程式包獲得以上依賴庫,將其添加到您的<YourProjectName>.csproj檔案中。如下所示。

  <ItemGroup>
        <PackageReference Include="Aliyun.Serverless.Core" Version="1.0.1" />
        <PackageReference Include="Aliyun.Serverless.Core.Http" Version="1.0.3" />
  </ItemGroup>

使用.NET Core CLI工具編譯並部署程式

.NET Core部署程式包,需要包含您的函數的已編譯器集以及其所有程式集的依賴項。您可以直接使用.NET Core CLI工具編譯器。使用 .NET Core CLI工具,您可以通過跨平台方式建立基於.NET的Function Compute應用程式。具體操作,請參見.NET

前提條件

建立服務

步驟一:建立.NET專案

  1. 執行以下命令建立.NET專案。

    dotnet new console -o HelloFcApp -f netcoreapp3.1

    參數解析如下。

    • new console:推薦使用控制台應用程式模板。

    • -o|--output:專案的輸出位置。本文樣本中,會建立一個HelloFcApp目錄,並將專案內容放置到該目錄下。

    • -f|--framework:指定使用的.NET版本。如果運行時版本為.NET Core 3.1,該參數使用netcoreapp3.1

    建立完成後,專案目錄結構如下所示。

    HelloFcApp
    ├── HelloFcApp.csproj
    ├── Program.cs
    └── obj
  2. 在專案目錄下,根據實際情況修改檔案的參數配置。

    • HelloFcApp.csproj檔案

      .NET工程的設定檔,記錄了專案的目標框架、程式集的依賴庫等資訊。您需要在該檔案中添加Function Compute提供的依賴庫,樣本如下。

      <Project Sdk="Microsoft.NET.Sdk">
      
        <PropertyGroup>
          <OutputType>Exe</OutputType>
          <TargetFramework>netcoreapp3.1</TargetFramework>
        </PropertyGroup>
      
        <ItemGroup>
              <PackageReference Include="Aliyun.Serverless.Core" Version="1.0.1" />
              <PackageReference Include="Aliyun.Serverless.Core.Http" Version="1.0.3" />
        </ItemGroup>
      
      </Project>
    • Program.cs檔案

      您的請求處理常式代碼,具體設定可參考事件請求處理常式(Event Handler)HTTP請求處理常式(HTTP Handler)。本文以使用Stream類型的事件請求處理常式為例。

      using System.IO;
      using System.Threading.Tasks;
      using Aliyun.Serverless.Core;
      using Microsoft.Extensions.Logging;
      
      namespace Example
      {
          public class Hello
          {
              public async Task<Stream> StreamHandler(Stream input, IFcContext context)
              {
                  IFcLogger logger = context.Logger;
                  logger.LogInformation("Handle request: {0}", context.RequestId);
                  MemoryStream copy = new MemoryStream();
                  await input.CopyToAsync(copy);
                  copy.Seek(0, SeekOrigin.Begin);
                  return copy;
              }
      
              static void Main(string[] args){}
          }
      }

步驟二:編譯.NET專案

  1. 執行以下命令,進入專案目錄並編譯專案,然後將結果輸出到target目錄下。

    cd HelloFcApp && dotnet publish -c Release -o ./target
  2. 執行以下命令,進入target目錄並進行打包。

    cd target && zip -r HelloFcApp.zip *

    打包完成後,ZIP包的結構如下所示。

    HelloFcApp.zip
    ├── Aliyun.Serverless.Core.dll
    ├── HelloFcApp.deps.json
    ├── HelloFcApp.dll
    ├── HelloFcApp.pdb
    ├── HelloFcApp.runtimeconfig.json
    └── Microsoft.Extensions.Logging.Abstractions.dll
    重要

    請確保已將HelloFcApp.dll等檔案打包至ZIP檔案的根目錄。

步驟三:部署專案代碼並驗證

  1. 登入Function Compute控制台,在左側導覽列,單擊服務及函數
  2. 在頂部功能表列,選擇地區,然後在服務列表頁面,單擊目標服務。
  3. 函數管理頁面,單擊建立函數
  4. 建立函數頁面,選擇使用內建運行時建立,設定函數相關配置項,然後單擊建立

    主要配置項說明如下,其餘配置項選擇預設值即可。

    • 請求程式處理類型:選擇處理事件請求

    • 運行環境:選擇.NET Core 3.1

    • 代碼上傳方式:選擇通過 ZIP 包上傳代碼,然後上傳C#運行時依賴庫打包的ZIP檔案。

    • 請求處理常式:設定為HelloFcApp::Example.Hello::StreamHandler。關於請求處理常式的格式說明,請參見請求處理常式(Handler)

    建立完成後,跳轉至函數詳情頁面的函數代碼頁簽。

  5. 在函數詳情頁面的函數代碼頁簽,單擊測試函數

    成功執行後返回以下結果。

    {
        "key1": "value1",
        "key2": "value2",
        "key3": "value3"
    }

    您還可以單擊日誌輸出頁簽查看詳細日誌。