From fe78bc1542b9425b551a19fb808dd47cbca475b4 Mon Sep 17 00:00:00 2001 From: Juliet Shackell <63259011+jshackell-sfdc@users.noreply.github.com> Date: Mon, 18 Apr 2022 20:10:03 -0700 Subject: [PATCH 1/6] update messages for "sf env create sandbox" --- messages/create.sandbox.md | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/messages/create.sandbox.md b/messages/create.sandbox.md index 1e7b0861..82815f4d 100644 --- a/messages/create.sandbox.md +++ b/messages/create.sandbox.md @@ -68,13 +68,21 @@ Type of sandbox license. Number of minutes to wait for the sandbox org to be ready. +# flags.wait.description + +If the command continues to run after the wait period, the CLI returns control of the terminal to you and displays the job ID. To check the status of the sandbox creation, run "sf env resume sandbox". + # flags.poll-interval.summary Number of seconds to wait between retries. # flags.async.summary -Don't wait for the sandbox create to complete. +Request the sandbox creation, but don't wait for it to complete. + +# flags.async.description + +The command immediately displays the job ID and returns control of the terminal to you. This way, you can continue to use the CLI. To check the status of the sandbox creation, run "sf env resume sandbox". # flags.noPrompt.summary From 86bb6159102a5921de3261065a929bbbed2bd4c9 Mon Sep 17 00:00:00 2001 From: Juliet Shackell <63259011+jshackell-sfdc@users.noreply.github.com> Date: Mon, 18 Apr 2022 20:13:36 -0700 Subject: [PATCH 2/6] update command to take new flag descriptions --- src/commands/env/create/sandbox.ts | 2 ++ 1 file changed, 2 insertions(+) diff --git a/src/commands/env/create/sandbox.ts b/src/commands/env/create/sandbox.ts index 3051e639..972ea74a 100644 --- a/src/commands/env/create/sandbox.ts +++ b/src/commands/env/create/sandbox.ts @@ -77,6 +77,7 @@ export default class CreateSandbox extends SandboxCommandBase Date: Mon, 18 Apr 2022 20:17:44 -0700 Subject: [PATCH 3/6] edit messages for "sf env resume sandbox" --- messages/resume.sandbox.md | 42 +++++++++++++++----------------------- 1 file changed, 16 insertions(+), 26 deletions(-) diff --git a/messages/resume.sandbox.md b/messages/resume.sandbox.md index d2d5e25d..e62e4d28 100644 --- a/messages/resume.sandbox.md +++ b/messages/resume.sandbox.md @@ -1,24 +1,26 @@ # summary -Check sandbox create status and complete authorization, if possible. +Check the status of a sandbox creation, and log in to it if it's ready. # description -Sandbox creation can take a long time, so we check the status of the sandbox creation using <%= config.bin %> <%= command.id %>. +Sandbox creation can take a long time. If the original "sf env create sandbox" command either times out, or you specified the --async flag, the command displays a job ID. Use this job ID to check whether the sandbox creation is complete, and if it is, the command then logs into it. + +You can also use the sandbox name to check the status or the --use-most-recent flag to use the job ID of the most recent sandbox creation. # examples -- Check the status of sandbox creation using the sandbox name. +- Check the status of sandbox creation using the sandbox name and a production org with alias "prodOrg": - <%= config.bin %> <%= command.id %> --name [--target-org ] + <%= config.bin %> <%= command.id %> --name mysandbox --target-org prodOrg -- Check the status of sandbox creation using the sandbox request job id. +- Check the status using the job ID: - <%= config.bin %> <%= command.id %> --job-id 0GRxxxxxxxxxxxxxxx [--target-org ] + <%= config.bin %> <%= command.id %> --job-id 0GRxxxxxxxx -- Check the status of sandbox creation using the latest sandbox request. +- Check the status of the most recent sandbox create request: - <%= config.bin %> <%= command.id %> --use-latest-request + <%= config.bin %> <%= command.id %> --use-most-recent # flags.setDefault.summary @@ -26,11 +28,11 @@ Set the sandbox org as your default org. # flags.id.summary -The sandbox process object Id. +Job ID of the incomplete sandbox creation that you want to check the status of. # flags.id.description -The sandbox process object Id. +The job ID is valid for 24 hours after you start the sandbox creation. # flags.alias.summary @@ -52,30 +54,18 @@ When it creates the sandbox org, Salesforce copies the metadata, and optionally Name of the sandbox org. -# flags.name.description - -Name of the sandbox org. - # flags.wait.summary Number of minutes to wait for the sandbox org to be ready. -# flags.poll-interval.summary - -Number of seconds to wait between retries. +# flags.wait.description -# flags.async.summary - -Don't wait for the sandbox create to complete. +If the command continues to run after the wait period, the CLI returns control of the terminal window to you and returns the job ID. To resume checking the sandbox creation, rerun this command. # flags.use-most-recent.summary Use the most recent sandbox create request. -# flags.use-most-recent.description - -Use the most recent sandbox create request. - # error.pollIntervalGreaterThanWait The poll interval (%d seconds) can't be larger that wait (%d in seconds). @@ -86,11 +76,11 @@ No sandbox name or job ID were provided. # error.LatestSandboxRequestNotFound -Please retry the command using either the --name or --job-id flags. +Retry the command using either the --name or --job-id flags. #error.NoSandboxRequestFound -Could not find a sandbox request using the provided sandbox name or job ID. +Couldn't find a sandbox creation request using the provided sandbox name or job ID. # error.ResumeTimeout From d90c9007baef59a5acf5de4ce34fc8704ac2ac96 Mon Sep 17 00:00:00 2001 From: Juliet Shackell <63259011+jshackell-sfdc@users.noreply.github.com> Date: Mon, 18 Apr 2022 20:21:42 -0700 Subject: [PATCH 4/6] update command with changes I made to messages --- src/commands/env/resume/sandbox.ts | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/src/commands/env/resume/sandbox.ts b/src/commands/env/resume/sandbox.ts index 702b9b3d..d047eb27 100644 --- a/src/commands/env/resume/sandbox.ts +++ b/src/commands/env/resume/sandbox.ts @@ -54,6 +54,7 @@ export default class ResumeSandbox extends SandboxCommandBase => { if (name.length > 10) { throw messages.createError('error.SandboxNameLength', [name]); @@ -79,7 +79,6 @@ export default class ResumeSandbox extends SandboxCommandBase Date: Mon, 18 Apr 2022 20:25:12 -0700 Subject: [PATCH 5/6] edit --- messages/resume.sandbox.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/messages/resume.sandbox.md b/messages/resume.sandbox.md index e62e4d28..9552806e 100644 --- a/messages/resume.sandbox.md +++ b/messages/resume.sandbox.md @@ -10,7 +10,7 @@ You can also use the sandbox name to check the status or the --use-most-recent f # examples -- Check the status of sandbox creation using the sandbox name and a production org with alias "prodOrg": +- Check the status of a sandbox creation using its name and specify a production org with alias "prodOrg": <%= config.bin %> <%= command.id %> --name mysandbox --target-org prodOrg From 783d5e62ac39b9b552c3aae7d35b505cdb65bc82 Mon Sep 17 00:00:00 2001 From: Juliet Shackell <63259011+jshackell-sfdc@users.noreply.github.com> Date: Tue, 19 Apr 2022 08:53:51 -0700 Subject: [PATCH 6/6] add pete's comment --- messages/create.sandbox.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/messages/create.sandbox.md b/messages/create.sandbox.md index 82815f4d..7399d533 100644 --- a/messages/create.sandbox.md +++ b/messages/create.sandbox.md @@ -70,7 +70,7 @@ Number of minutes to wait for the sandbox org to be ready. # flags.wait.description -If the command continues to run after the wait period, the CLI returns control of the terminal to you and displays the job ID. To check the status of the sandbox creation, run "sf env resume sandbox". +If the command continues to run after the wait period, the CLI returns control of the terminal to you and displays the "sf env resume sandbox" command you run to check the status of the create. The displayed command includes the job ID for the running sandbox creation. # flags.poll-interval.summary