GitHub Action
PSScriptAnalyzer checks
GitHub Action to run PSScriptAnalyzer static code analysis checks on PowerShell for Pull Requests.
By default, this action will succeed if zero PSScriptAnalyzer errors and warnings are found. Failing on errors, warnings, or informational issues can be configured. See Usage below. The sending of comments back to the PR if the action fails can be disabled if desired.
Basic configuration that will run PSSA and fail on errors or warnings, and send a comment back to the PR with a summary.
Note, that repoToken is required for sending comments back.
name: CI
on: [pull_request]
jobs:
lint:
name: Run PSSA
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- name: lint
uses: devblackops/github-action-psscriptanalyzer@master
with:
repoToken: ${{ secrets.GITHUB_TOKEN }}Advanced configuration that will run PSSA only in the MyModule directory, with custom PSSA settings, and fail on errors, warnings, or informational issues.
A comment back to the PR with the PSSA summary will also be sent if any issues were detected.
name: CI
on: [pull_request]
jobs:
lint:
name: Run PSSA
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- name: lint
uses: devblackops/github-action-psscriptanalyzer@master
with:
rootPath: MyModule
settingsPath: pssa_settings.psd1
sendComment: true
repoToken: ${{ secrets.GITHUB_TOKEN }}
failOnErrors: true
failOnWarnings: true
failOnInfos: trueUse the Docker Hub version of the Action instead of building the container during the check.
name: CI
on: [pull_request]
jobs:
lint:
name: Run PSSA
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- name: lint
uses: docker://devblackops/github-action-psscriptanalyzer:2.2.0
with:
repoToken: ${{ secrets.GITHUB_TOKEN }}| Name | Default | Description |
|---|---|---|
| rootPath | <none> | The root directory to run PSScriptAnalyzer on. By default, this is the root of the repository. |
| settingsPath | <none> | The path to a PSScriptAnalyser settings file to control rules to execute. |
| sendComment | true | Enable/disable sending comments with PSScriptAnalyzer results back to PR. |
| repoToken | <none> | GitHub token the action will use to send comments back to PR with. Use ${{ secrets.GITHUB_TOKEN }}. |
| failOnErrors | true | Enable/disable failing the action on PSScriptAnalyzer error items. |
| failOnWarnings | true | Enable/disable failing the action on PSScriptAnalyzer warning items. |
| failOnInfos | false | Enable/disable failing the action on PSScriptAnalyzer informational items. |
