diff --git a/examples/templates/do-linux/README.md b/examples/templates/do-linux/README.md
new file mode 100644
index 0000000000000..398b18501ba63
--- /dev/null
+++ b/examples/templates/do-linux/README.md
@@ -0,0 +1,17 @@
+---
+name: Develop in Linux on a Digital Ocean Droplet
+description: Get started with Linux development on a Digital Ocean Droplet.
+tags: [cloud, digitalocean]
+---
+
+# do-linux
+
+This is an example for deploying workspaces as Digital Ocean Droplets.
+
+## Requirements
+
+- Digital Ocean Personal Access Token (PAT)
+- Digital Ocean Project ID (e.g. `doctl projects list`)
+ - Remove `variable "step2_do_project_id"` and `resource "digitalocean_project_resources" "project"` if you don't want project association.
+- (Optional) Digital Ocean SSH key ID (e.g. `doctl compute ssh-key list`)
+ - Only required for Fedora images to work.
diff --git a/examples/templates/do-linux/cloud-config.yaml.tftpl b/examples/templates/do-linux/cloud-config.yaml.tftpl
new file mode 100644
index 0000000000000..a2400b5461f33
--- /dev/null
+++ b/examples/templates/do-linux/cloud-config.yaml.tftpl
@@ -0,0 +1,46 @@
+#cloud-config
+users:
+ - name: ${username}
+ sudo: ["ALL=(ALL) NOPASSWD:ALL"]
+ groups: sudo
+ shell: /bin/bash
+packages:
+ - git
+mounts:
+ - [
+ "LABEL=${home_volume_label}",
+ "/home/${username}",
+ auto,
+ "defaults,uid=1000,gid=1000",
+ ]
+write_files:
+ - path: /opt/coder/init
+ permissions: "0755"
+ encoding: b64
+ content: ${init_script}
+ - path: /etc/systemd/system/coder-agent.service
+ permissions: "0644"
+ content: |
+ [Unit]
+ Description=Coder Agent
+ After=network-online.target
+ Wants=network-online.target
+
+ [Service]
+ User=${username}
+ ExecStart=/opt/coder/init
+ Environment=CODER_AGENT_TOKEN=${coder_agent_token}
+ Restart=always
+ RestartSec=10
+ TimeoutStopSec=90
+ KillMode=process
+
+ OOMScoreAdjust=-900
+ SyslogIdentifier=coder-agent
+
+ [Install]
+ WantedBy=multi-user.target
+runcmd:
+ - chown ${username}:${username} /home/${username}
+ - systemctl enable coder-agent
+ - systemctl start coder-agent
diff --git a/examples/templates/do-linux/main.tf b/examples/templates/do-linux/main.tf
new file mode 100644
index 0000000000000..e9d611dddcde8
--- /dev/null
+++ b/examples/templates/do-linux/main.tf
@@ -0,0 +1,146 @@
+terraform {
+ required_providers {
+ coder = {
+ source = "coder/coder"
+ version = "0.4.1"
+ }
+ digitalocean = {
+ source = "digitalocean/digitalocean"
+ version = "~> 2.0"
+ }
+ }
+}
+
+variable "step1_do_token" {
+ type = string
+ description = "Enter token (see documentation at https://docs.digitalocean.com/reference/api/create-personal-access-token/)"
+ sensitive = true
+
+ validation {
+ condition = length(var.step1_do_token) == 71 && substr(var.step1_do_token, 0, 4) == "dop_"
+ error_message = "Invalid Digital Ocean Personal Access Token."
+ }
+}
+
+variable "step2_do_project_id" {
+ type = string
+ description = <<-EOF
+ Enter project ID
+
+ $ doctl projects list
+ EOF
+ sensitive = true
+
+ validation {
+ condition = length(var.step2_do_project_id) == 36
+ error_message = "Invalid Digital Ocean Project ID."
+ }
+}
+
+variable "step3_do_admin_ssh_key" {
+ type = number
+ description = <<-EOF
+ Enter admin SSH key ID (some Droplet images require an SSH key to be set):
+
+ Can be set to zero.
+
+ Note: Setting this to zero will break Fedora images and notify root passwords via email.
+
+ $ doctl compute ssh-key list
+ EOF
+ sensitive = true
+
+ validation {
+ condition = var.step3_do_admin_ssh_key >= 0
+ error_message = "Invalid Digital Ocean SSH key ID, a number is required."
+ }
+}
+
+variable "droplet_image" {
+ type = string
+ description = "Which Droplet image would you like to use for your workspace?"
+ default = "ubuntu-22-04-x64"
+ validation {
+ condition = contains(["ubuntu-22-04-x64", "ubuntu-20-04-x64", "fedora-36-x64", "fedora-35-x64", "debian-11-x64", "debian-10-x64", "centos-stream-9-x64", "centos-stream-8-x64", "rockylinux-8-x64", "rockylinux-8-4-x64"], var.droplet_image)
+ error_message = "Value must be ubuntu-22-04-x64, ubuntu-20-04-x64, fedora-36-x64, fedora-35-x64, debian-11-x64, debian-10-x64, centos-stream-9-x64, centos-stream-8-x64, rockylinux-8-x64 or rockylinux-8-4-x64."
+ }
+}
+
+variable "droplet_size" {
+ type = string
+ description = "Which Droplet configuration would you like to use?"
+ default = "s-1vcpu-1gb"
+ validation {
+ condition = contains(["s-1vcpu-1gb", "s-1vcpu-2gb", "s-2vcpu-2gb", "s-2vcpu-4gb", "s-4vcpu-8gb", "s-8vcpu-16gb"], var.droplet_size)
+ error_message = "Value must be s-1vcpu-1gb, s-1vcpu-2gb, s-2vcpu-2gb, s-2vcpu-4gb, s-4vcpu-8gb or s-8vcpu-16gb."
+ }
+}
+
+variable "home_volume_size" {
+ type = number
+ description = "How large would you like your home volume to be (in GB)?"
+ default = 20
+ validation {
+ condition = var.home_volume_size >= 1
+ error_message = "Value must be greater than or equal to 1."
+ }
+}
+
+variable "region" {
+ type = string
+ description = "Which region would you like to use?"
+ default = "ams3"
+ validation {
+ condition = contains(["nyc1", "nyc2", "nyc3", "sfo1", "sfo2", "sfo3", "ams2", "ams3", "sgp1", "lon1", "fra1", "tor1", "blr1"], var.region)
+ error_message = "Value must be nyc1, nyc2, nyc3, sfo1, sfo2, sfo3, ams2, ams3, sgp1, lon1, fra1, tor1 or blr1."
+ }
+}
+
+# Configure the DigitalOcean Provider
+provider "digitalocean" {
+ token = var.step1_do_token
+}
+
+data "coder_workspace" "me" {}
+
+resource "coder_agent" "dev" {
+ os = "linux"
+ arch = "amd64"
+}
+
+resource "digitalocean_volume" "home_volume" {
+ region = var.region
+ name = "coder-${data.coder_workspace.me.owner}-${data.coder_workspace.me.name}-home"
+ size = var.home_volume_size
+ initial_filesystem_type = "ext4"
+ initial_filesystem_label = "coder-home"
+}
+
+resource "digitalocean_droplet" "workspace" {
+ region = var.region
+ count = data.coder_workspace.me.start_count
+ name = "coder-${data.coder_workspace.me.owner}-${data.coder_workspace.me.name}"
+ image = var.droplet_image
+ size = var.droplet_size
+ volume_ids = [digitalocean_volume.home_volume.id]
+ user_data = templatefile("cloud-config.yaml.tftpl", {
+ username = data.coder_workspace.me.owner
+ home_volume_label = digitalocean_volume.home_volume.initial_filesystem_label
+ init_script = base64encode(coder_agent.dev.init_script)
+ coder_agent_token = coder_agent.dev.token
+ })
+ # Required to provision Fedora.
+ ssh_keys = var.step3_do_admin_ssh_key > 0 ? [var.step3_do_admin_ssh_key] : []
+}
+
+# Temporarily disabled because it breaks SSH. (https://github.com/coder/coder/issues/1750)
+# resource "digitalocean_project_resources" "project" {
+# project = var.step2_do_project_id
+# # Workaround for terraform plan when using count.
+# resources = length(digitalocean_droplet.workspace) > 0 ? [
+# digitalocean_volume.home_volume.urn,
+# digitalocean_droplet.workspace[0].urn
+# ] : [
+# digitalocean_volume.home_volume.urn
+# ]
+# }
pFad - Phonifier reborn
Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.
Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.
Alternative Proxies:
Alternative Proxy
pFad Proxy
pFad v3 Proxy
pFad v4 Proxy