yamllint/README.md

GitHub YAMLlint

This action executes yamllint (https://github.com/adrienverge/yamllint) against file(s) or folder

Usage

Simple as:

- uses: ibiqlik/action-yamllint@v2

Optional parameters

• config_file - Path to custom configuration
• config_data - Custom configuration (as YAML source)
• file_or_dir - Enter file/folder (space separated), wildcards accepted. Examples:
  • . - run against all yaml files in a directory recursively (default)
  • file1.yaml
  • file1.yaml file2.yaml
  • kustomize/**/*.yaml mychart/*values.yaml
• format - Format for parsing output [parsable,standard,colored,github,auto] (default: github)
• strict - Return non-zero exit code on warnings as well as errors [true,false] (default: false)

Example usage in workflow

name: Yaml Lint
on: [push]
jobs:
  lintAllTheThings:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v1
    - name: yaml-lint
      uses: ibiqlik/action-yamllint@v2
      with:
        file_or_dir: myfolder/*values*.yaml
        config_file: .yamllint.yml

Or just simply check all yaml files in the repository:

name: Yaml Lint
on: [push]
jobs:
  lintAllTheThings:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v1
    - name: yaml-lint
      uses: ibiqlik/action-yamllint@v2

Note: Action will use .yamllint as configuration file automatically if it is available in root.

Config data examples:

# Single line
config_data: "{extends: default, rules: {new-line-at-end-of-file: disable}}"

# Multi line
config_data: |
  extends: default
  rules:
    new-line-at-end-of-file:
      level: warning
    trailing-spaces:
      level: warning