Catesta - GitHub Actions Integration¶
Synopsis¶
Scaffolds a new PowerShell module or vault project intended for CI/CD workflow using GitHub Actions.
Getting Started¶
Note: It is important to have a clear understanding of what your project should support before starting with Catesta. If your goal is to create a cross-platform solution or test multiple versions of PowerShell, consider running multiple build types to ensure proper functioning on various platforms and environments.
GitHub Actions Supported Builds:
- You will need a GitHub account.
- Create a new repository and clone to your local dev device
- Create your project using Catesta and select
[G] GitHub Actions
at the CICD prompt. (Catesta Basics) - Write the logic for your module (the hardest part)
- All build testing can be done locally by navigating to
src
and runningInvoke-Build
- By default, this runs all tasks in the build file.
- If you want to run a specific task from the build file you can provide the task name. For example, to just execute Pester tests for your project:
Invoke-Build -Task Test
- If you want to run a specific task from the build file you can provide the task name. For example, to just execute Pester tests for your project:
- By default, this runs all tasks in the build file.
- If using VSCode as your primary editor you can use VSCode tasks to perform various local actions
- Open the VSCode Command palette
- Shift+Command+P (Mac) / Ctrl+Shift+P (Windows/Linux) or F1
- Type
Tasks: Run Task
- Select the task to run
- Examples:
task .
- Runs complete build (all tasks)task Test
- Invokes all Pester Unit Teststask Analyze
- Invokes Script Analyzer checkstask DevCC
- Generates generate xml file to graphically display code coverage in VSCode using Coverage Gutters
- Examples:
- Open the VSCode Command palette
- All build testing can be done locally by navigating to
- Add any module dependencies to your CI/CD bootstrap file:
actions_bootstrap.ps1
- Upload to your GitHub repository which now has a triggered/monitored build action.
- Evaluate results of your build and display your GitHub Actions badge proudly!
Test Reports¶
GitHub Actions does not natively support Test reports. There are many Test Report solutions in the Actions Marketplace that can accomplish this however.
By default, the build file will create a XML test report in NUnitXml
but these can also be changed to JUnitXml
if you are using a Test Report in Actions that prefers that format.
Notes¶
Additional Reading:
- Automating your workflow with GitHub Actions
- Virtual environments for GitHub-hosted runners
- Software installed on GitHub-hosted runners
- Using a specific shell
- Workflow syntax for GitHub Actions
- Where does the upload go?
- Building and testing PowerShell