GitHub - devblackops/github-action-psscriptanalyzer: GitHub Action to run PSScriptAnalyzer static code analysis · GitHub

Use this GitHub action with your project

Add this Action to an existing workflow or create a new one

master

Branches Tags

Go to file

Code

NameName

Last commit message

Last commit date

Latest commit History 79 Commits
.github		.github
media		media
.gitattributes		.gitattributes
CHANGELOG.md		CHANGELOG.md
Dockerfile		Dockerfile
LICENSE		LICENSE
README.md		README.md
action.yml		action.yml
build.ps1		build.ps1
entrypoint.ps1		entrypoint.ps1
psakeFile.ps1		psakeFile.ps1
View all files

Repository files navigation

More items

github-action-psscriptanalyzer

GitHub Action to run PSScriptAnalyzer static code analysis checks on PowerShell for Pull Requests.

Success Criteria

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.

Usage

Basic

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

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: true

Docker

Use 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.3.0
      with:
        repoToken: ${{ secrets.GITHUB_TOKEN }}

Inputs

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.