IT Core Actions

Core IT GitHub Actions and Workflows

Workflows

Build .NET

This workflow is used to build and test .NET Core/5/6 projects with the dotnet CLI.

Usage

jobs:
  build:
    uses: vermeer-corp/it-core-actions/.github/workflows/build-dotnet.yml@v5
    with:
      publish-project: <ProjectToPublish>.csproj
      publish-path: <ProjectToPublish>/bin/Debug/net6.0/publish/*
      build-configuration: Debug
      dotnet-version: 6.0.x
      upload-artifact: true
      upload-artifact-name: artifact-name
    secrets:
      github-token: ${{ secrets.GITHUB_TOKEN}}

Parameters

publish-project

The path to the csproj file within the solution containing the final project to publish.

publish-path

The path to the final build outputs to be published.

build-configuration

The build configuration to use when building the project.

dotnet-version

The version of the dotnet SDK to use when building the project.

upload-artifact

A boolean value indicating whether to upload the build artifact to GitHub.

upload-artifact-name

A name given for the artifact output for the build. Default is publish-package

github-token

The GitHub Actions token to use to authenticate to the Vermeer GitHub Packages NuGet repository. This should always be set to ${{ secrets.GITHUB_TOKEN}} in the calling workflow as shown above.

---

Build .NET Framework 4.x

This workflow is used to build and test .NET Framework 4.x projects with MSBuild.

Usage

jobs:
  build:
    uses: vermeer-corp/it-core-actions/.github/workflows/build-net-framework.yml@v5
    with:
      publish-project: <ProjectToPublish>.csproj
      publish-path: <ProjectToPublish>/bin/Debug/net6.0/publish/*
      build-configuration: Debug
      msbuild-args: /t:Package /t:TransformWebConfig /p:ExcludeXmlAssemblyFiles=false /p:AutoParameterizationWebConfigConnectionStrings=False
      test-file-glob: "**/*.Test.dll"
      upload-artifact: true
      upload-artifact-name: artifact-name
    secrets:
      github-token: ${{ secrets.GITHUB_TOKEN}}

Parameters

publish-project

The path to the csproj file within the solution containing the final project to publish.

publish-path

The path to the final build outputs to be published.

build-configuration

The build configuration to use when building the project.

msbuild-args

Any additional command line arguments to pass to MSBuild. If you are converting a Bamboo build process, see the MSBuild task in the Bamboo build for what these arguments might be. /p:Configuration=\<Build Configuration\> is already set with the build-configuration parameter.

test-file-glob

A glob pattern to match compiled MSTest DLL assemblies to run unit tests. If the parameter is empty, no unit tests will be run.

upload-artifact

A boolean value indicating whether to upload the build artifact to GitHub.

upload-artifact-name

A name given for the artifact output for the build. Default is publish-package

github-token

The GitHub Actions token to use to authenticate to the Vermeer GitHub Packages NuGet repository. This should always be set to ${{ secrets.GITHUB_TOKEN}} in the calling workflow as shown above.

---

Refresh Axway

This workflow is used to refresh an API definition in Axway. This workflow uses the vermeer-corp/it-axway-automation@v1 action.

Usage

refresh-axway:
  uses: vermeer-corp/it-core-actions/.github/workflows/refresh-axway.yml@v5
  with:
    deploy-environment: development
    axway-frontend-path: /<api-name>
    swagger-url: https://devapi.vermeer.com/<api-name>/swagger/v1/swagger.json
  secrets:
    axway-host: ${{ secrets.AXWAY_DEV_HOST }}
    axway-username: ${{ secrets.AXWAY_DEV_USERNAME }}
    axway-password: ${{ secrets.AXWAY_DEV_PASSWORD }}

---

Dotnet NuGet CI/CD

This workflow is used to build, test, and publish all NuGet packages in a .NET Core/5/6 project using the dotnet CLI.

Usage

nuget:
  uses: vermeer-corp/it-core-actions/.github/workflows/dotnet-nuget-ci-cd.yml@v5
  with:
    dotnet-version: 6.0.x
    publish-package: true
  secrets:
    github-token: ${{ secrets.GITHUB_TOKEN }}

---

.NET Framework NuGet CI/CD

This workflow is used to build, test, and publish NuGet packages in a .NET Framework 4.x project using MSBuild and the NuGet CLI.

Usage

nuget:
  uses: vermeer-corp/it-core-actions/.github/workflows/net-framework-nuget-ci-cd.yml@v5
  with:
    build-project: <PublishProject>.csproj
    nuget-project: <PublishProject>.nuspec or <PublishProject>.csproj
    build-configuration: Release
    msbuild-args: ""
    publish-package: true
  secrets:
    github-token: ${{ secrets.GITHUB_TOKEN }}

Parameters

build-project

The path to the csproj file within the solution containing the project to build and publish.

publish-path

The path to either the same .csproj file as in build-project or a .nuspec configuration for the project.

build-configuration

The build configuration to use when building the project.

msbuild-args

Any additional command line arguments to pass to MSBuild. If you are converting a Bamboo build process, see the MSBuild task in the Bamboo build for what these arguments might be. /p:Configuration=\<Build Configuration\> is already set with the build-configuration parameter.

test-file-glob

A glob pattern to match compiled MSTest DLL assemblies to run unit tests. If the parameter is empty, no unit tests will be run.

upload-artifact

A boolean value indicating whether to upload the NuGet package to GitHub Packages.

github-token

The GitHub Actions token to use to authenticate to the Vermeer GitHub Packages NuGet repository. This should always be set to ${{ secrets.GITHUB_TOKEN}} in the calling workflow as shown above.