Live Sync for AWS Cloud9

Note: This extension is still in alpha stages. Please raise an issue if you experience any problems.

Setup

To start using this extension, you'll need an AWS IAM Key Pair in order to authenticate you. We initally recommend assigning the AWSCloud9Administrator role to your user.

You can enter your key-pair by clicking on the Environments refresh button, or by hitting F1 and entering the Cloud9 Sync: Setup option. This will present the field you need to fill in order to give that workspace access.

Connecting

Once you've entered your credentials, click the refresh button in the Environments view. This should populate all environments to which you have access to. You can connect to your chosen environment by right-clicking on the item and clicking Connect. Connection may take up to a minute to fully complete and will initially synchronize your workspace.

Adding to workspace

If you'd like to have the remote file listing available in your Explorer, you can click Add to Workspace from the Environments view. This will add the file listings as a seperate workspace folder. You can save the workspace to persist the workspace folder in the future.

Note: There is a known issue that makes Visual Studio Code restart when adding the folder. This means that the connection must be re-established when adding the folder to an existing workspace.

Disconnecting

Similarly to connecting, you may disconnect by right-clicking on the connected environment and clicking Disconnect.

Using Remote Terminal

You can right-click on your connected environment and click the Create Terminal option. This will open a new terminal connected to your AWS Cloud9 environment.

If you choose the Create Shared Terminal option, your terminal will be available to other online clients.

Settings

Though most settings will be available to you from the sidebar, here is the list of all settings you can set:

Troubeshooting

User: arn:aws:iam::xxxxxxxxxx:user/xxxxxxx is not authorized to perform: cloud9:CreateEnvironmentToken on resource: xxxxxxxxxxxxxxx with an explicit deny

This error generally indicates the creator of the Cloud9 environment has not shared the environment with the user you're trying to log in as. You should log in to the Cloud9 web interface and share the environment with your Visual Studio Code user.

Cannot resolve workspace folder

This warning can sometimes be shown when you have added an environment to the workspace and presents the new workspace folder in yellow. This can generally be ignored and will go away when the environment completes its connection. If you do see other issues with this behaviour, please raise an issue.

License