https://github.com/iann0036/vscode-aws-cloudshell

(Unofficial) AWS CloudShell plugin for VS Code
https://github.com/iann0036/vscode-aws-cloudshell

Last synced: 13 days ago
JSON representation

(Unofficial) AWS CloudShell plugin for VS Code

• Host: GitHub
• URL: https://github.com/iann0036/vscode-aws-cloudshell
• Owner: iann0036
• License: mit
• Created: 2020-12-16T05:31:34.000Z (almost 4 years ago)
• Default Branch: main
• Last Pushed: 2024-07-10T22:57:18.000Z (4 months ago)
• Last Synced: 2024-10-10T12:18:49.700Z (about 1 month ago)
• Language: TypeScript
• Homepage:
• Size: 903 KB
• Stars: 54
• Watchers: 11
• Forks: 7
• Open Issues: 9
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# AWS CloudShell plugin for VS Code

[![](https://img.shields.io/badge/-VS%20Code%20Marketplace-brightgreen)](https://marketplace.visualstudio.com/items?itemName=iann0036.aws-cloudshell)

An unofficial AWS CloudShell plugin for VS Code. Open multiple AWS CloudShell terminals within VS Code on demand.

>**Note:** This extension is still in alpha stages. Please [raise an issue](https://github.com/iann0036/vscode-aws-cloudshell/issues) if you experience any problems.

![AWS CloudShell plugin for VS Code Screenshot](https://raw.githubusercontent.com/iann0036/vscode-aws-cloudshell/master/resources/screenshot.png)

## Setup

In order to use this extension, you will need:

* The [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html) installed

* The [Session Manager plugin](https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-working-with-install-plugin.html) installed

* A profile configured that meets the below requirements

Once you have installed the extension, you should go to your VS Code preferences (hit F1 then enter "Preferences: Open Settings (UI)" -> Extensions -> AWS CloudShell Configuration) and specify your `region` and one or both of `profile` and/or `assumeRole`. Once the settings are updated, you may click the sidebar icon and then the "Start Session" (+) button.

Currently, you **MUST** either use a profile with a session token attached to it, or use the `assumeRole` property to assume a role with the [necessary permissions](https://console.aws.amazon.com/iam/home?region=us-east-1#/policies/arn:aws:iam::aws:policy/AWSCloudShellFullAccess$jsonEditor). Alternatives may be provided in a future release.

## Settings

Here is the list of all [settings](https://code.visualstudio.com/docs/getstarted/settings) you can set within this extension:

Setting | Description

------- | -----------

`awscloudshell.profile` | The profile name (usually as specified in `~/.aws/credentials`)

`awscloudshell.region` | The AWS region to connect to

`awscloudshell.assumeRole` | The role ARN to assume

`awscloudshell.enableUpload` | Whether to enable an upload menu item from the Explorer view (experimental)

`awscloudshell.vpcid` | VPC Id (experimental)

`awscloudshell.subnetid` | Subnet Id (experimental)

`awscloudshell.securitygroupid` | Security Group Id (experimental)