fix(sg): provide suggestions we fail to get local gcp account email address (#64325)

Part of sourcegraph/devx-support#1142

If we fail to get the gcp address, provide steps the user can try to fix
it

![Screenshot 2024-08-07 at 10 14
00](https://github.com/user-attachments/assets/39e6fdcb-ee60-43b8-bdca-d28a9d210b2e)


## Test plan
Tested locally

## Changelog
sg - provide steps a user can follow if we fail to get the local gcp
email address

Author: burmudar

dev/sg/internal/cloud/client.go

@@ -61,10 +61,6 @@ func NewDeploymentSpec(name, version, license string) *DeploymentSpec {
 	}
 }
 
-func GetGCloudAccount(ctx context.Context) (string, error) {
-	return run.Cmd(ctx, "gcloud config get account").Run().String()
-}
-
 func NewClient(ctx context.Context, email, endpoint string) (*Client, error) {
 	// have to use IDENTITY token not ACCESS token!
 	token, err := run.Cmd(ctx, "gcloud auth print-identity-token").Run().String()

dev/sg/internal/cloud/common.go

@@ -8,6 +8,7 @@ import (
 	"github.com/sourcegraph/run"
 
 	"github.com/sourcegraph/sourcegraph/dev/sg/internal/repo"
+	"github.com/sourcegraph/sourcegraph/dev/sg/internal/std"
 	"github.com/sourcegraph/sourcegraph/lib/errors"
 )
 
@@ -52,6 +53,15 @@ func oneOfEquals(value string, i ...string) bool {
 	return false
 }
 
-func getGCloudAccount(ctx context.Context) (string, error) {
-	return run.Cmd(ctx, "gcloud", "config", "get", "account").Run().String()
+func GetGCloudAccount(ctx context.Context) (string, error) {
+	return run.Cmd(ctx, "gcloud", "auth", "list", "--filter", "status:ACTIVE", "--format", "value(account)").Run().String()
+}
+
+func writeGCloudErrorSuggestion() {
+	msg := "Failed to determine your gcloud account to get your email address. This might indicate that there is a problem with your local gcloud configuration"
+	suggestion := "Try the following steps:\n"
+	suggestion += "1. `gcloud auth login` should open a browser window and prompt you to log in with your Google account - ensure you login with your sourcegraph address!\n"
+	suggestion += "\nIf the steps above don't work please reach out to #discuss-dev-infra\n"
+	std.Out.WriteWarningf(msg)
+	std.Out.WriteMarkdown(withFAQ(suggestion))
 }

dev/sg/internal/cloud/dashboard_command.go

@@ -39,6 +39,7 @@ var opsDashboardEphemeralCommand = cli.Command{
 func showCloudEphemeralOps(ctx *cli.Context) error {
 	email, err := GetGCloudAccount(ctx.Context)
 	if err != nil {
+		writeGCloudErrorSuggestion()
 		return err
 	}
 

dev/sg/internal/cloud/delete_command.go

@@ -28,6 +28,7 @@ var deleteEphemeralCommand = cli.Command{
 func deleteCloudEphemeral(ctx *cli.Context) error {
 	email, err := GetGCloudAccount(ctx.Context)
 	if err != nil {
+		writeGCloudErrorSuggestion()
 		return err
 	}
 

dev/sg/internal/cloud/deploy_command.go

@@ -261,6 +261,7 @@ Please make sure you have either pushed or pulled the latest changes before tryi
 	}
 	email, err := GetGCloudAccount(ctx.Context)
 	if err != nil {
+		writeGCloudErrorSuggestion()
 		return err
 	}
 

dev/sg/internal/cloud/lease_command.go

@@ -71,6 +71,7 @@ func calcLeaseEnd(currentLeaseTime time.Time, extension, reduction time.Duration
 func leaseCloudEphemeral(ctx *cli.Context) error {
 	email, err := GetGCloudAccount(ctx.Context)
 	if err != nil {
+		writeGCloudErrorSuggestion()
 		return err
 	}
 

dev/sg/internal/cloud/list_command.go

@@ -35,6 +35,7 @@ var listEphemeralCommand = cli.Command{
 func listCloudEphemeral(ctx *cli.Context) error {
 	email, err := GetGCloudAccount(ctx.Context)
 	if err != nil {
+		writeGCloudErrorSuggestion()
 		return err
 	}
 

dev/sg/internal/cloud/status_command.go

@@ -36,6 +36,7 @@ var statusEphemeralCommand = cli.Command{
 func statusCloudEphemeral(ctx *cli.Context) error {
 	email, err := GetGCloudAccount(ctx.Context)
 	if err != nil {
+		writeGCloudErrorSuggestion()
 		return err
 	}
 

dev/sg/internal/cloud/upgrade_command.go

@@ -92,6 +92,7 @@ func upgradeCloudEphemeral(ctx *cli.Context) error {
 	}
 	email, err := GetGCloudAccount(ctx.Context)
 	if err != nil {
+		writeGCloudErrorSuggestion()
 		return err
 	}
 	deploymentName := determineDeploymentName(ctx.String("name"), version, email, currentBranch)