How to get VSCode Cloud IDE on AWS

This section describes how to launch and connect to VSCode Cloud IDE in Amazon Web Services (AWS) with auto-generated(random) password. If you want to launch VSCode cloud IDE with User Provided Password go to - Launch VSCode Cloud IDE with User Provided Password

Note: Password once created Can Not be changed in either way of launching VM.

1. Open VSCode Cloud IDE VM listing on AWS marketplace

2. Click on Continue to subscribe.

• Login with your credentials and follow the instruction.
• Note: After login, it will take you to the default annual contract page. If you do not want to provision the solution with annual contract then please skip this page by not selecting any values from the dropdown menus as shown below.
• Make sure the Total contract price is $0 and then Click on Continue to configuration button on top right corner.
• Next page will show you the details about hourly, monthly and annual pricing. If you don’t configure the annual contract, the instance get provisioned on hourly basis.
• Select a Region where you want to launch the VM(such as US East (N.Virginia))

• Click on Continue to Launch Button.
• Choose Action: You can launch it through EC2 or from Website.(Let’s choose Launch from website)

• Optionally change the EC2 instance type. (This defaults to t2.small instance type, 1 vCPUs and 2 GB RAM.)
• Optionally change the network name and subnetwork names.

• Select the Security Group. Be sure that whichever Security Group you specify have ports 22 (for ssh), 3389 (for RDP) and 443 (for HTTPS) exposed.

• Be sure to download the key-pair which is available by default, or you can create the new key-pair and download it.

• Click on Launch..

• VSCode Cloud IDE will begin deploying.

  3. A summary page displays.To see this instance on EC2 Console click on EC2 Console link.

4. On the EC2 Console page, instance is up and running. To connect to this instance through putty, copy the IPv4 Public IP Address

5. Open putty, paste the IP address and browse your private key you downloaded while deploying the VM, by going to **SSH- >Auth **, click on Open. Enter ubuntu as userid

6. Once connected, change the password for ubuntu user using below command

sudo passwd ubuntu

7. Now the password for ubuntu user is set, you can connect to the VM’s desktop environment from any local Windows Machine using RDP protocol or Linux Machine using Remmina.

From your local windows machine, goto “start” menu, in the search box type and select “Remote desktop connection”. In the “Remote Desktop connection” wizard, copy the public IP address and click connect

8. This will connect you to the VM’s desktop environment. Provide the username (e.g “ubuntu”) and the password set in the above “Reset password” step to authenticate. Click OK

9. Now you are connected to the out of box VSCode Cloud IDE environment via Windows Machine.

10. To connect using RDP via Linux machine, first note the external IP of the VM from VM details page,then from your local Linux machine, goto menu, in the search box type and select “Remmina”.

Note: If you don’t have Remmina installed on your Linux machine, firstInstall Remmina as per your linux distribution.

11. In the “Remmina Remote Desktop Client” wizard, select the RDP option from dropdown and paste the external ip and click enter.

12. This will connect you to the VM’s desktop environment. Provide “ubuntu” as the userid and the password set in above reset password step to authenticate. Click OK

13. Now you are connected to out of box VSCode Cloud IDE environment via Linux machine.

14. For accessing VSCode in browser, SSH to the VM as shown in Step 4 and run below command -

cat /home/ubuntu/vscode_pass.txt

Note down auto-generated password.

Note: If the password is empty in the file, wait for 2 minutes and check again.

15. Go to https://VM_Public_IP. Make sure you type https and not http.

16. You will see certificate warning, accept the warning to proceed for login

17. Use above auto-generated password from Step 14

Note: If you happen to see a blank screen in the browser after login or page load error, wait for 1-2 minutes and open again in new browser window to see VSCode load.

Launch VSCode Cloud IDE with User Provided Password

1. Open VSCode Cloud IDE VM listing on AWS marketplace

2. Click on Continue to subscribe.

• Login with your credentials and follow the instruction.click on Continue to configuration
• Select a Region where you want to launch the VM(such as US East (N.Virginia))

• Choose Action: you can launch it through EC2 or from Website.Select Launch through EC2

• Select instance type as t2.small

• On Step 3: Configure Instance Details page go down to Advanced Details– >User data and enter vscode-password=yourpasswordhere

• Go with the default setting for Storage

• Select or Create Security Group.Whatever Security Group you select should have port 22 (for SSH), port 3389 (for RDP) and port 443 (for HTTPS) exposed.

• Click on Review and Launch and on next page Launch.
  It will ask you for Key-Pair.Provide your Key-Pair here. If you don’t have Key-Pair, select Create new key-pair from drop-down and download this key.
  Once key-pair is downloaded, Click on Launch Instance.

3. Once the vm is up and running, you can access Visual Studio Code by going to https://VM_Public_IP

• Make sure you type https and not http. 4. You will see certificate warning, accept the warning to proceed for login

  5. Use above password you provided in User data during VM configuration in Step 2

Note: If you happen to see a blank screen in the browser after login or page load error, wait for 1-2 minutes and open again in new browser window to see VSCode load.

18. We recommend to reserve the VSCode public ip address and make it static in order to access VSCode in browser over the same IP after VM restart.
    Having static IP will also allow the browser to save VSCode password across sessions and user will not have to enter password each time VSCode is opened in browser.

• Below are the steps for reserving public IP and making it static:
• Note down the Availability Zone of vscode cloud ide instance.

• In the left pane of EC2 go to Network & Security and select Elastic IPs option.

• On Elastic IPs page click on Allocate Elastic IP Address

• Select the Network Border Group as per the availability zone of the instance. Select Amazon’s pool of IPv4 addresses radio button and click on allocate.

• Once the Elastic IP is allocated, select the Elastic IP and under Actions dropdown select Associate Elastic IP address.

• On this page select the instance radio button,enter Instance id, Private IP Adress of the VM and click Associate.

• Now go to the instance details page and navigate to Networking tab. Here you can see Elastic IP is associated to the instance.