Pack ImageBuilder as dotnet tool

eng/Versions.props

@@ -5,7 +5,7 @@
   <PropertyGroup>
     <!-- Follow https://semver.org/spec/v2.0.0.html -->
     <MajorVersion>0</MajorVersion>
-    <MinorVersion>2</MinorVersion>
+    <MinorVersion>3</MinorVersion>
     <PatchVersion>0</PatchVersion>
     <VersionPrefix>$(MajorVersion).$(MinorVersion).$(PatchVersion)</VersionPrefix>
     <PreReleaseVersionLabel>beta</PreReleaseVersionLabel>

eng/docker-tools/CHANGELOG.md

@@ -4,6 +4,22 @@ All breaking changes and new features in `eng/docker-tools` will be documented i
 
 ---
 
+## 2026-03-06: ImageBuilder is now packaged as a .NET tool
+
+ImageBuilder is now packaged as a .NET tool.
+The ImageBuilder executable has been renamed from `Microsoft.DotNet.ImageBuilder` to `imagebuilder`.
+
+**Changes:**
+- ImageBuilder is now packaged as a .NET tool.
+- The executable/assembly name has been changed from `Microsoft.DotNet.ImageBuilder` to `imagebuilder`
+- The Windows staging folder name has been changed from `.Microsoft.DotNet.ImageBuilder` to `.imagebuilder`
+- The ImageBuilder version has been updated to `0.3.0`.
+
+**Impact:**
+- Any custom scripts referencing `Microsoft.DotNet.ImageBuilder.exe` or the `.Microsoft.DotNet.ImageBuilder/` folder must be updated to reference `imagebuilder.exe` and `.imagebuilder/` respectively.
+
+---
+
 ## 2026-03-04: Pre-build validation gated by `preBuildTestScriptPath` variable
 
 The `PreBuildValidation` job condition now checks the new `preBuildTestScriptPath` variable instead of `testScriptPath`.

eng/pipelines/docker-tools-packages-official.yml

@@ -17,6 +17,7 @@ trigger:
     include:
     - eng/common/*
     - eng/pipelines/*
+    - src/ImageBuilder/*
     - src/ImageBuilder.Models/*
     - Directory.Build.props
     - Directory.Build.targets

eng/pipelines/docker-tools-packages-pr.yml

@@ -16,6 +16,7 @@ pr:
     include:
     - eng/common/*
     - eng/pipelines/*
+    - src/ImageBuilder/*
     - src/ImageBuilder.Models/*
     - Directory.Build.props
     - Directory.Build.targets

src/Dockerfile.linux

@@ -50,4 +50,4 @@ COPY ["notation-trust/policies/", "/notation-trust/policies/"]
 WORKDIR /image-builder
 COPY --from=build-env /image-builder/out ./
 
-ENTRYPOINT ["/image-builder/Microsoft.DotNet.ImageBuilder"]
+ENTRYPOINT ["/image-builder/imagebuilder"]

src/Dockerfile.windows

@@ -26,4 +26,4 @@ FROM mcr.microsoft.com/windows/$WINDOWS_BASE
 WORKDIR /image-builder
 COPY --from=build-env /image-builder/out ./
 
-ENTRYPOINT ["/image-builder/Microsoft.DotNet.ImageBuilder"]
+ENTRYPOINT ["/image-builder/imagebuilder"]

src/ImageBuilder/Microsoft.DotNet.ImageBuilder.csproj

@@ -2,6 +2,7 @@
 
   <PropertyGroup>
     <OutputType>Exe</OutputType>
+    <AssemblyName>imagebuilder</AssemblyName>
     <PublishTrimmed>False</PublishTrimmed>
     <TargetFramework>net9.0</TargetFramework>
     <RootNamespace>Microsoft.DotNet.ImageBuilder</RootNamespace>
@@ -12,6 +13,14 @@
     <Nullable>enable</Nullable>
   </PropertyGroup>
 
+  <PropertyGroup Label="Tool Packaging">
+    <IsPackable>true</IsPackable>
+    <PackAsTool>true</PackAsTool>
+    <ToolCommandName>imagebuilder</ToolCommandName>
+    <PackageId>Microsoft.DotNet.ImageBuilder</PackageId>
+    <Description>CLI tool that orchestrates Docker image builds.</Description>
+  </PropertyGroup>
+
   <PropertyGroup>
     <!-- The "Cottle" templating package does not have a strong name. -->
     <SignAssembly>false</SignAssembly>