mirror of
https://github.com/woodpecker-ci/woodpecker.git
synced 2025-02-25 07:36:20 +00:00
bdf753f678
Co-authored-by: qwerty287 <80460567+qwerty287@users.noreply.github.com> Co-authored-by: qwerty287 <qwerty287@posteo.de> Co-authored-by: Robert Kaussow <mail@thegeeklab.de> Co-authored-by: Anbraten <anton@ju60.de> Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com> Co-authored-by: Anbraten <6918444+anbraten@users.noreply.github.com>
62 lines
1.2 KiB
Markdown
62 lines
1.2 KiB
Markdown
# Linter
|
|
|
|
Woodpecker automatically lints your workflow files for errors, deprecations and bad habits. Errors and warnings are shown in the UI for any pipelines.
|
|
|
|
|
|
|
|
## Running the linter from CLI
|
|
|
|
You can run the linter also manually from the CLI:
|
|
|
|
```shell
|
|
woodpecker-cli lint <workflow files>
|
|
```
|
|
|
|
## Bad habit warnings
|
|
|
|
Woodpecker warns you if your configuration contains some bad habits.
|
|
|
|
### Event filter for all steps
|
|
|
|
All your items in `when` blocks should have an `event` filter, so no step runs on all events. This is recommended because if new events are added, your steps probably shouldn't run on those as well.
|
|
|
|
Examples of an **incorrect** config for this rule:
|
|
|
|
```yaml
|
|
when:
|
|
- branch: main
|
|
- event: tag
|
|
```
|
|
|
|
This will trigger the warning because the first item (`branch: main`) does not filter with an event.
|
|
|
|
```yaml
|
|
steps:
|
|
- name: test
|
|
when:
|
|
branch: main
|
|
|
|
- name: deploy
|
|
when:
|
|
event: tag
|
|
```
|
|
|
|
Examples of a **correct** config for this rule:
|
|
|
|
```yaml
|
|
when:
|
|
- branch: main
|
|
event: push
|
|
- event: tag
|
|
```
|
|
|
|
```yaml
|
|
steps:
|
|
- name: test
|
|
when:
|
|
event: [tag, push]
|
|
|
|
- name: deploy
|
|
when:
|
|
- event: tag
|
|
```
|