mirror of
https://github.com/woodpecker-ci/woodpecker.git
synced 2024-09-22 03:30:06 +00:00
34 lines
1.2 KiB
Markdown
34 lines
1.2 KiB
Markdown
# Cron
|
|
|
|
To configure cron jobs you need at least push access to the repository.
|
|
|
|
## Add a new cron job
|
|
|
|
1. To create a new cron job adjust your pipeline config(s) and add the event filter to all steps you would like to run by the cron job:
|
|
|
|
```diff
|
|
steps:
|
|
- name: sync_locales
|
|
image: weblate_sync
|
|
settings:
|
|
url: example.com
|
|
token:
|
|
from_secret: weblate_token
|
|
+ when:
|
|
+ event: cron
|
|
+ cron: "name of the cron job" # if you only want to execute this step by a specific cron job
|
|
```
|
|
|
|
2. Create a new cron job in the repository settings:
|
|
|
|
|
|
|
|
The supported schedule syntax can be found at <https://pkg.go.dev/github.com/robfig/cron?utm_source=godoc#hdr-CRON_Expression_Format>. If you need general understanding of the cron syntax <https://it-tools.tech/crontab-generator> is a good place to start and experiment.
|
|
|
|
Examples: `@every 5m`, `@daily`, `0 30 * * * *` ...
|
|
|
|
:::info
|
|
Woodpeckers cron syntax starts with seconds instead of minutes as used by most linux cron schedulers.
|
|
|
|
Example: "At minute 30 every hour" would be `0 30 * * * *` instead of `30 * * * *`
|
|
:::
|