Feat: Support maintenance schedule in CLI (#155)

Author: damiankopyto

docs/cli/orch-cli_create_schedule.md

@@ -0,0 +1,56 @@
+## orch-cli create schedule
+
+Creates a schedule configuration
+
+```
+orch-cli create schedule [flags]
+```
+
+### Examples
+
+```
+# Create a new repeated schedule, an osupdate , using days of week
+orch-cli create schedules my-schedule --timezone GMT --frequency-type repeated --maintenance-type osupdate --target site-532d1d07 --frequency weekly --start-time "10:10" --day-of-week "1-3,5" --months "2,4,7-8" --duration 3600
+
+# Create a new repeated schedule, a maintenance , using days of month
+orch-cli create schedules my-schedule --timezone GMT  --frequency-type repeated  --maintenance-type maintenance --target site-532d1d07 --frequency monthly --start-time "10:10" --day-of-month "1,6,31" --months "2,4,7-12" --duration 3600
+
+# Create a new single schedule, an osupdate
+orch-cli create schedules my-schedule --timezone GMT --frequency-type single --maintenance-type osupdate --target region-65c0d433 --start-time "2026-12-01 20:20" --end-time "2027-12-01 20:20"
+
+```
+
+### Options
+
+```
+  -D, --day-of-month string       Day of the month for repeated schedule: --day-of-month "1-4,31"
+  -d, --day-of-week string        Day of the week for repeated schedule: --day-of-week "mon,tue,wed,thu,fri,sat,sun"
+  -u, --duration int              Duration of the maintenance window in seconds: --duration 3600
+  -e, --end-time string           End time of the schedule: --end-time "2025-12-15 14:00"
+  -f, --frequency string          Frequency of the schedule: --frequency daily|weekly|monthly
+  -F, --frequency-type string     Frequency of the schedule: --frequency-type single|repeated
+  -h, --help                      help for schedule
+  -H, --hour string               Hour of the day for repeated schedule (0-23): --hour 2
+  -m, --maintenance-type string   Type of maintenance: --maintenance-type maintenance|osupdate
+  -M, --minute string             Minute of the hour for repeated schedule (0-59): --minute 30
+  -x, --months string             The months in which the schedule should run --months "1-2,12"
+  -s, --start-time string         Start time of the schedule: --start-time "2025-12-15 12:00"
+  -T, --target string             Target maintenance on a host|region|site using it's resource ID: --target host-abcd1234|region-abcd1234|site-abcd1234
+  -t, --timezone string           Set time in particular timezone: --timezone Europe/Berlin
+```
+
+### Options inherited from parent commands
+
+```
+      --api-endpoint string   API Service Endpoint (default "https://api.orch-10-114-181-120.espdqa.infra-host.com")
+      --debug-headers         emit debug-style headers separating columns via '|' character
+  -n, --noauth                use without authentication checks
+  -p, --project string        Active project name (default "itep")
+  -v, --verbose               produce verbose output
+```
+
+### SEE ALSO
+
+* [orch-cli create](orch-cli_create.md)	 - Create various orchestrator service entities
+
+###### Auto generated by spf13/cobra on 2-Oct-2025

docs/cli/orch-cli_delete_schedule.md

@@ -0,0 +1,36 @@
+## orch-cli delete schedule
+
+Delete a schedule configuration
+
+```
+orch-cli delete schedule <name> [flags]
+```
+
+### Examples
+
+```
+# Delete a schedule resource using it's resource ID
+orch-cli delete schedule repeatedsche-abcd1234 --project some-project
+```
+
+### Options
+
+```
+  -h, --help   help for schedule
+```
+
+### Options inherited from parent commands
+
+```
+      --api-endpoint string   API Service Endpoint (default "https://api.orch-10-114-181-120.espdqa.infra-host.com")
+      --debug-headers         emit debug-style headers separating columns via '|' character
+  -n, --noauth                use without authentication checks
+  -p, --project string        Active project name (default "itep")
+  -v, --verbose               produce verbose output
+```
+
+### SEE ALSO
+
+* [orch-cli delete](orch-cli_delete.md)	 - Delete various orchestrator service entities
+
+###### Auto generated by spf13/cobra on 2-Oct-2025

docs/cli/orch-cli_get_schedule.md

@@ -0,0 +1,37 @@
+## orch-cli get schedule
+
+Get a schedule configuration
+
+```
+orch-cli get schedule <name> [flags]
+```
+
+### Examples
+
+```
+# Get detailed information about specific schedule resource using it's resource ID
+orch-cli get schedule repeatedsche-abcd1234 --project some-project
+```
+
+### Options
+
+```
+  -h, --help              help for schedule
+  -t, --timezone string   Display time in particular timezone: --timezone Europe/Berlin
+```
+
+### Options inherited from parent commands
+
+```
+      --api-endpoint string   API Service Endpoint (default "https://api.orch-10-114-181-120.espdqa.infra-host.com")
+      --debug-headers         emit debug-style headers separating columns via '|' character
+  -n, --noauth                use without authentication checks
+  -p, --project string        Active project name (default "itep")
+  -v, --verbose               produce verbose output
+```
+
+### SEE ALSO
+
+* [orch-cli get](orch-cli_get.md)	 - Get various orchestrator service entities
+
+###### Auto generated by spf13/cobra on 2-Oct-2025

docs/cli/orch-cli_list_schedule.md

@@ -0,0 +1,37 @@
+## orch-cli list schedule
+
+List all schedule configurations
+
+```
+orch-cli list schedule [flags]
+```
+
+### Examples
+
+```
+# List all schedule resources
+orch-cli list schedule --project some-project
+
+```
+
+### Options
+
+```
+  -h, --help   help for schedule
+```
+
+### Options inherited from parent commands
+
+```
+      --api-endpoint string   API Service Endpoint (default "https://api.orch-10-114-181-120.espdqa.infra-host.com")
+      --debug-headers         emit debug-style headers separating columns via '|' character
+  -n, --noauth                use without authentication checks
+  -p, --project string        Active project name (default "itep")
+  -v, --verbose               produce verbose output
+```
+
+### SEE ALSO
+
+* [orch-cli list](orch-cli_list.md)	 - List various orchestrator service entities
+
+###### Auto generated by spf13/cobra on 2-Oct-2025

docs/cli/orch-cli_set_schedule.md

@@ -0,0 +1,55 @@
+## orch-cli set schedule
+
+Update a schedule configuration
+
+```
+orch-cli set schedule <name> [flags]
+```
+
+### Examples
+
+```
+# Update a repeated schedule resource (by month day) using it's resource ID (not all parameters need to be updated at same time --timezone is mandatory)
+orch-cli set schedules repeatedsche-abcd1234 --timezone GMT --maintenance-type osupdate --frequency weekly --start-time "10:10" --day-of-week "1-3,5" --months "2,4,7-8" --duration 3600
+
+# Update a repeated schedule resource (by weekday) using it's resource ID (not all parameters need to be updated at same time --timezone is mandatory)
+orch-cli set schedules repeatedsche-abcd1234 --timezone GMT --maintenance-type osupdate --frequency monthly --start-time "10:10" --day-of-month "1-3,5" --months "2,4,7-8" --duration 3600
+
+# Update a single schedule resource using it's resource ID (not all parameters need to be updated at same time, --timezone is mandatory)
+orch-cli set schedules repeatedsche-abcd1234 --timezone GMT --maintenance-type osupdate --start-time "2026-02-02 10:10" --end-time "2026-02-02 10:10" 
+
+```
+
+### Options
+
+```
+  -D, --day-of-month string       Day of the month for repeated schedule: --day-of-month "1-4,31"
+  -d, --day-of-week string        Day of the week for repeated schedule: --day-of-week "mon,tue,wed,thu,fri,sat,sun"
+  -u, --duration int              Duration of the maintenance window in seconds: --duration 3600
+  -e, --end-time string           End time of the schedule: --end-time "2025-12-15 14:00"
+  -f, --frequency string          Frequency of the schedule: --frequency daily|weekly|monthly
+  -h, --help                      help for schedule
+  -H, --hour string               Hour of the day for repeated schedule (0-23): --hour 2
+  -m, --maintenance-type string   Type of maintenance: --maintenance-type maintenance|osupdate
+  -M, --minute string             Minute of the hour for repeated schedule (0-59): --minute 30
+  -x, --months string             The months in which the schedule should run --months "1-2,12"
+  -N, --name string               Schedule name
+  -s, --start-time string         Start time of the schedule: --start-time "2025-12-15 12:00"
+  -t, --timezone string           Set time in particular timezone: --timezone Europe/Berlin
+```
+
+### Options inherited from parent commands
+
+```
+      --api-endpoint string   API Service Endpoint (default "https://api.orch-10-114-181-120.espdqa.infra-host.com")
+      --debug-headers         emit debug-style headers separating columns via '|' character
+  -n, --noauth                use without authentication checks
+  -p, --project string        Active project name (default "itep")
+  -v, --verbose               produce verbose output
+```
+
+### SEE ALSO
+
+* [orch-cli set](orch-cli_set.md)	 - Update various orchestrator service entities
+
+###### Auto generated by spf13/cobra on 3-Oct-2025

internal/cli/crud.go

@@ -29,6 +29,7 @@ var (
 	registryAliases          = []string{"registry", "registries", "reg", "regs"}
 	regionAliases            = []string{"region", "regions", "regn", "regns"}
 	siteAliases              = []string{"site", "sites", "st", "sts"}
+	scheduleAliases          = []string{"schedule", "schedules", "sch", "schs"}
 	sshKeyAliases            = []string{"sshkey", "sshkeys", "ssh", "sshs"}
 )
 
@@ -63,6 +64,7 @@ func getCreateCommand() *cobra.Command {
 		getCreateOSProfileCommand(),
 		getCreateProviderCommand(),
 		getCreateSSHKeyCommand(),
+		getCreateScheduleCommand(),
 	)
 	return cmd
 }
@@ -97,6 +99,7 @@ func getListCommand() *cobra.Command {
 		getListHostCommand(),
 		getListProviderCommand(),
 		getListSSHKeyCommand(),
+		getListScheduleCommand(),
 	)
 	return catalogListRootCmd
 }
@@ -129,6 +132,7 @@ func getGetCommand() *cobra.Command {
 		getGetHostCommand(),
 		getGetProviderCommand(),
 		getGetSSHKeyCommand(),
+		getGetScheduleCommand(),
 	)
 	return catalogGetRootCmd
 }
@@ -153,6 +157,7 @@ func getSetCommand() *cobra.Command {
 		getSetNetworkCommand(),
 
 		getSetHostCommand(),
+		getSetScheduleCommand(),
 	)
 	return cmd
 }
@@ -186,6 +191,7 @@ func getDeleteCommand() *cobra.Command {
 		getDeleteHostCommand(),
 		getDeleteProviderCommand(),
 		getDeleteSSHKeyCommand(),
+		getDeleteScheduleCommand(),
 	)
 	return catalogDeleteRootCmd
 }