Recovery Mode on Instance (civo#518)

* Revert "Enable Vol Resize"

This reverts commit 5876546.

* added instance recovery

* update docs

* Revert "Revert "Enable Vol Resize""

This reverts commit 1357495.

* bump civogo

Author: uzaxirr

README.md

@@ -666,6 +666,28 @@ Hello, world!
 
 Please note that resizing can take a few minutes.
 
+
+### Recovery Mode
+
+Recovery mode allows you to boot your instance into a recovery environment for troubleshooting.
+
+```sh
+# Enable recovery mode for an instance
+civo instance recovery enable INSTANCE_ID/HOSTNAME
+
+# Disable recovery mode for an instance
+civo instance recovery disable INSTANCE_ID/HOSTNAME
+
+# Check recovery mode status
+civo instance recovery-status INSTANCE_ID/HOSTNAME
+```
+
+The recovery-status command supports custom output formats with the following fields:
+* id - The instance ID
+* hostname - The instance hostname
+* status - Current recovery mode status
+
+
 ### VNC Access
 
 The VNC command allows you to access your instance through a browser-based VNC console.
@@ -688,6 +710,8 @@ When executed, the command will:
 2. Generate a secure VNC URL
 3. Automatically open the console in your default browser
 4. Attempt to connect for up to 35 seconds before timing out
+
+
 ## Kubernetes clusters
 
 #### Introduction

cmd/instance/instance.go

@@ -39,6 +39,8 @@ func init() {
 	InstanceCmd.AddCommand(instancePasswordCmd)
 	InstanceCmd.AddCommand(instanceTagCmd)
 	InstanceCmd.AddCommand(instanceVncCmd)
+	InstanceCmd.AddCommand(instanceRecoveryCmd)
+	InstanceCmd.AddCommand(instanceRecoveryStatusCmd)
 
 	instanceUpdateCmd.Flags().StringVarP(&notes, "notes", "n", "", "notes stored against the instance")
 	instanceUpdateCmd.Flags().StringVarP(&reverseDNS, "reverse-dns", "r", "", "the reverse DNS entry for the instance")

cmd/instance/instance_recovery.go

@@ -0,0 +1,72 @@
+package instance
+
+import (
+	"fmt"
+	"os"
+
+	"github.com/civo/cli/common"
+	"github.com/civo/cli/config"
+	"github.com/civo/cli/utility"
+	"github.com/spf13/cobra"
+)
+
+var instanceRecoveryCmd = &cobra.Command{
+	Use:     "recovery",
+	Example: "civo instance recovery enable/disable ID/HOSTNAME",
+	Args:    cobra.MinimumNArgs(2),
+	Short:   "Enable/disable recovery mode for an instance",
+	Long: `Enable or disable recovery mode for a specified instance.
+Recovery mode allows you to boot your instance into a recovery environment for troubleshooting.
+
+Example:
+  * Enable recovery mode:
+    civo instance recovery enable my-instance
+  * Disable recovery mode:
+    civo instance recovery disable my-instance`,
+	Aliases: []string{"rescue"},
+	Run: func(cmd *cobra.Command, args []string) {
+		utility.EnsureCurrentRegion()
+
+		client, err := config.CivoAPIClient()
+		if common.RegionSet != "" {
+			client.Region = common.RegionSet
+		}
+
+		if err != nil {
+			utility.Error("Creating the connection to Civo's API failed with %s", err)
+			os.Exit(1)
+		}
+
+		if args[0] != "enable" && args[0] != "disable" {
+			utility.Error("Please specify either enable or disable")
+			os.Exit(1)
+		}
+
+		instance, err := client.FindInstance(args[1])
+		if err != nil {
+			utility.Error("%s", err)
+			os.Exit(1)
+		}
+		fmt.Println("Instance ID is: ", instance.ID)
+
+		if args[0] == "enable" {
+			_, err := client.EnableRecoveryMode(instance.ID)
+			if err != nil {
+				utility.Error("%s", err)
+				os.Exit(1)
+			}
+		} else {
+			_, err := client.DisableRecoveryMode(instance.ID)
+			if err != nil {
+				utility.Error("%s", err)
+				os.Exit(1)
+			}
+		}
+
+		if args[0] == "enable" {
+			fmt.Printf("Recovery mode has been enabled for instance %s\n", utility.Green(instance.Hostname))
+		} else {
+			fmt.Printf("Recovery mode has been disabled for instance %s\n", utility.Green(instance.Hostname))
+		}
+	},
+}

cmd/instance/instance_recovery_status.go

@@ -0,0 +1,70 @@
+package instance
+
+import (
+	"fmt"
+	"os"
+
+	"github.com/civo/cli/common"
+	"github.com/civo/cli/config"
+	"github.com/civo/cli/utility"
+	"github.com/spf13/cobra"
+)
+
+var instanceRecoveryStatusCmd = &cobra.Command{
+	Use:     "recovery-status",
+	Aliases: []string{"recovery"},
+	Example: "civo instance recovery-status INSTANCE_ID/HOSTNAME",
+	Short:   "Get the recovery status of an instance",
+	Long: `Show the current recovery mode status for a specified instance.
+If you wish to use a custom format, the available fields are:
+
+	* id
+	* hostname
+	* status
+
+Example:
+  * Check recovery status:
+    civo instance recovery-status my-instance`,
+	Args: cobra.MinimumNArgs(1),
+	Run: func(cmd *cobra.Command, args []string) {
+		utility.EnsureCurrentRegion()
+
+		client, err := config.CivoAPIClient()
+		if common.RegionSet != "" {
+			client.Region = common.RegionSet
+		}
+
+		if err != nil {
+			utility.Error("Creating the connection to Civo's API failed with %s", err)
+			os.Exit(1)
+		}
+
+		instance, err := client.FindInstance(args[0])
+		if err != nil {
+			utility.Error("Instance %s", err)
+			os.Exit(1)
+		}
+
+		status, err := client.GetRecoveryStatus(instance.ID)
+		if err != nil {
+			utility.Error("Failed to get recovery status: %s", err)
+			os.Exit(1)
+		}
+
+		ow := utility.NewOutputWriterWithMap(map[string]string{
+			"id":       instance.ID,
+			"hostname": instance.Hostname,
+			"status":   string(status.Result),
+		})
+
+		switch common.OutputFormat {
+		case "json":
+			ow.WriteSingleObjectJSON(common.PrettySet)
+		case "custom":
+			ow.WriteCustomOutput(common.OutputFields)
+		default:
+			fmt.Printf("Recovery Status for instance %s (%s):\n", utility.Green(instance.Hostname), instance.ID)
+			ow.WriteKeyValues()
+		}
+	},
+}

go.mod

@@ -9,7 +9,7 @@ require (
 	github.com/adhocore/gronx v1.19.5
 	github.com/alejandrojnm/go-pluralize v0.1.0
 	github.com/briandowns/spinner v1.23.2
-	github.com/civo/civogo v0.3.95
+	github.com/civo/civogo v0.3.96
 	github.com/google/go-github/v57 v57.0.0
 	github.com/google/uuid v1.6.0
 	github.com/gookit/color v1.5.4

go.sum

@@ -28,10 +28,8 @@ github.com/briandowns/spinner v1.23.2 h1:Zc6ecUnI+YzLmJniCfDNaMbW0Wid1d5+qcTq4L2
 github.com/briandowns/spinner v1.23.2/go.mod h1:LaZeM4wm2Ywy6vO571mvhQNRcWfRUnXOs0RcKV0wYKM=
 github.com/c4milo/unpackit v0.0.0-20170704181138-4ed373e9ef1c h1:aprLqMn7gSPT+vdDSl+/E6NLEuArwD/J7IWd8bJt5lQ=
 github.com/c4milo/unpackit v0.0.0-20170704181138-4ed373e9ef1c/go.mod h1:Ie6SubJv/NTO9Q0UBH0QCl3Ve50lu9hjbi5YJUw03TE=
-github.com/civo/civogo v0.3.94 h1:VhdqaJ2m4z8Jz8arzyzVjokRnO8JQ3lGjLKLshJ1eJI=
-github.com/civo/civogo v0.3.94/go.mod h1:LaEbkszc+9nXSh4YNG0sYXFGYqdQFmXXzQg0gESs2hc=
-github.com/civo/civogo v0.3.95 h1:QNe/uCYzbg1M//Z8ZvxiasLjrh9WvrpSb5spE7ln5lY=
-github.com/civo/civogo v0.3.95/go.mod h1:LaEbkszc+9nXSh4YNG0sYXFGYqdQFmXXzQg0gESs2hc=
+github.com/civo/civogo v0.3.96 h1:9R3yZS3B8B0oAqIlNDnMvsONk0mqZUkHREd0EH6HRIc=
+github.com/civo/civogo v0.3.96/go.mod h1:LaEbkszc+9nXSh4YNG0sYXFGYqdQFmXXzQg0gESs2hc=
 github.com/cpuguy83/go-md2man/v2 v2.0.6/go.mod h1:oOW0eioCTA6cOiMLiUPZOpcVxMig6NIQQ7OS05n1F4g=
 github.com/danwakefield/fnmatch v0.0.0-20160403171240-cbb64ac3d964 h1:y5HC9v93H5EPKqaS1UYVg1uYah5Xf51mBfIoWehClUQ=
 github.com/danwakefield/fnmatch v0.0.0-20160403171240-cbb64ac3d964/go.mod h1:Xd9hchkHSWYkEqJwUGisez3G1QY8Ryz0sdWrLPMGjLk=
@@ -191,8 +189,8 @@ golang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACk
 golang.org/x/crypto v0.0.0-20190426145343-a29dc8fdc734/go.mod h1:yigFU9vqHzYiE8UmvKecakEJjdnWj3jj499lnFckfCI=
 golang.org/x/crypto v0.0.0-20191011191535-87dc89f01550/go.mod h1:yigFU9vqHzYiE8UmvKecakEJjdnWj3jj499lnFckfCI=
 golang.org/x/crypto v0.0.0-20200622213623-75b288015ac9/go.mod h1:LzIPMQfyMNhhGPhUkYOs5KpL4U8rLKemX1yGLhDgUto=
-golang.org/x/crypto v0.35.0 h1:b15kiHdrGCHrP6LvwaQ3c03kgNhhiMgvlhxHQhmg2Xs=
-golang.org/x/crypto v0.35.0/go.mod h1:dy7dXNW32cAb/6/PRuTNsix8T+vJAqvuIy5Bli/x0YQ=
+golang.org/x/crypto v0.33.0 h1:IOBPskki6Lysi0lo9qQvbxiQ+FvsCC/YWOecCHAixus=
+golang.org/x/crypto v0.33.0/go.mod h1:bVdXmD7IV/4GdElGPozy6U7lWdRXA4qyRVGJV57uQ5M=
 golang.org/x/image v0.0.0-20191009234506-e7c1f5e7dbb8/go.mod h1:FeLwcggjj3mMvU+oOTbSwawSJRM1uh48EjtB4UJZlP0=
 golang.org/x/image v0.0.0-20191206065243-da761ea9ff43 h1:gQ6GUSD102fPgli+Yb4cR/cGaHF7tNBt+GYoRCpGC7s=
 golang.org/x/image v0.0.0-20191206065243-da761ea9ff43/go.mod h1:FeLwcggjj3mMvU+oOTbSwawSJRM1uh48EjtB4UJZlP0=
@@ -206,8 +204,8 @@ golang.org/x/net v0.0.0-20190620200207-3b0461eec859/go.mod h1:z5CRVTTTmAJ677TzLL
 golang.org/x/net v0.0.0-20190813141303-74dc4d7220e7/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s=
 golang.org/x/net v0.0.0-20200226121028-0de0cce0169b/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s=
 golang.org/x/net v0.0.0-20201021035429-f5854403a974/go.mod h1:sp8m0HH+o8qH0wwXwYZr8TS3Oi6o0r6Gce1SSxlDquU=
-golang.org/x/net v0.36.0 h1:vWF2fRbw4qslQsQzgFqZff+BItCvGFQqKzKIzx1rmoA=
-golang.org/x/net v0.36.0/go.mod h1:bFmbeoIPfrw4sMHNhb4J9f6+tPziuGjq7Jk/38fxi1I=
+golang.org/x/net v0.33.0 h1:74SYHlV8BIgHIFC/LrYkOGIwL19eTYXQ5wc6TBuO36I=
+golang.org/x/net v0.33.0/go.mod h1:HXLR5J+9DxmrqMwG9qjGCxZ+zKXxBru04zlTvWlWuN4=
 golang.org/x/sync v0.0.0-20180314180146-1d60e4601c6f/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
 golang.org/x/sync v0.0.0-20190423024810-112230192c58/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
 golang.org/x/sync v0.0.0-20190911185100-cd5d95a43a6e/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=