Post
Ask Question

Automate Build, Publish And Deploy NuGet Package Using Github Actions

In the modern era of DevOps, automation has become more popular, whereas creating/uploading packages has become a thing of the past. Moreover, day by day the packages count is increasing in a developer’s life. So, it is not easy to build, publish, and deploy all the packages manually on NuGet.org. We can manage a few packages (1-2) manually but, if we need to manage more packages (5,10 and so on), then it will become a tedious job.
 
Using GitHub's actions, we can make this process fully automatic.
 
Here is the step by step guide to automate, build, publish, and deploy (release) package to NuGet.
 
Step 1
 
Create a new repository on GitHub and upload your code.
 
Step 2
 
Create a GitHub Action, which makes it easy to build and publish. When we are creating a workflow, it creates a .yaml file. In this example, I am creating a workflow for .net core (c#).
 
Automate Build, Publish And Deploy NuGet Package Using Github Actions
 
Step 3
 
The previous step creates the workflow for .NET Core environment. It has a predefined structure which is a nice starting point for building and testing. It has the below sample code.
  1. name: .NET Core  
  2.   
  3. on:  
  4.   push:  
  5.     branches: [ master ]  
  6.   pull_request:  
  7.     branches: [ master ]  
  8.   
  9. jobs:  
  10.   build:  
  11.   
  12.     runs-on: ubuntu-latest  
  13.   
  14.     steps:  
  15.     - uses: actions/checkout@v2  
  16.     - name: Setup .NET Core  
  17.       uses: actions/setup-dotnet@v1  
  18.       with:  
  19.         dotnet-version: 3.1.101  
  20.     - name: Install dependencies  
  21.       run: dotnet restore  
  22.     - name: Build  
  23.       run: dotnet build --configuration Release --no-restore  
  24.     - name: Test  
  25.       run: dotnet test --no-restore --verbosity normal  
Automate Build, Publish And Deploy NuGet Package Using Github Actions
 
Step 4
 
The above default code is enough to build and test the code. But we have a requirement to publish the package at NuGet.org. For this, we need to add a publish step in .yaml file.
 
Note
I have added the working directory tag as I have multiple projects in the same solution.
  1. - name: Publish  
  2.   uses: brandedoutcast/[email protected]  
  3.   with:   
  4.    PROJECT_FILE_PATH: Extensions/Extensions.csproj  
  5.    NUGET_KEY: ${{secrets.NUGET_API_KEY}}  
Automate Build, Publish And Deploy NuGet Package Using Github Actions
 
brandedoutcast has created a reusable GitHub Action to publish NuGet packages. This action looks for changes to the <version>{}</version> tag in the .csproj file.
 
While deploying on NuGet.org we need an API key to validate this. For this, we are using the variable.
 
Step 5
 
Create the API key from NuGet.org and then add this under the Settings>Secrets in GitHub repository. Create a variable name “NUGET_API_KEY”.
 
Automate Build, Publish And Deploy NuGet Package Using Github Actions
 
Step 6
 
Save your .yaml file and start the action. You will see that the solution will be built and published on NuGet.org.
 
Automate Build, Publish And Deploy NuGet Package Using Github Actions
 
Automate Build, Publish And Deploy NuGet Package Using Github Actions
 
Step 7
 
Package on NuGet.org.
 
Automate Build, Publish And Deploy NuGet Package Using Github Actions
 

Summary

 
Whenever we are updating the package and pushing the code in the master branch then the GitHub action will initiate automatically and push the package to NuGet.org. Now, we don’t need to manage our packages manually and no need to worry about the number of packages.
 
Try this and enjoy it!


Similar Articles