homelab/kener
1
0
Fork 0
mirror of https://github.com/rajnandan1/kener.git synced 2026-08-07 07:14:56 +00:00
Code Issues Packages Projects Releases Wiki Activity

added docs case for ordinal byday (first weekday of month)

Browse Source
This commit is contained in:
Benjamin Thiele
2026-08-02 10:52:21 +02:00
parent ee95642adb
commit 4394ca3668
1 changed files with 30 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files
src/routes/(docs)/docs/content/v4/maintenances/rrule-patterns.md
+30 -4
View File
@@ -240,6 +240,29 @@ Occurrences:
- Continues monthly... - Continues monthly...
``` ```
#### First Weekday of Month (Ordinal BYDAY) {#first-weekday-of-month}
**RRULE:** `FREQ=MONTHLY;BYDAY=1WE`
**Description:** Maintenance occurs on the first Wednesday of each month
**Use Case:** Monthly patch windows tied to a specific weekday
**Example:**
```
Title: Monthly Patch Window
Start: June 3, 2026 at 2:30 PM
RRULE: FREQ=MONTHLY;BYDAY=1WE
Duration: 90 minutes
Occurrences:
- Jun 3, 2026 at 2:30 PM
- Jul 1, 2026 at 2:30 PM
- Aug 5, 2026 at 2:30 PM
- Continues monthly...
```
#### Middle of Month {#middle-of-month} #### Middle of Month {#middle-of-month}
**RRULE:** `FREQ=MONTHLY;BYMONTHDAY=15` **RRULE:** `FREQ=MONTHLY;BYMONTHDAY=15`
@@ -362,15 +385,16 @@ Affected Monitors:
Title: Monthly Security Updates Title: Monthly Security Updates
Description: Critical security patches and system updates Description: Critical security patches and system updates
Start Date: Sunday, June 4, 2026 at 2:00 AM Start Date: Sunday, June 4, 2026 at 2:00 AM
RRULE: FREQ=MONTHLY;BYMONTHDAY=1 RRULE: FREQ=MONTHLY;BYDAY=1SU
Duration: 3600 seconds (1 hour) Duration: 3600 seconds (1 hour)
Affected Monitors: Affected Monitors:
- All Servers: MAINTENANCE - All Servers: MAINTENANCE
``` ```
**Note:** Since RRULE doesn't support "first Sunday", use BYMONTHDAY=1 and choose first occurrence that falls on Sunday, or use BYDAY with ordinal (not supported in Kener UI currently). **Note:** Use ordinal weekday syntax in `BYDAY` for "first X weekday" patterns:
**Workaround:** Create as weekly and manage manually or use BYMONTHDAY for specific date. - First Sunday: `BYDAY=1SU`
- First Wednesday: `BYDAY=1WE`
### Example 4: Business Hours Backup {#example-backup} ### Example 4: Business Hours Backup {#example-backup}
@@ -469,6 +493,7 @@ Start: 2:00 AM UTC
✅ `FREQ=WEEKLY;BYDAY=MO,WE,FR` ✅ `FREQ=WEEKLY;BYDAY=MO,WE,FR`
✅ `FREQ=WEEKLY;INTERVAL=2;BYDAY=SU` ✅ `FREQ=WEEKLY;INTERVAL=2;BYDAY=SU`
✅ `FREQ=MONTHLY;BYMONTHDAY=1` ✅ `FREQ=MONTHLY;BYMONTHDAY=1`
✅ `FREQ=MONTHLY;BYDAY=1WE`
✅ `FREQ=MINUTELY;COUNT=1` ✅ `FREQ=MINUTELY;COUNT=1`
### Invalid RRULEs {#invalid-rrules} ### Invalid RRULEs {#invalid-rrules}
@@ -602,6 +627,7 @@ Description: |
| Every Sunday | `FREQ=WEEKLY;BYDAY=SU` | | Every Sunday | `FREQ=WEEKLY;BYDAY=SU` |
| Bi-weekly Mondays | `FREQ=WEEKLY;INTERVAL=2;BYDAY=MO` | | Bi-weekly Mondays | `FREQ=WEEKLY;INTERVAL=2;BYDAY=MO` |
| First of month | `FREQ=MONTHLY;BYMONTHDAY=1` | | First of month | `FREQ=MONTHLY;BYMONTHDAY=1` |
| First Wednesday | `FREQ=MONTHLY;BYDAY=1WE` |
| 15th of month | `FREQ=MONTHLY;BYMONTHDAY=15` | | 15th of month | `FREQ=MONTHLY;BYMONTHDAY=15` |
| Quarterly | `FREQ=MONTHLY;INTERVAL=3;BYMONTHDAY=1` | | Quarterly | `FREQ=MONTHLY;INTERVAL=3;BYMONTHDAY=1` |
@@ -619,4 +645,4 @@ Description: |
- [Creating and Managing Maintenances](/docs/v4/maintenances/creating-managing) - Apply these patterns in the dashboard - [Creating and Managing Maintenances](/docs/v4/maintenances/creating-managing) - Apply these patterns in the dashboard
- [Maintenance Events](/docs/v4/maintenances/events) - Understand how RRULE generates events - [Maintenance Events](/docs/v4/maintenances/events) - Understand how RRULE generates events
- [Maintenance Overview](/docs/v4/maintenances/overview) - Learn maintenance fundamentals - [Maintenance Overview](/docs/v4/maintenances/overview) - Learn maintenance fundamentals