feat(ec2): provide link to launch instance. (#3697)

## Problem
User Request
## Solution
Add option to launch instance from toolkit. The option links to console
page for launching EC2 instances. Currently, the functionality is
available as an icon-button and on right-click. Additionally, we have it
in the command-palette. In the command palette, the region is inferred
using `guessDefaultRegion`. I see three potential alternatives:
- (1)provide a region prompter when used from the command palette that
defaults to the region given by `guessDefaultRegion`.
- (2)Don't prompt for region, and assume the region based on
`guessDefaultRegion`.
- (3)Don't allow the command to be used from command palette and only
see it on the explorer.
Let me know if you think either of the alternatives presented above
would be preferred.

The current implementation (1) because it seems like the optimal middle
ground. We allow the customer to select their region, while also
providing an intuitive and helpful default.

Below are some screenshots of the feature:
<img width="743" alt="image"
src="https://github.com/user-attachments/assets/3f56800c-ca95-4f82-be48-76d353ad92ad">
<img width="530" alt="image"
src="https://github.com/user-attachments/assets/088da856-7bbc-4e3f-98bf-1028372111bf">
<img width="691" alt="image"
src="https://github.com/user-attachments/assets/a09367d2-cd41-4f6a-804f-fb7327041f53">


<!---
    REMINDER:
    - Read CONTRIBUTING.md first.
    - Add test coverage for your changes.
    - Update the changelog using `npm run newChange`.
    - Link to related issues/commits.
    - Testing: how did you test your changes?
    - Screenshots
-->

## License

By submitting this pull request, I confirm that my contribution is made
under the terms of the Apache 2.0 license.

---------

Co-authored-by: JadenSimon <[email protected]>
Co-authored-by: Weinstock <[email protected]>
Co-authored-by: Justin M. Keyes <[email protected]>

Author: 4 people

packages/core/package.json

@@ -1189,6 +1189,10 @@
                     "command": "aws.ec2.openTerminal",
                     "when": "aws.isDevMode"
                 },
+                {
+                    "command": "aws.ec2.linkToLaunch",
+                    "when": "aws.isDevMode"
+                },
                 {
                     "command": "aws.ec2.startInstance",
                     "when": "aws.isDevMode"
@@ -1411,6 +1415,16 @@
                     "group": "inline@1",
                     "when": "viewItem =~ /^(awsEc2(Parent|Running)Node)$/"
                 },
+                {
+                    "command": "aws.ec2.linkToLaunch",
+                    "group": "0@1",
+                    "when": "viewItem =~ /^(awsEc2ParentNode)$/"
+                },
+                {
+                    "command": "aws.ec2.linkToLaunch",
+                    "group": "inline@1",
+                    "when": "viewItem =~ /^(awsEc2ParentNode)$/"
+                },
                 {
                     "command": "aws.ec2.openRemoteConnection",
                     "group": "0@1",
@@ -2253,6 +2267,18 @@
                     }
                 }
             },
+            {
+                "command": "aws.ec2.linkToLaunch",
+                "title": "%AWS.command.ec2.linkToLaunch%",
+                "icon": "$(add)",
+                "category": "%AWS.title%",
+                "enablement": "isCloud9 || !aws.isWebExtHost",
+                "cloud9": {
+                    "cn": {
+                        "category": "%AWS.title.cn%"
+                    }
+                }
+            },
             {
                 "command": "aws.ec2.openRemoteConnection",
                 "title": "%AWS.command.ec2.openRemoteConnection%",

packages/core/package.nls.json

@@ -124,6 +124,7 @@
     "AWS.command.ec2.openTerminal": "Open terminal to EC2 instance...",
     "AWS.command.ec2.openRemoteConnection": "Connect to EC2 instance in New Window...",
     "AWS.command.ec2.startInstance": "Start EC2 Instance",
+    "AWS.command.ec2.linkToLaunch": "Launch EC2 Instance",
     "AWS.command.ec2.stopInstance": "Stop EC2 Instance",
     "AWS.command.ec2.rebootInstance": "Reboot EC2 Instance",
     "AWS.command.ec2.copyInstanceId": "Copy Instance Id",

packages/core/src/awsService/ec2/activation.ts

@@ -15,6 +15,7 @@ import {
     startInstance,
     stopInstance,
     refreshExplorer,
+    linkToLaunchInstance,
 } from './commands'
 
 export async function activate(ctx: ExtContext): Promise<void> {
@@ -56,6 +57,12 @@ export async function activate(ctx: ExtContext): Promise<void> {
                 await rebootInstance(node)
                 refreshExplorer(node)
             })
+        }),
+
+        Commands.register('aws.ec2.linkToLaunch', async (node?: Ec2Node) => {
+            await telemetry.ec2_launchInstance.run(async (span) => {
+                await linkToLaunchInstance(node)
+            })
         })
     )
 }

packages/core/src/awsService/ec2/commands.ts

@@ -10,6 +10,9 @@ import { Ec2Prompter, instanceFilter, Ec2Selection } from './prompter'
 import { SafeEc2Instance, Ec2Client } from '../../shared/clients/ec2Client'
 import { copyToClipboard } from '../../shared/utilities/messages'
 import { getLogger } from '../../shared/logger'
+import { getAwsConsoleUrl } from '../../shared/awsConsole'
+import { showRegionPrompter } from '../../auth/utils'
+import { openUrl } from '../../shared/utilities/vsCodeUtils'
 
 export function refreshExplorer(node?: Ec2Node) {
     if (node) {
@@ -53,6 +56,12 @@ export async function rebootInstance(node?: Ec2Node) {
     await client.rebootInstanceWithCancel(selection.instanceId)
 }
 
+export async function linkToLaunchInstance(node?: Ec2Node) {
+    const region = node ? node.regionCode : (await showRegionPrompter('Select Region', '')).id
+    const url = getAwsConsoleUrl('ec2-launch', region)
+    await openUrl(url)
+}
+
 async function getSelection(node?: Ec2Node, filter?: instanceFilter): Promise<Ec2Selection> {
     const prompter = new Ec2Prompter(filter)
     const selection = node && node instanceof Ec2InstanceNode ? node.toSelection() : await prompter.promptUser()

packages/core/src/shared/awsConsole.ts

@@ -5,12 +5,16 @@
 
 import * as vscode from 'vscode'
 
-export function getAwsConsoleUrl(service: 'ecr' | 'cloudformation', region: string): vscode.Uri {
+export function getAwsConsoleUrl(service: 'ecr' | 'cloudformation' | 'ec2-launch', region: string): vscode.Uri {
     switch (service) {
         case 'ecr':
             return vscode.Uri.parse(`https://${region}.console.aws.amazon.com/ecr/repositories?region=${region}`)
         case 'cloudformation':
             return vscode.Uri.parse(`https://${region}.console.aws.amazon.com/cloudformation/home?region=${region}`)
+        case 'ec2-launch':
+            return vscode.Uri.parse(
+                `https://${region}.console.aws.amazon.com/ec2/home?region=${region}#LaunchInstances:`
+            )
         default:
             throw Error()
     }

packages/toolkit/.changes/next-release/Feature-ddc43dca-284c-4ab6-8857-e207bcdd9858.json

@@ -0,0 +1,4 @@
+{
+	"type": "Feature",
+	"description": "EC2: Launch ec2 instances from AWS Explorer"
+}