.NetCore

.NetCore 语言类型识别策略

代码主目录中包含以.sln或者.csproj结尾的文件并且不包含Dockerfile文件时，平台识别项目语言类型为.NetCore

目前仅支持单项目代码维护形式，如果你一个代码仓库维护了多个 Project, 例如一个微服务架构，那么首先建议你将每个 Project 分离到不同仓库或同个仓库不同二级目录下。

代码规范

源码主目录必须具有 Procfile 文件定义服务启动方式，详见 项目运行 部分

编译原理

对于.NetCore 语言的支持与 Dockerfile 一样将构建出镜像而不是 slug 程序包，因此.NetCore 不能使用 Procfile 文件定义。

NetCore 语言构建过程默认使用microsoft/dotnet:2.2-sdk-alpine 编译镜像和microsoft/dotnet:2.2-aspnetcore-runtime运行环境镜像，若设置其他版本同理。若你未提前下载镜像在构建过程容易出现拉取镜像失败的错误。强烈建议先在 Rainbond 管理节点提前手动获取上述镜像。

如果你的源码对系统环境有依赖，需要单独安装系统类库，目前无法直接使用 Rainbond 提供的默认编译环境编译，你可以采用直接定义 Dockerfile 的方式支持。

编译环境选择

当前版本平台默认使用 microsoft/dotnet:2.2-sdk-alpine 镜像环境进行源码编译。你可以根据需要设置编译环境版本，可选版本目前还包括包括：

  • 3.0-sdk
  • 2.1-sdk

设置服务环境变量 BUILD_DOTNET_SDK_VERSION=3.0-sdk 即可选择构建环境版本。

编译方式设置

默认编译方式如下：

  1. dotnet restore
  2. dotnet publish -c Release

若需要在dotnet restore之前执行的命令可以通过 BUILD_DOTNET_RESTORE_PRE环境变量指定。

若需要改变默认的 dotnet restore命令可以通过BUILD_DOTNET_RESTORE 环境变量指定。比如设置如下环境变量：

  1. BUILD_DOTNET_RESTORE_PRE=dotnet restore --ignore-failed-sources

关于环境变量的设置参考 服务环境变量

项目运行

运行环境选择

通常情况下运行环境与编译环境版本一致，当前版本默认提供的运行环境是microsoft/dotnet:2.2-aspnetcore-runtime，可选的运行环境版本为：

  • 3.0-aspnetcore-runtime

  • 2.1-aspnetcore-runtime

通过设置环境变量BUILD_DOTNET_RUNTIME_VERSION 设置你需要的版本

编译的结果文件存放于运行环境的/app目录下。由于平台咱无法很好的感知项目的入口运行文件，需要在源码主目录中定义 rainbondfile 定义项目的运行启动方式，例如：

  1. ports:
  2.    - port: 5000
  3.      procotol: http
  4. cmd: dotnet aspnetapp.dll

ports定义项目监听的端口（必须监听泛地址 *或者0.0.0.0）

cmd定义项目启动方式，根据项目 publish 后生成的入口运行文件为准。

如何适应 rainbondfile 中设置的端口

通常情况下，程序开发者并没有添加自定义程序监听端口的逻辑。这种情况下，程序启动时会监听默认地址 http://[::]:80 那么如何让自己的程序可以自定义监听端口，并使之动态匹配 rainbondfile 中设置好的 port 呢？ 下面是一个具体的方案：

修改项目的 Program.cs

  1. using System;
  2. using System.Collections.Generic;
  3. using System.IO;
  4. using System.Linq;
  5. using System.Threading.Tasks;
  6. using Microsoft.AspNetCore;
  7. using Microsoft.AspNetCore.Hosting;
  8. using Microsoft.Extensions.Configuration;
  9. using Microsoft.Extensions.Logging;
  11. namespace aspnetapp {
  12.     public class Program {
  13.         public static void Main (string[] args) {
  14.             // 由环境变量 ${PORT} 定义启动端口
  15.             string port = "5000";
  16.             if (Environment.GetEnvironmentVariable("PORT") != null) {
  17.                 port = Environment.GetEnvironmentVariable("PORT");
  18.             }
  19.             Console.WriteLine("Listing :{0}", port);
  20.             CreateWebHostBuilder (port, args).Build ().Run();
  21.         }
  22.         public static IWebHostBuilder CreateWebHostBuilder (string port, string[] args) =>
  23.             WebHost.CreateDefaultBuilder (args)
  24.             // 定义访问路径
  25.             .UseUrls ($"http://0.0.0.0:{port}")
  26.             .UseStartup<Startup> ();
  27.     }
  28. }

示例代码

https://github.com/goodrain/dotnet-demo