coder · kylecarbs · Mar 31, 2022 · Mar 30, 2022 · Mar 30, 2022 · Mar 30, 2022
diff --git a/examples/README.md b/examples/README.md
@@ -0,0 +1,35 @@
+# Project examples
+
+| Project name                 | OS, Type                      | Features                                                | Status  |
+| ---------------------------- | ----------------------------- | ------------------------------------------------------- | ------- |
+| [gcp-windows](./gcp-windows) | VM, Windows Server 2022       | Regions, instance type                                  | Basic   |
+| [gcp-linux](./gcp-linux)     | VM, Ubuntu 20.04              | Regions, instance type                                  | Basic   |
+| [aws-linux](./aws-linux)     | VM, Ubuntu 20.04              | Regions, instance type                                  | Basic   |
+| [aws-windows](./aws-windows) | VM, Windows Server 2019       | Regions, instance type                                  | Basic   |
+| [aws-macos](./aws-macos)     | Mac Mini, OSX 12 Monterey     | Regions, instance type                                  | WIP     |
+| kubernetes                   | Container/pod spec, any linux | Custom image, registry, provisioning ratio, PVC support | Planned |
+
+## How to use
+
+These are embedded as examples when you run `coder projects init`. Optionally modify the terraform and use `coder projects create` or `coder projects update`, if you have already imported the project.
+
+You can still use projects that are not embedded in your version of Coder:
+
+```sh
+git clone https://github.com/coder/coder
+cd examples/aws-macos
+coder projects create
+```
+
+## Statuses
+
+- Planned
+- WIP
+- Basic (proof of concept)
+- Beta
+- Stable
+- Broken/unsupported
+
+## Requests
+
+Submit [an issue](https://github.com/coder/coder/issues/new) or pull request to request features or more examples.
diff --git a/examples/aws-linux/README.md b/examples/aws-linux/README.md
@@ -0,0 +1,14 @@
+---
+name: Develop in Linux on AWS
+description: Get started with Linux development on AWS (EC2).
+tags: [cloud, aws]
+---
+
+## Supported features
+
+- Persistent storage
+- Start/stop
+
+## User preferences
+
+- Region
diff --git a/examples/aws-linux/main.tf b/examples/aws-linux/main.tf
@@ -0,0 +1,155 @@
+terraform {
+  required_providers {
+    coder = {
+      source = "coder/coder"
+    }
+  }
+}
+
+variable "access_key" {
+  description = <<EOT
+Create an AWS access key to provision resources with Coder:
+- https://console.aws.amazon.com/iam/home#/users
+
+AWS Access Key
+EOT
+  sensitive   = true
+}
+
+variable "secret_key" {
+  description = <<EOT
+AWS Secret Key
+EOT
+  sensitive   = true
+}
+
+variable "region" {
+  description = "What region should your workspace live in?"
+  default     = "us-east-1"
+  validation {
+    condition     = contains(["us-east-1", "us-east-2", "us-west-1", "us-west-2"], var.region)
+    error_message = "Invalid region!"
+  }
+}
+
+variable "disk_size" {
+  description = "Specify your disk size (GiBs)"
+  default     = "20"
+  type        = number
+  validation {
+    condition = (
+      var.disk_size >= 8 &&
+      var.disk_size <= 256
+    )
+    error_message = "Disk size must be between 8 and 256."
+  }
+}
+
+provider "aws" {
+  region     = var.region
+  access_key = var.access_key
+  secret_key = var.secret_key
+}
+
+data "coder_workspace" "me" {
+}
+
+data "coder_agent_script" "dev" {
+  arch = "amd64"
+  auth = "aws-instance-identity"
+  os   = "linux"
+}
+
+# assign a random name for the workspace
+resource "random_string" "random" {
+  length  = 8
+  special = false
+}
+
+data "aws_ami" "ubuntu" {
+  most_recent = true
+  filter {
+    name   = "name"
+    values = ["ubuntu/images/hvm-ssd/ubuntu-focal-20.04-amd64-server-*"]
+  }
+  filter {
+    name   = "virtualization-type"
+    values = ["hvm"]
+  }
+  owners = ["099720109477"] # Canonical
+}
+
+resource "coder_agent" "dev" {
+  count       = data.coder_workspace.me.transition == "start" ? 1 : 0
+  instance_id = aws_instance.dev[0].id
+}
+
+locals {
+
+  # with AWS, we are using user data
+  # to start/stop instances with Terraform
+  # https://github.com/hashicorp/terraform-provider-aws/issues/22
+
+  user_data_start = <<EOT
+Content-Type: multipart/mixed; boundary="//"
+MIME-Version: 1.0
+
+--//
+Content-Type: text/cloud-config; charset="us-ascii"
+MIME-Version: 1.0
+Content-Transfer-Encoding: 7bit
+Content-Disposition: attachment; filename="cloud-config.txt"
+
+#cloud-config
+cloud_final_modules:
+- [scripts-user, always]
+
+--//
+Content-Type: text/x-shellscript; charset="us-ascii"
+MIME-Version: 1.0
+Content-Transfer-Encoding: 7bit
+Content-Disposition: attachment; filename="userdata.txt"
+
+#!/bin/bash
+sudo -E -u ubuntu sh -c '${data.coder_agent_script.dev.value}'
+--//--
+EOT
+
+  user_data_end = <<EOT
+Content-Type: multipart/mixed; boundary="//"
+MIME-Version: 1.0
+
+--//
+Content-Type: text/cloud-config; charset="us-ascii"
+MIME-Version: 1.0
+Content-Transfer-Encoding: 7bit
+Content-Disposition: attachment; filename="cloud-config.txt"
+
+#cloud-config
+cloud_final_modules:
+- [scripts-user, always]
+
+--//
+Content-Type: text/x-shellscript; charset="us-ascii"
+MIME-Version: 1.0
+Content-Transfer-Encoding: 7bit
+Content-Disposition: attachment; filename="userdata.txt"
+
+#!/bin/bash
+sudo shutdown -h now
+--//--
+EOT
+}
+
+resource "aws_instance" "dev" {
+  ami               = data.aws_ami.ubuntu.id
+  availability_zone = "${var.region}a"
+  instance_type     = "t3.micro"
+  count             = 1
+
+  user_data = data.coder_workspace.me.transition == "start" ? local.user_data_start : local.user_data_end
+  tags = {
+    Name = "coder-${lower(random_string.random.result)}"
+  }
+
+}
diff --git a/examples/aws-windows/README.md b/examples/aws-windows/README.md
@@ -0,0 +1,14 @@
+---
+name: Develop in Windows on AWS
+description: Get started with Windows development on AWS (EC2).
+tags: [cloud, aws]
+---
+
+## Supported features
+
+- Persistent storage
+- Start/stop
+
+## User preferences
+
+- Region
diff --git a/examples/aws-windows/main.tf b/examples/aws-windows/main.tf
@@ -0,0 +1,105 @@
+terraform {
+  required_providers {
+    coder = {
+      source = "coder/coder"
+    }
+  }
+}
+
+variable "access_key" {
+  description = <<EOT
+Create an AWS access key to provision resources with Coder:
+- https://console.aws.amazon.com/iam/home#/users
+
+AWS Access Key
+EOT
+  sensitive   = true
+}
+
+variable "secret_key" {
+  description = <<EOT
+AWS Secret Key
+EOT
+  sensitive   = true
+}
+
+variable "region" {
+  description = "What region should your workspace live in?"
+  default     = "us-east-1"
+  validation {
+    condition     = contains(["us-east-1", "us-east-2", "us-west-1", "us-west-2"], var.region)
+    error_message = "Invalid region!"
+  }
+}
+
+provider "aws" {
+  region     = var.region
+  access_key = var.access_key
+  secret_key = var.secret_key
+}
+
+data "coder_workspace" "me" {
+}
+
+data "coder_agent_script" "dev" {
+  arch = "amd64"
+  auth = "aws-instance-identity"
+  os   = "windows"
+}
+
+# assign a random name for the workspace
+resource "random_string" "random" {
+  length  = 8
+  special = false
+}
+
+data "aws_ami" "windows" {
+  most_recent = true
+  owners      = ["amazon"]
+
+  filter {
+    name   = "name"
+    values = ["Windows_Server-2019-English-Full-Base-*"]
+  }
+}
+
+resource "coder_agent" "dev" {
+  count       = data.coder_workspace.me.transition == "start" ? 1 : 0
+  instance_id = aws_instance.dev[0].id
+}
+
+locals {
+
+  # with AWS, we are using user data
+  # to start/stop instances with Terraform
+  # https://github.com/hashicorp/terraform-provider-aws/issues/22
+
+  user_data_start = <<EOT
+<powershell>
+[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
+${data.coder_agent_script.dev.value}
+</powershell>
+<persist>true</persist>
+EOT
+
+  user_data_end = <<EOT
+<powershell>
+shutdown /s
+</powershell>
+<persist>true</persist>
+EOT
+}
+
+resource "aws_instance" "dev" {
+  # count             = data.coder_workspace.me.transition == "start" ? 1 : 0
+  ami               = data.aws_ami.windows.id
+  availability_zone = "${var.region}a"
+  instance_type     = "t3.micro"
+  count             = 1
+
+  user_data = data.coder_workspace.me.transition == "start" ? local.user_data_start : local.user_data_end
+  tags = {
+    Name = "coder-${lower(random_string.random.result)}"
+  }
+
+}