Skip to content

Commit 5b98ddc

Browse files
Merge pull request #2 from coder/greg-the-coder-patch-1
Greg the coder patch 1
2 parents 1121f75 + aa31c36 commit 5b98ddc

File tree

93 files changed

+1052
-8447
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

93 files changed

+1052
-8447
lines changed

.gitignore

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,8 @@
22
**/.terraform/*
33

44
# Save .tfstate files for Coder GitOps Use Case
5-
#*.tfstate
6-
#*.tfstate.*
5+
*.tfstate
6+
*.tfstate.*
77

88
# Crash log files
99
crash.log

README.md

Lines changed: 21 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
# partner-demo-gitops
1+
# AWS Coder Workshop GitOps
22

3-
Partner Demo of GitOps flow for Coder Admin
3+
AWS Workshop Demo of GitOps flow for Coder Template Admin
44

55
## Overview
66
A demonstration project showcasing GitOps workflows and best practices for Coder administration. This repo is meant to be used in conjunction with our [Kubernetes Devcontainer template](https://registry.coder.com/templates/kubernetes-devcontainer), which creates a Coder Workspace a Coder Admin can use for deployment and template administration. The [.devcontainer specification](./.devcontainer/) contained in this repo will deploy a Workspace that has terraform, helm, and kubectl utilities provisioned that are commonly used by Platform Engineering teams supporting Coder.
@@ -35,8 +35,25 @@ coder login $CODER_AGENT_URL
3535
./templates_gitops.sh <Coder Session Token>
3636
```
3737

38+
## [Coder Templates](templates/README.md)
39+
Four specialized workspace templates for AWS development:
40+
- **Linux Q Developer**: AI-powered development with Amazon Q Developer CLI
41+
- **Linux SAM**: Serverless development with AWS SAM CLI on ARM64
42+
- **Windows DCV**: Windows development with NICE DCV remote desktop
43+
- **Kubernetes with Claude Code**: Cloud-native development with AI task automation
44+
45+
## Workshop Content
46+
47+
### 📚 [AI-Driven Development Workflows](workshop/README.md)
48+
Workshop content from the AWS Modernization with Coder workshop, featuring:
49+
- AI-powered development with Amazon Q Developer and Claude Code
50+
- Hands-on exercises for AI-assisted feature development
51+
- Task automation workflows and best practices
52+
3853
## Features
3954
- Demonstrates Coder Kubernetes Devcontainer Workspaces for Platform Engineering
40-
- Implements basic GitOps workflow for Coder Template adminstration using Coder CLI, Terraform, and Git for template change management
41-
- Other template source available at the [Coder Template Registry](https://registry.coder.com/templates)
55+
- Implements basic GitOps workflow for Coder Template administration using Coder CLI, Terraform, and Git for template change management
56+
- Includes comprehensive workshop content for AI-driven development workflows
57+
- Provides specialized templates for various AWS development scenarios
58+
- Other template sources available at the [Coder Template Registry](https://registry.coder.com/templates)
4259

templates/README.md

Lines changed: 109 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,109 @@
1+
# AWS Coder Workshop Templates
2+
3+
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.
4+
5+
## Template Overview
6+
7+
### 🐧 [AWS Workshop - EC2 (Linux) Q Developer](awshp-linux-q-base/)
8+
**Purpose**: AI-powered development with Amazon Q Developer
9+
**Architecture**: Ubuntu 20.04 on x86_64 EC2 instances
10+
**Key Tools**: Amazon Q Developer CLI, AWS CLI v2, AWS CDK, Node.js 20 LTS
11+
**Best For**: AI-assisted development, infrastructure as code, general AWS development
12+
13+
### 🚀 [AWS Workshop - EC2 (Linux) SAM](awshp-linux-sam/)
14+
**Purpose**: Serverless application development
15+
**Architecture**: Ubuntu ARM64 on Graviton EC2 instances
16+
**Key Tools**: AWS SAM CLI, AWS CLI v2, Python 3, Amazon Q Developer extension
17+
**Best For**: Lambda functions, serverless APIs, cost-effective ARM64 development
18+
19+
### 🪟 [AWS Workshop - EC2 (Windows) DCV](awshp-windows-dcv/)
20+
**Purpose**: Windows development with remote desktop
21+
**Architecture**: Windows Server 2022 on x86_64 EC2 instances
22+
**Key Tools**: NICE DCV, VS Code, PowerShell, Windows development stack
23+
**Best For**: Windows-specific development, GUI applications, .NET development
24+
25+
### ☸️ [Kubernetes with Claude Code](awshp-k8s-with-claude-code/)
26+
**Purpose**: Container development with AI task automation
27+
**Architecture**: Kubernetes pods with persistent volumes
28+
**Key Tools**: Claude Code AI assistant, VS Code, Cursor, container tools
29+
**Best For**: Microservices, container orchestration, AI-driven task automation
30+
31+
## Template Comparison
32+
33+
| Feature | Linux Q Developer | Linux SAM | Windows DCV | K8s Claude Code |
34+
|---------|------------------|-----------|-------------|-----------------|
35+
| **Platform** | Ubuntu x86_64 | Ubuntu ARM64 | Windows Server | Kubernetes |
36+
| **AI Assistant** | Q Developer CLI | Q Developer Extension | - | Claude Code |
37+
| **Primary Use** | General AWS Dev | Serverless | Windows Dev | Container Dev |
38+
| **Cost Efficiency** | Standard | High (ARM64) | Higher | Variable |
39+
| **Persistence** | Full VM | Full VM | Full VM | Home directory |
40+
| **Startup Time** | ~2-3 min | ~2-3 min | ~5-10 min | ~30-60 sec |
41+
42+
## Getting Started
43+
44+
### Prerequisites
45+
- Coder deployment with AWS provider configured
46+
- AWS account with appropriate IAM permissions
47+
- For Kubernetes template: Existing Kubernetes cluster
48+
49+
### Template Selection Guide
50+
51+
**Choose Linux Q Developer if you want:**
52+
- AI-powered development assistance
53+
- Infrastructure as Code with CDK
54+
- General-purpose AWS development
55+
- x86_64 compatibility requirements
56+
57+
**Choose Linux SAM if you want:**
58+
- Serverless application development
59+
- Cost-effective ARM64 instances
60+
- Lambda function development
61+
- Local serverless testing
62+
63+
**Choose Windows DCV if you want:**
64+
- Windows-specific development
65+
- GUI application development
66+
- .NET or Windows-only tools
67+
- Remote desktop experience
68+
69+
**Choose Kubernetes Claude Code if you want:**
70+
- Container-based development
71+
- AI task automation
72+
- Microservices architecture
73+
- Fast workspace startup times
74+
75+
## Configuration
76+
77+
### IAM Instance Profile
78+
Most templates require an IAM instance profile for AWS service access. Configure the `aws_iam_profile` variable when deploying templates.
79+
80+
### Regional Deployment
81+
All templates support multi-region deployment with region-specific optimizations:
82+
- **Linux Q Developer**: 10 regions globally
83+
- **Linux SAM**: 4 US regions (ARM64 availability)
84+
- **Windows DCV**: 15 regions globally
85+
- **Kubernetes**: Depends on cluster location
86+
87+
### Resource Sizing
88+
Each template offers configurable resource options:
89+
- **CPU**: 1-4 vCPUs depending on template
90+
- **Memory**: 1-16 GiB RAM options
91+
- **Storage**: 10-300 GB persistent volumes
92+
93+
## Workshop Integration
94+
95+
These templates are designed for the AWS Modernization with Coder workshop and include:
96+
- Pre-configured development environments
97+
- Workshop-specific tooling and dependencies
98+
- Optimized resource configurations
99+
- Integration with workshop exercises
100+
101+
## Support and Customization
102+
103+
Each template is designed as a starting point and can be customized for specific use cases:
104+
- Modify Terraform configurations for additional AWS services
105+
- Extend startup scripts for custom tool installation
106+
- Adjust resource parameters for performance requirements
107+
- Add custom applications and integrations
108+
109+
> **Note**: These templates are designed for workshop and development use. For production deployments, review and adjust security configurations, resource limits, and access controls according to your organization's requirements.

templates/aws-devcontainer-br/README.md

Lines changed: 0 additions & 110 deletions
This file was deleted.

templates/aws-devcontainer-br/architecture.svg

Lines changed: 0 additions & 8 deletions
This file was deleted.

templates/aws-devcontainer-br/cloud-init/cloud-config.yaml.tftpl

Lines changed: 0 additions & 15 deletions
This file was deleted.

templates/aws-devcontainer-br/cloud-init/userdata.sh.tftpl

Lines changed: 0 additions & 37 deletions
This file was deleted.

0 commit comments

Comments
 (0)