Apache OpenWhisk 中创建与调用 .NET Core 动作完全指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00330/article/details/148465952

Apache OpenWhisk 中创建与调用 .NET Core 动作完全指南

openwhisk apache/openwhisk: 这是一个开源的云函数和服务管理平台，用于构建、部署和管理无服务器函数。它允许开发者使用多种编程语言编写函数，并将其作为云服务进行调用。适合云原生和无服务器开发者。项目地址: https://gitcode.com/gh_mirrors/open/openwhisk

前言

Apache OpenWhisk 是一个强大的无服务器计算平台，支持多种编程语言开发函数即服务(FaaS)。本文将重点介绍如何在 OpenWhisk 中创建和调用 .NET Core 动作，帮助.NET开发者快速上手无服务器开发。

准备工作

在开始创建.NET Core动作前，需要确保满足以下条件：

已安装.NET Core SDK（建议使用LTS版本）
设置环境变量DOTNET_HOME指向dotnet可执行文件所在目录
了解基本的OpenWhisk命令行工具使用

.NET Core动作基本结构

OpenWhisk中的.NET Core动作实际上是一个.NET Core类库项目，需要包含一个特定的Main方法作为入口点。该方法签名必须严格遵循以下格式：

public Newtonsoft.Json.Linq.JObject Main(Newtonsoft.Json.Linq.JObject);

这个设计使得OpenWhisk能够统一处理不同语言的函数输入输出，都通过JSON对象进行交互。

创建.NET Core动作项目

1. 初始化项目

首先创建一个新的C#类库项目：

dotnet new classlib -n Apache.OpenWhisk.Example.Dotnet -lang "C#"
cd Apache.OpenWhisk.Example.Dotnet

2. 添加必要依赖

.NET Core动作需要处理JSON数据，因此需要添加Newtonsoft.Json包：

dotnet add package Newtonsoft.Json -v 12.0.1

3. 编写动作代码

创建Hello.cs文件，实现一个简单的问候功能：

using System;
using Newtonsoft.Json.Linq;

namespace Apache.OpenWhisk.Example.Dotnet
{
    public class Hello
    {
        public JObject Main(JObject args)
        {
            string name = "stranger";
            if (args.ContainsKey("name")) {
                name = args["name"].ToString();
            }
            JObject message = new JObject();
            message.Add("greeting", new JValue($"Hello, {name}!"));
            return message;
        }
    }
}

这段代码展示了：

如何接收输入参数（通过JObject）
如何处理参数（检查并获取name字段）
如何构造返回结果（包含问候语的JObject）

构建与打包

1. 发布项目

dotnet publish -c Release -o out

2. 打包发布文件

cd out
zip -r -0 helloDotNet.zip *

注意使用-0参数确保zip不使用压缩，这能提高OpenWhisk加载速度。

高级用法

返回数组类型

除了返回JSON对象，动作还可以返回JSON数组：

public JArray Main(JObject args)
{
    JArray jarray = new JArray();
    jarray.Add("a");
    jarray.Add("b");
    return jarray;
}

处理数组参数

动作也可以接收数组作为输入参数：

public JArray Main(JArray args)
{
    return args; // 原样返回接收到的数组
}

这种设计使得可以创建处理数组数据的动作链（Sequence）。

部署动作

部署.NET Core动作时需要特别注意指定完整的方法路径：

wsk action update helloDotNet helloDotNet.zip --main Apache.OpenWhisk.Example.Dotnet::Apache.OpenWhisk.Example.Dotnet.Hello::Main --kind dotnet:2.2

--main参数格式为：{程序集名称}::{完整类名}::{方法名}

调用动作

调用方式与其他语言动作一致：

wsk action invoke --result helloDotNet --param name World

预期输出：

{
    "greeting": "Hello World!"
}

最佳实践

保持动作轻量：无服务器函数应遵循单一职责原则
合理使用依赖：只添加必要的NuGet包，减少包体积
错误处理：在Main方法中添加try-catch块处理异常
日志输出：使用Console.WriteLine输出调试信息
版本兼容：确保使用的.NET Core版本与OpenWhisk运行时兼容

总结

通过本文，我们系统地学习了在Apache OpenWhisk中创建、构建、部署和调用.NET Core动作的全过程。.NET Core作为OpenWhisk支持的语言之一，为.NET开发者提供了进入无服务器计算领域的便捷途径。掌握这些基础知识后，开发者可以进一步探索更复杂的应用场景，如动作序列、Web动作等高级功能。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考