Feat: One-click host update (#186)

Author: damiankopyto

VERSION

@@ -1 +1 @@
-0.12.19
+0.12.20

docs/cli/orch-cli_update-os.md

@@ -0,0 +1,26 @@
+## orch-cli update-os
+
+Update host
+
+### Options
+
+```
+  -h, --help   help for update-os
+```
+
+### 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](orch-cli.md)	 - Orch-cli Command Line Interface
+* [orch-cli update-os host](orch-cli_update-os_host.md)	 - Updates a host
+
+###### Auto generated by spf13/cobra on 5-Nov-2025

docs/cli/orch-cli_update-os_host.md

@@ -0,0 +1,78 @@
+## orch-cli update-os host
+
+Updates a host
+
+```
+orch-cli update-os host <resourceID> [flags]
+```
+
+### Examples
+
+```
+#Update the host OS
+orch-cli update-os host host-1234abcd  --project itep
+
+#Update the host OS with a specific OS Update Policy
+orch-cli update-os host host-1234abcd  --project itep --osupdatepolicy <resourceID>
+
+--osupdatepolicy - Set the OS Update policy for the host, must be a valid resource ID of an OS Update policy
+
+#Generate CSV input file using the --generate-csv flag - the default output will be a base test.csv file.
+orch-cli update-os host --project itep --generate-csv
+
+#Generate CSV input file using the --generate-csv flag with a filter flag which will find a specific list of currently deployed hosts based on the filter - the output will contain filtered hosts.
+orch-cli update-os host --project itep --generate-csv --filter=<filter> --site <siteID>
+orch-cli update-os host --project itep --generate-csv --filter=<filter> --region <regionID>
+
+
+--filter - Predefined filters: provisioned, onboarded, registered, "not connected", deauthorized or custom filter (see: https://google.aip.dev/160 and API spec @
+--region - Region ID to filter hosts by region, cannot be used with --site flag, can be used with --filter flag
+--site - Site ID to filter hosts by site, cannot be used with --region flag, can be used with --filter flag
+
+#Update a bulk number of hosts from a CSV file - --import-from-csv is a mandatory flag pointing to the input file.
+orch-cli update-os host --project itep --import-from-csv test.csv
+
+# Sample input csv file test.csv
+
+Name - Name of the machine - mandatory field
+ResourceID - Unique Identifier of host - mandatory field
+OSUpdatePolicy - Desired update policy - optional field - currently set policy for the host will be used if not provided
+
+Name,ResourceID,OSUpdatePolicy
+host-1,host-1234abcd,osupdatepolicy-1234abcd
+host-2,host-2234abcd
+host-3,host-3234abcd,osupdatepolicy-1234abcd
+
+```
+
+### Options
+
+```
+  -d, --dry-run                            Verify the validity of input CSV file
+  -f, --filter string                      Optional filter provided as part of host discovery command
+                                           Usage:
+                                           	Custom filter: --filter "<custom filter>" ie. --filter "osType=OS_TYPE_IMMUTABLE" see https://google.aip.dev/160 and API spec. 
+                                           	Predefined filters: --filter provisioned/onboarded/registered/nor connected/deauthorized
+  -g, --generate-csv string[="test.csv"]   Generates a template CSV file for host import
+  -h, --help                               help for host
+  -i, --import-from-csv string             CSV file containing information about provisioned hosts to be updated
+  -u, --osupdatepolicy string              Set OS update policy <resourceID>
+  -r, --region string                      Optional filter provided as part of host discovery command to filter hosts by region
+  -s, --site string                        Optional filter provided as part of host discovery command to filter hosts by site
+```
+
+### 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 update-os](orch-cli_update-os.md)	 - Update host
+
+###### Auto generated by spf13/cobra on 5-Nov-2025