Setting Up VS Code Server (Self-Paced)

This guide will help you access your VS Code server environment when running the workshop independently.

Prerequisites

  • AWS Account with administrative access
  • Successfully deployed vscode-server CloudFormation stack
  • Modern web browser (Chrome, Firefox, or Edge recommended)

Accessing Your VS Code Environment

Step 1: Locate CloudFormation Outputs

  1. Open the AWS Management Console
  2. Navigate to CloudFormation service
  3. Select your vscode-server stack
  4. Click the Outputs tab
  5. Locate two key pieces of information:
    • VSCODEURL: Your VS Code server endpoint
    • Password: Your authentication credentials

CloudFormation Outputs Location

Step 2: Configure Access

  1. Copy the Password from CloudFormation Outputs
  2. Click the VSCODEURL value to open VS Code in a new tab
  3. When prompted, paste your password
  4. Select Login to access your environment

VS Code Login Screen

Step 3: Verify Your Environment

After logging in, confirm:

  • File explorer is visible on the left
  • Editor area is accessible in the center
  • Terminal can be opened (Ctrl + `)
  • Git integration is working
  • AWS credentials are configured properly

VS Code Interface

Security Considerations

  • Your VS Code server is protected by CloudFront
  • Access is limited to your IP address
  • Session cookies are encrypted
  • All traffic is SSL/TLS encrypted
  • Environment is isolated in your AWS account

Troubleshooting Guide

Common Issues and Solutions

  1. Cannot Access URL

    • Verify CloudFormation stack deployed successfully
    • Check if CloudFront distribution is deployed
    • Ensure your IP is allowed in security groups
  2. Authentication Failed

    • Double-check password from CloudFormation outputs
    • Clear browser cache and cookies
    • Try incognito/private browsing mode
  3. Performance Issues

    • Check your internet connection
    • Verify instance type matches requirements
    • Monitor EC2 resource utilization
  4. AWS Credential Issues

    • Verify IAM roles are properly configured
    • Check AWS CLI configuration
    • Ensure temporary credentials haven’t expired

Next Steps

✅ Verify you can access the VS Code server
✅ Test the terminal functionality
✅ Proceed to “Create a Docker Account” (skip if you already have one)
✅ Continue to the CI/CD overview section

Additional Resources

Cost Considerations

  • EC2 instance running costs
  • CloudFront distribution charges
  • Data transfer fees
  • Storage costs for EBS volumes

Getting Help

If you encounter issues:

  1. Check the troubleshooting guide above
  2. Review CloudWatch logs
  3. Consult AWS documentation
  4. Reach out to AWS Support if needed

Step 3: Verify Your Environment

After logging in, confirm:

  • File explorer is visible on the left
  • Editor area is accessible in the center
  • Terminal can be opened (Ctrl + `)
  • Git integration is working
  • AWS credentials are configured properly

VS Code Interface

Security Considerations

  • Your VS Code server is protected by CloudFront
  • Access is limited to your IP address
  • Session cookies are encrypted
  • All traffic is SSL/TLS encrypted
  • Environment is isolated in your AWS account

Troubleshooting Guide

Common Issues and Solutions

  1. Cannot Access URL

    • Verify CloudFormation stack deployed successfully
    • Check if CloudFront distribution is deployed
    • Ensure your IP is allowed in security groups
  2. Authentication Failed

    • Double-check password from CloudFormation outputs
    • Clear browser cache and cookies
    • Try incognito/private browsing mode
  3. Performance Issues

    • Check your internet connection
    • Verify instance type matches requirements
    • Monitor EC2 resource utilization
  4. AWS Credential Issues

    • Verify IAM roles are properly configured
    • Check AWS CLI configuration
    • Ensure temporary credentials haven’t expired

Next Steps

✅ Verify you can access the VS Code server
✅ Test the terminal functionality
✅ Proceed to “Create a Docker Account” (skip if you already have one)
✅ Continue to the CI/CD overview section

Additional Resources

Cost Considerations

  • EC2 instance running costs
  • CloudFront distribution charges
  • Data transfer fees
  • Storage costs for EBS volumes

Getting Help

If you encounter issues:

  1. Check the troubleshooting guide above
  2. Review CloudWatch logs
  3. Consult AWS documentation
  4. Reach out to AWS Support if needed