Manage tools

The official CLI .NET Core GlobalTool for building, deploy releases, create and push packages, and manage environments for projects based on VirtoCommerce. Is powered by nuke.build A cross-platform build automation system with C# DSL.

Publish a new version

Incerment package version in _build.csproj

dotnet pack .\vc-platform\build\_build.csproj  --configuration Release --include-symbols --output .\vc-platform\artifacts /property:SymbolPackageFormat=snupkg

dotnet nuget push VirtoCommerce.GlobalTool.{version}.nupkg  -s https://api.nuget.org/v3/index.json -k {api key}

Installation

Installing VirtoCommerce.GlobalTool package:

dotnet tool install VirtoCommerce.GlobalTool  -g

Latest version

Run this command to update VirtoCommerce.GlobalTool to the latest version:

dotnet tool update VirtoCommerce.GlobalTool -g

Usage

To use VirtoCommerce.GlobalTool by invoke the tool using the following command: vc-build

To get the all list of targets:

vc-build help

Command output

NUKE Execution Engine version 0.24.11 (Windows,.NETCoreApp,Version=v2.1)

Target with name 'help' does not exist. Available targets are:
  - ChangeVersion
  - Clean
  - Compile
  - CompleteHotfix
  - CompleteRelease
  - Compress
  - GetManifestGit
  - GrabMigrator
  - IncremenPatch
  - IncrementMinor
  - MassPullAndBuild
  - Pack
  - Publish
  - PublishManifestGit
  - PublishModuleManifest
  - PublishPackages
  - QuickRelease
  - Release
  - Restore
  - SonarQubeEnd
  - SonarQubeStart
  - StartAnalyzer
  - StartHotfix
  - StartRelease
  - SwaggerValidation
  - Test
  - UpdateManifest
  - ValidateSwaggerSchema
  - WebPackBuild

Compress

The target is used to create a redistributed zip archive for a module or platform. After executing, the resulting zip is placed in artifacts folder. To execute this target, you need to run this command in the root module folder of the cloned from GitHub repository.

vc-build compress

console output

═══════════════════════════════════════
Target             Status      Duration
───────────────────────────────────────
Clean              Executed        0:00
Restore            Executed        0:07
Compile            Executed        0:06
WebPackBuild       Executed        0:00
Test               Executed        0:05
Publish            Executed        0:01
Compress           Executed        0:01
───────────────────────────────────────
Total                              0:23
═══════════════════════════════════════

StartRelease, CompleteRelease, QuickRelease, StartHotfix, CompleteHotfix

Used to automate the routine operations with release branches

StartRelease:

• creates and pushes the new branch release/version from dev

CompleteRelease:

• merges release/version into master and pushes
• merges into dev branch, increments version's minor and pushes

QuickRelease:

• Triggers StartRelease and then CompleteRelease

StartHotfix:

• Increments version's patch in master
• Creates and pushes the new branch hotfix/version

CompleteHotfix:

• Merges hotfix branch into master
• Adds tag and pushes