NuGet packages

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/harness/harness-cli/llms.txt

Use this file to discover all available pages before exploring further.

​

Overview

• NuGet V3 protocol support
• .nupkg package format
• Version management
• Nested directory support for package uploads
• Integration with dotnet CLI and NuGet client

​

Pushing NuGet packages

hc artifact push nuget <registry-name> <nupkg-file-path> \
  --pkg-url <pkg-url>

​

Optional flags

​

Building NuGet packages

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net6.0</TargetFramework>
    <PackageId>MyCompany.MyLibrary</PackageId>
    <Version>1.0.0</Version>
    <Authors>Your Name</Authors>
    <Description>My awesome library</Description>
  </PropertyGroup>
</Project>

dotnet pack -c Release

hc artifact push nuget my-registry ./bin/Release/MyLibrary.1.0.0.nupkg \
  --pkg-url https://app.harness.io/registry/pkg

​

Installing NuGet packages

​

Add package source

dotnet nuget add source https://<registry-url>/v3/index.json \
  --name Harness \
  --username <username> \
  --password <harness-api-token> \
  --store-password-in-clear-text

​

Install packages

# Install a package
dotnet add package MyCompany.MyLibrary

# Install specific version
dotnet add package MyCompany.MyLibrary --version 1.0.0

​

Examples

# Build and push a NuGet package
dotnet pack -c Release
hc artifact push nuget my-registry ./bin/Release/MyLib.1.0.0.nupkg \
  --pkg-url https://app.harness.io/registry/pkg

​

NuGet.config configuration

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <clear />
    <add key="Harness" value="https://<registry-url>/v3/index.json" />
    <add key="nuget.org" value="https://api.nuget.org/v3/index.json" protocolVersion="3" />
  </packageSources>
  
  <packageSourceCredentials>
    <Harness>
      <add key="Username" value="your-username" />
      <add key="ClearTextPassword" value="your-harness-token" />
    </Harness>
  </packageSourceCredentials>
</configuration>

​

CI/CD integration

- name: Build and publish
  run: |
    dotnet pack -c Release
    hc artifact push nuget my-registry ./bin/Release/*.nupkg \
      --pkg-url https://app.harness.io/registry/pkg
  env:
    HARNESS_API_KEY: ${{ secrets.HARNESS_API_KEY }}

- task: DotNetCoreCLI@2
  inputs:
    command: 'pack'
    configuration: 'Release'

- script: |
    hc artifact push nuget my-registry $(Build.ArtifactStagingDirectory)/*.nupkg \
      --pkg-url $(PKG_URL)
  env:
    HARNESS_API_KEY: $(HARNESS_TOKEN)

​

Package versioning

• Release: 1.0.0
• Pre-release: 1.0.0-alpha, 1.0.0-beta.1
• Build metadata: 1.0.0+20231201

<PropertyGroup>
  <Version>1.0.0</Version>
  <!-- Or use MSBuild properties -->
  <Version>$(GitVersion)</Version>
</PropertyGroup>

​

Troubleshooting

# List configured sources
dotnet nuget list source

# Update credentials
dotnet nuget update source Harness \
  --username <username> \
  --password <new-token> \
  --store-password-in-clear-text

hc artifact list --registry my-registry --format json

# Increment version
dotnet pack -c Release -p:Version=1.0.1

​

See also

• Artifact push command
• Artifact management guide
• NuGet documentation