heroku/buildpack-dotnet

Heroku .NET 云原生构建包

镜像概述

Heroku .NET 云原生构建包是Heroku官方提供的构建工具，基于Cloud Native Buildpacks规范，专为.NET应用程序设计。它简化了.NET项目的构建、打包和部署流程，无需手动配置复杂的构建环境，可直接与Heroku平台集成，快速将.NET应用部署至云环境。

核心功能和特性

• 自动项目检测：自动识别.NET项目结构（如.csproj、.sln文件），无需手动指定项目类型。
• 依赖管理：自动解析并安装.NET SDK、NuGet依赖及运行时环境。
• 构建优化：内置多阶段构建支持，分离构建环境与运行环境，减小最终镜像体积。
• 平台集成：深度适配Heroku平台，支持Procfile配置、环境变量注入及日志集成。
• 标准化输出：生成符合OCI规范的容器镜像，确保跨环境一致性。

使用场景和适用范围

• 适用项目：各类.NET应用，包括ASP.NET Core Web应用、Web API服务、控制台应用等。
• 用户群体：需要在Heroku平台部署.NET应用的开发团队或个人开发者。
• 场景示例：快速迭代的.NET Web项目、需要自动化构建流程的CI/CD管道、简化部署步骤的小型应用。

使用方法和配置说明

前置条件

• 安装Heroku CLI并登录账号。
• 本地项目为.NET Core 3.1+或.NET 5+版本，包含有效项目文件（.csproj/.sln）。

基础使用步骤

1. 创建Heroku应用

   bash
   heroku create my-dotnet-app
   

2. 设置构建包
   Heroku会自动检测.NET项目并应用此构建包，若需手动指定：

   bash
   heroku buildpacks:set https://github.com/heroku/buildpacks-dotnet
   

3. 部署应用
   将代码推送到Heroku远程仓库触发构建：

   bash
   git push heroku main
   

高级配置

自定义构建命令

通过项目根目录的heroku-buildpack-dotnet.yml文件配置构建参数，例如指定SDK版本：

yaml
sdk:
  version: 7.0.400

运行时配置

通过Heroku环境变量设置.NET运行时参数，例如：

bash
heroku config:set ASPNETCORE_ENVIRONMENT=Production
heroku config:set DOTNET_CLI_TELEMETRY_OPTOUT=1

更多信息

完整文档及更新日志请参考官方仓库：
https://github.com/heroku/buildpacks-dotnet