Apache OpenWhisk .NET 运行时库教程

Apache OpenWhisk .NET 运行时库教程

openwhisk-runtime-dotnetApache OpenWhisk Runtime .Net supports Apache OpenWhisk functions written in .Net languages项目地址:https://gitcode.com/gh_mirrors/op/openwhisk-runtime-dotnet

本文档将指导您了解并使用 openwhisk-runtime-dotnet 项目，它是Apache OpenWhisk中的.NET Core运行时支持。

1. 项目目录结构及介绍

openwhisk-runtime-dotnet 的目录结构如下：

.
├── core             # 包含.NET Core运行时的核心代码
│   ├── gradle        # Gradle构建相关的脚本
│   └── tests         # 测试相关代码
├── tools             # 工具和辅助脚本
│   ├── vagrant       # Vagrant配置用于本地开发环境
└── etc               # 配置文件
    ├── asf.yaml      # ASF相关的配置
    ├── gitignore     # Git忽略文件列表
    ├── scalafmt.conf # Scala代码格式化配置
    ├── travis.yml    # Travis CI持续集成配置
    └── ...            # 其他许可证、贡献指南等文档

该目录结构主要分为核心代码、测试和工具部分，便于开发、测试和部署.NET Core动作。

2. 项目的启动文件介绍

在 openwhisk-runtime-dotnet 中，一个.NET Core行动是由符合特定签名的方法定义的类库来实现的。这个方法称为 Main:

public static Newtonsoft.Json.Linq.JObject Main(Newtonsoft.Json.Linq.JObject args)

Main 方法接收一个 JObject 参数，代表输入参数，然后返回一个 JObject，作为函数执行的结果。

要创建一个简单的.NET Core动作，您需要遵循以下步骤：

1. 创建一个新的C#项目。
2. 安装 Newtonsoft.Json NuGet 包。
3. 编写一个具有 Main 方法的类。
4. 发布项目并将其打包成ZIP文件。
5. 在Apache OpenWhisk中更新或创建动作。

例如，示例项目Apache OpenWhisk Example Dotnet创建了一个名为Hello.cs的类，其中包含一个Main方法，用于处理输入并返回结果。

using System;
using Newtonsoft.Json.Linq;

namespace Apache.OpenWhisk.Example.Dotnet
{
    public class Hello
    {
        public JObject Main(JObject args)
        {
            // ...
        }
    }
}

发布此项目作为OpenWhisk动作，可以使用 dotnet publish 和 zip 命令。

3. 项目的配置文件介绍

尽管该项目不涉及传统的配置文件，但有一些关键文件影响着构建和部署过程：

• build.gradle: 主构建脚本，用于编译、测试和打包.NET Core项目。
• travis.yml: Travis CI配置，定义了如何自动构建和测试项目。
• .gitignore: 指定哪些文件不应该被Git版本控制。
• gradlew, gradlew.bat: Gradle Wrapper，帮助在不同操作系统上运行Gradle命令。
• settings.gradle: 控制Gradle构建范围和模块设置。

如果你想要自定义构建流程或集成到其他CI系统，这些文件是需要修改的地方。

以上即为对Apache OpenWhisk .NET运行时库的基本介绍。通过理解项目目录结构、启动文件和配置文件，您可以更好地利用它来开发和部署.NET Core函数到OpenWhisk平台。

openwhisk-runtime-dotnetApache OpenWhisk Runtime .Net supports Apache OpenWhisk functions written in .Net languages项目地址:https://gitcode.com/gh_mirrors/op/openwhisk-runtime-dotnet