Skip to content

Commit 8788dfe

Browse files
authored
docs(ec2): add ec2 connect details to arch_features.md (#5652)
## Problem ## Solution --- <!--- REMINDER: Ensure that your PR meets the guidelines in CONTRIBUTING.md --> License: I confirm that my contribution is made under the terms of the Apache 2.0 license.
1 parent 96d1ca0 commit 8788dfe

File tree

1 file changed

+7
-0
lines changed

1 file changed

+7
-0
lines changed

docs/arch_features.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -39,6 +39,13 @@ For connecting a new VSCode _terminal_, remote connect works like this:
3939
1. Toolkit [builds a session-manager-plugin command](https://github.com/aws/aws-toolkit-vscode/blob/c77fc076fd0ed837d077bc0318716b711a2854c8/packages/core/src/ecs/util.ts#L92-L104) and [passes it to a new VSCode Terminal](https://github.com/aws/aws-toolkit-vscode/blob/c77fc076fd0ed837d077bc0318716b711a2854c8/packages/core/src/ecs/commands.ts#L141-L147).
4040
1. VSCode displays the terminal, so the user can enter shell commands on the remote machine.
4141

42+
For EC2 specifically, there are a few additional steps:
43+
44+
1. If connecting to EC2 instance via remote window, the toolkit generates temporary SSH keys (30 second lifetime), with the public key sent to the remote instance.
45+
- Key type is ed25519 if supported, or RSA otherwise.
46+
1. If insufficient permissions are detected on the attached IAM role, toolkit will prompt to add an inline policy with the necessary actions.
47+
1. If SSM sessions remain open after closing the window/terminal, the toolkit will terminate them on-shutdown, or when starting another session to the same instance.
48+
4249
### Implementation of remote connect
4350

4451
These modules show how to use and extend the "remote connect" functionality:

0 commit comments

Comments
 (0)