This directory contains Coder workspace templates designed for AWS development workflows and workshop scenarios. Each template provides a specialized development environment with pre-configured tools and services.

**Purpose**: AI-powered development with Amazon Q Developer

**Architecture**: Ubuntu 20.04 on x86_64 EC2 instances

**Key Tools**: Amazon Q Developer CLI, AWS CLI v2, AWS CDK, Node.js 20 LTS

**Best For**: AI-assisted development, infrastructure as code, general AWS development

**Purpose**: Serverless application development

**Architecture**: Ubuntu ARM64 on Graviton EC2 instances

**Key Tools**: AWS SAM CLI, AWS CLI v2, Python 3, Amazon Q Developer extension

**Best For**: Lambda functions, serverless APIs, cost-effective ARM64 development

**Purpose**: Windows development with remote desktop

**Architecture**: Windows Server 2022 on x86_64 EC2 instances

**Key Tools**: NICE DCV, VS Code, PowerShell, Windows development stack

**Best For**: Windows-specific development, GUI applications, .NET development

**Purpose**: Container development with AI task automation

**Architecture**: Kubernetes pods with persistent volumes

**Key Tools**: Claude Code AI assistant, VS Code, Cursor, container tools

**Best For**: Microservices, container orchestration, AI-driven task automation

| Feature | Linux Q Developer | Linux SAM | Windows DCV | K8s Claude Code |

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

| **Platform** | Ubuntu x86_64 | Ubuntu ARM64 | Windows Server | Kubernetes |

| **AI Assistant** | Q Developer CLI | Q Developer Extension | - | Claude Code |

| **Primary Use** | General AWS Dev | Serverless | Windows Dev | Container Dev |

| **Cost Efficiency** | Standard | High (ARM64) | Higher | Variable |

| **Persistence** | Full VM | Full VM | Full VM | Home directory |

| **Startup Time** | ~2-3 min | ~2-3 min | ~5-10 min | ~30-60 sec |

- Coder deployment with AWS provider configured

- AWS account with appropriate IAM permissions

- For Kubernetes template: Existing Kubernetes cluster

**Choose Linux Q Developer if you want:**

- AI-powered development assistance

- Infrastructure as Code with CDK

- General-purpose AWS development

- x86_64 compatibility requirements

**Choose Linux SAM if you want:**

- Serverless application development

- Cost-effective ARM64 instances

- Lambda function development

- Local serverless testing

**Choose Windows DCV if you want:**

- Windows-specific development

- GUI application development

- .NET or Windows-only tools

- Remote desktop experience

**Choose Kubernetes Claude Code if you want:**

- Container-based development

- AI task automation

- Microservices architecture

- Fast workspace startup times

Most templates require an IAM instance profile for AWS service access. Configure the `aws_iam_profile` variable when deploying templates.

All templates support multi-region deployment with region-specific optimizations:

- **Linux Q Developer**: 10 regions globally

- **Linux SAM**: 4 US regions (ARM64 availability)

- **Windows DCV**: 15 regions globally

- **Kubernetes**: Depends on cluster location

Each template offers configurable resource options:

- **CPU**: 1-4 vCPUs depending on template

- **Memory**: 1-16 GiB RAM options

- **Storage**: 10-300 GB persistent volumes

These templates are designed for the AWS Modernization with Coder workshop and include:

- Pre-configured development environments

- Workshop-specific tooling and dependencies

- Optimized resource configurations

- Integration with workshop exercises

Each template is designed as a starting point and can be customized for specific use cases:

- Modify Terraform configurations for additional AWS services

- Extend startup scripts for custom tool installation

- Adjust resource parameters for performance requirements

- Add custom applications and integrations

display_name: AWS Workshop - EC2 (Linux) Q Developer

description: Provision AWS EC2 VMs with Amazon Q Developer CLI and AWS development tools as Coder workspaces

tags: [vm, linux, aws, persistent-vm, q-developer, aws-cli, cdk]

Provision AWS EC2 VMs with integrated Amazon Q Developer CLI, AWS CLI, and AWS CDK as [Coder workspaces](https://coder.com/docs/workspaces) with this workshop template.

**AWS Account**: This template requires an AWS account with appropriate permissions for EC2 instance management

**IAM Instance Profile**: This template uses a configurable IAM instance profile for AWS service access

This template authenticates to AWS using the provider's default [authentication methods](https://registry.terraform.io/providers/hashicorp/aws/latest/docs#authentication-and-configuration).

This template includes Amazon Q Developer CLI integration that provides:

- AI-powered code generation and assistance

- Natural language to code conversion

- AWS service integration and best practices

- Interactive development workflows

- AWS EC2 Instance (Ubuntu 20.04 LTS)

- IAM instance profile for AWS service access

- Cloud-init configuration for automated setup

- Persistent EBS root volume

Coder uses `aws_ec2_instance_state` to start and stop the VM. This template is fully persistent, meaning the full filesystem is preserved when the workspace restarts.

- **VS Code Web**: Access VS Code through the browser via code-server

- **Amazon Q Developer CLI**: AI-powered development assistance

- **AWS CLI**: Pre-installed and configured AWS command line interface

- **AWS CDK**: Cloud Development Kit with Node.js runtime

- **Multi-Region Support**: Deploy in various AWS regions

- **Configurable Resources**: Choose instance type and disk size

- **Real-time Monitoring**: CPU, memory, and disk usage metrics

- **Region**: AWS region for deployment (10 regions available)

- **Instance Type**: EC2 instance type (t3.micro to t3.large)

- **Root Volume Size**: EBS root volume size in GB (minimum 1 GB, expandable)

- **AWS IAM Profile**: IAM instance profile for AWS service access

`code-server` is installed via the Coder registry module and provides VS Code access through the browser.

The Q Developer CLI is automatically installed and provides:

- Interactive chat sessions for development assistance

- Code generation and explanation capabilities

- AWS service integration guidance

- **AWS CLI v2**: Latest version with full AWS service support

- **AWS CDK**: Infrastructure as Code with TypeScript/JavaScript

- **Node.js 20 LTS**: Runtime for CDK and modern JavaScript development

1. Create a workspace using this template

2. Access VS Code through the Coder dashboard

3. Initialize Q Developer CLI with `q login`

4. Start developing with AI assistance using `q chat`

display_name: AWS Workshop - EC2 (Linux) SAM

description: Provision AWS EC2 VMs with AWS SAM CLI and serverless development tools as Coder workspaces

tags: [vm, linux, aws, persistent-vm, sam, serverless, lambda]

Provision AWS EC2 VMs with integrated AWS SAM CLI, AWS CLI, and Amazon Q Developer for serverless development as [Coder workspaces](https://coder.com/docs/workspaces) with this workshop template.

**AWS Account**: This template requires an AWS account with appropriate permissions for EC2 and serverless service management

**IAM Instance Profile**: This template uses a configurable IAM instance profile for AWS service access

**Amazon Machine Image**: This template uses Ubuntu ARM64 AMI optimized for ARM-based EC2 instances

This template authenticates to AWS using the provider's default [authentication methods](https://registry.terraform.io/providers/hashicorp/aws/latest/docs#authentication-and-configuration).

This template includes AWS SAM CLI integration that provides:

- Serverless application development and testing

- Local Lambda function execution

- API Gateway local development

- CloudFormation template management

- AWS EC2 Instance (Ubuntu ARM64)

- IAM instance profile for AWS service access

- Persistent EBS root volume

- ARM64-optimized development environment

Coder uses `aws_ec2_instance_state` to start and stop the VM. This template is fully persistent, meaning the full filesystem is preserved when the workspace restarts.

- **VS Code Web**: Access VS Code through the browser with Amazon Q Developer extension

- **AWS SAM CLI**: Serverless Application Model for Lambda development

- **AWS CLI**: Pre-installed ARM64 version for full AWS service support

- **Python 3**: Runtime environment for Lambda functions

- **ARM64 Optimization**: Graviton-based instances for cost-effective performance

- **Real-time Monitoring**: CPU, memory, and disk usage metrics

- **Region**: AWS region for deployment (4 US regions available)

- **Instance Type**: ARM64 EC2 instance type (m7g.medium or m7g.large)

- **Disk Size**: EBS root volume size (10, 20, or 40 GB options)

- **AWS IAM Profile**: IAM instance profile for AWS service access

`code-server` is installed directly and provides VS Code access through the browser on port 13337 with Amazon Q Developer extension pre-installed.

The SAM CLI is automatically installed and provides:

- `sam init` for creating new serverless applications

- `sam build` for building serverless applications

- `sam local start-api` for local API Gateway testing

- `sam deploy` for deploying to AWS

- **AWS CLI v2**: ARM64-optimized version with full AWS service support

- **Python 3**: Runtime for Lambda function development

- **pip**: Package manager for Python dependencies

1. Create a workspace using this template

2. Access VS Code through the Coder dashboard

3. Initialize a new SAM application with `sam init`

4. Develop and test Lambda functions locally

5. Deploy to AWS with `sam deploy`