whyellow/dotnet-build

Dotnet Core 2 Bitbucket Pipelines 构建镜像

镜像概述

本Docker镜像是基于微软官方microsoft/dotnet:2.1-sdk镜像构建的专用镜像，专为Bitbucket Pipelines环境设计，旨在为Dotnet Core 2.x版本的解决方案提供便捷的自动化构建能力。通过集成官方SDK环境与Bitbucket Pipelines兼容配置，实现Dotnet Core 2项目在CI/CD流程中的无缝构建。

核心功能与特性

• 官方SDK基础：基于microsoft/dotnet:2.1-sdk官方镜像，确保与Dotnet Core 2.x工具链的完全兼容性
• Bitbucket Pipelines适配：预配置适用于Bitbucket Pipelines的运行环境，无需额外调整即可集成到CI流程
• 完整构建支持：支持Dotnet Core 2项目的restore、build、test、publish等标准构建生命周期操作
• 轻量高效：保留SDK核心功能，确保镜像体积适中，适合CI/CD流程中的快速加载与执行

使用场景与适用范围

• 托管在Bitbucket的Dotnet Core 2.x项目的持续集成/持续部署（CI/CD）流程
• 需要在Bitbucket Pipelines中自动化执行Dotnet Core 2项目构建、测试步骤的开发团队
• 依赖Dotnet Core 2.1 SDK特定功能的项目构建环境需求

使用方法与配置说明

在Bitbucket Pipelines中使用

1. 配置bitbucket-pipelines.yml文件
   在Bitbucket仓库根目录创建或修改bitbucket-pipelines.yml，引用本镜像并定义构建步骤：

   yaml
   pipelines:
     default:
       - step:
           name: 构建Dotnet Core 2解决方案
           image: [镜像名称]  # 替换为实际镜像名称或路径
           script:
             - dotnet restore  # 还原项目依赖
             - dotnet build --configuration Release  # 发布模式构建解决方案
             - dotnet test --configuration Release  # （可选）运行单元测试
   

2. 参数说明
   本镜像无需额外环境变量配置，直接使用Dotnet CLI标准命令即可完成构建流程。常用命令包括：

   • dotnet restore：还原项目依赖包
   • dotnet build：构建项目，可指定--configuration（Debug/Release）等参数
   • dotnet test：运行测试项目
   • dotnet publish：（可选）发布构建产物

本地测试（可选）

若需本地验证镜像功能，可通过以下命令运行容器并执行构建：

bash
docker run -v $(pwd):/app -w /app [镜像名称] dotnet build /app/YourProject.csproj --configuration Release

其中：

• -v $(pwd):/app：将本地项目目录挂载到容器内/app路径
• -w /app：设置工作目录为/app
• [镜像名称]：替换为实际镜像名称或路径
• dotnet build ...：执行构建命令，指定项目文件路径和配置

注意事项

• 本镜像仅支持Dotnet Core 2.x版本项目，不兼容Dotnet Core 3.0及以上版本
• 确保Bitbucket Pipelines运行环境满足基础Docker镜像拉取条件（网络通畅等）
• 构建大型解决方案时，建议在script中添加适当的依赖缓存步骤（如缓存nuget包）以提升构建效率