https://github.com/coder/aws-workshop-samples
Sample Coder CLI Scripts and Templates to aid in the delivery of AWS Workshops and Immersion Days
https://github.com/coder/aws-workshop-samples
Last synced: 18 days ago
JSON representation
Sample Coder CLI Scripts and Templates to aid in the delivery of AWS Workshops and Immersion Days
- Host: GitHub
- URL: https://github.com/coder/aws-workshop-samples
- Owner: coder
- License: mit
- Created: 2025-02-10T19:50:52.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-10-17T20:52:01.000Z (4 months ago)
- Last Synced: 2025-12-26T12:55:11.274Z (about 2 months ago)
- Language: Shell
- Size: 73.2 KB
- Stars: 2
- Watchers: 0
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# aws-workshop-samples
This project is designed to help you quickly spin up Cloud Development Environments for Demos, Labs, Workshops, Hackathons, or simple POC's in AWS using [Coder](https://coder.com/cde). These templates and basic Coder admin scripts can be used in any Coder deployment, but are focused on using either the [Coder AWS Marketplace](https://coder.com/docs/install/cloud/ec2) AWS EC2 single VM deployment or an AWS EKS deployment.
## Deployment Options
### Option 1: AWS EC2 Single VM Deployment
1) Follow the steps in the [AWS EC2 Installation Guide](https://coder.com/docs/install/cloud/ec2). Complete the optional step to provide Developers EC2 Workspaces, as the AWS Specific templates provided rely on this capability.
2) Login using the provided public IP, and setup your first Coder user.
3) After successfully logging in, clone this Github repo locally so that the provided AWS Workshop Admin template can be uploaded.
### Option 2: AWS EKS Deployment
This guide walks you through deploying Coder on AWS EKS for workshops or demonstrations.
#### Prerequisites
- AWS Account with appropriate permissions
- Latest versions of the following CLI tools installed:
- AWS CLI
- eksctl
- kubectl
- helm
#### Step 1: Create an EKS Cluster
```bash
# Create EKS Cluster (customize the cluster name and region as needed)
eksctl create cluster --name=your-cluster-name --enable-auto-mode --region your-region
```
#### Step 2: Configure Storage for the Cluster
```bash
# Deploy a K8S StorageClass for dynamic EBS volume provisioning
kubectl apply -f - <
```
#### Step 5: Update Coder Configuration
```bash
# Update the coder-core-values-v2.yaml file with your specific configuration:
# - Update CODER_ACCESS_URL with your actual domain or load balancer URL
# - Update CODER_WILDCARD_ACCESS_URL with your wildcard domain
# - Update CODER_OIDC_ISSUER_URL with your Cognito User Pool URL
# - Update any other settings as needed
# Apply the updated configuration
helm upgrade coder coder-v2/coder \
--namespace coder \
--values coder-core-values-v2.yaml \
--version
```
#### Step 6: Configure IAM for EC2 Workspace Support
```bash
# Create IAM Role & Trust Relationship for EC2 Workspace Support
# First, make sure you have the ekspodid-trust-policy.json file in your current directory
aws iam create-role --role-name your-coder-ec2-workspace-role --assume-role-policy-document file://ekspodid-trust-policy.json
# Attach necessary policies to the role
aws iam attach-role-policy \
--role-name your-coder-ec2-workspace-role \
--policy-arn arn:aws:iam::aws:policy/AmazonEC2FullAccess
aws iam attach-role-policy \
--role-name your-coder-ec2-workspace-role \
--policy-arn arn:aws:iam::aws:policy/IAMReadOnlyAccess
# Add IAM Pod Identity association for EC2 Workspace support
aws eks create-pod-identity-association \
--cluster-name your-cluster-name \
--namespace coder \
--service-account coder \
--role-arn arn:aws:iam::your-aws-account-id:role/your-coder-ec2-workspace-role
```
#### Step 7: Access Your Coder Deployment
After completing the setup, you can access your Coder deployment using the Load Balancer URL provided by the Kubernetes service. For production use, it's recommended to:
1. Set up a CloudFront distribution in front of the Kubernetes Load Balancer to support HTTPS/SSL connections
2. Configure a custom domain name pointing to your CloudFront distribution
3. Update the Coder configuration with your custom domain
## Additional Configuration
### Customizing the Coder Deployment
The `coder-core-values-v2.yaml` file in the [coder-admin](./coder-admin) directory contains various configuration options for your Coder deployment, including:
- Access URLs and wildcard domains
- Authentication settings (password, OIDC)
- Resource limits and requests
- Service configurations
- High availability settings
Review and modify this file to match your specific requirements before deploying or upgrading Coder.
### Template Management
After accessing your Coder Deployment and setting up your Coder Admin account, tryout the [GitOps Demo](https://github.com/greg-the-coder/partner-demo-gitops) to review the different Coder CDE capabilities and test out a basic GitOps template management flow.