From 246939a481ea667f26696beb8d2416346fc7a21f Mon Sep 17 00:00:00 2001 From: Ben Date: Sun, 14 Aug 2022 22:30:44 +0000 Subject: [PATCH 01/19] chore: add v2 migration docs --- guides/moving-to-v2.md | 103 +++++++++++++++++++++++++++++++++++++++++ manifest.json | 3 ++ 2 files changed, 106 insertions(+) create mode 100644 guides/moving-to-v2.md diff --git a/guides/moving-to-v2.md b/guides/moving-to-v2.md new file mode 100644 index 000000000..4c7476169 --- /dev/null +++ b/guides/moving-to-v2.md @@ -0,0 +1,103 @@ +--- +title: "Moving to Coder v2 Beta" +description: What you need to know about Coder v2 +--- + +Coder v2 (also referred to as [Coder OSS](https://github.com/coder/coder)) +is Coder's open core remote development platform first launched in June 2022. +This document shares best practices for moving your workflows from Coder v1 to +Coder v2. + +> If you are current Coder v1 customer and to try Coder v2, [we'd like to hear from +> you](https://calendly.com/bpmct/30min) to help inform our roadmap and +> migration strategy. + +## Key concepts + +Coder v2 introduces a number of new paradigms. We recommend reading the comparison table before you proceed. + +| | Coder v1 | Coder v2 | +| - | - | - | +| **Workspace** | Each user creates and develops on remote workspaces | Same as Coder v1 | +| **Supported IDEs** | Web IDEs (code-server, Jupyter) + SSH-powered desktop IDEs (e.g. VS Code, Jetbrains) | Same as Coder v1 | +| **Provisioner** | Provisions workspaces on Kubernetes with hardcoded spec (pod + home volume) | Provisions workspaces via [Terraform](https://terraform.io). Supports any resource (e.g. Windows VM, Kubernetes pod) | +| **Template** | Optional YAML [configuration syntax](https://coder.com/docs/coder/latest/admin/templates) for workspaces. Managed by Coder admins or git/CI | [Terraform code](https://coder.com/docs/coder-oss/latest/templates) that defines workspace specs. Managed by Coder admins or git/CI | +| **Image** | Container image for workspace, contains dev tools and dependencies | Often included in [the template](https://coder.com/docs/coder-oss/latest/templates) | +| **Workspace options** | CPU, RAM, GPU, disk size, image name, CVM (on/off), dotfiles | Defined as variables in [the template](https://coder.com/docs/coder-oss/latest/templates) | +| **Deployment methods** | Kubernetes, Docker | Kubernetes, Docker, VM, or bare metal | +| **Architecture** | Control plane + PostgreSQL database + workspaces | Same as Coder v1 | + +For an in-depth comparison of features, keep reading. Also see the [Coder v2 documentation](https://coder.com/docs/coder-oss/) + +## Migration + +A seperate deployment is necessary to run Coder v2. A direct upgrade via Helm is not possible since Coder v2 introduces new concepts (e.g. templates, provisioners) and other features are still being developed (e.g. audit log, organization support). + +Short term, we recommend keeping your Coder v1 deployment and inviting users to a Coder v2 "proof of concept" deployment that leverages new features (e.g. Windows support, dynamic secrets, faster builds). + +### Users + +Like Coder v1, you can [enable SSO via OpenID Connect](https://coder.com/docs/coder-oss/latest/install/auth#step-2-configure-coder-with-the-openid-connect-credentials) so that any user in your federation can log in. + +3Coder v2 optionally supports [GitHub (Enterprise)](https://coder.com/docs/coder-oss/latest/install/auth#step-1-configure-the-oauth-application-in-github) and [username/password](https://coder.com/docs/coder-oss/latest/users) authentication. + +User-wide settings (e.g. avatar, shell, autostart times, dotfiles URL) are not currently supported in Coder v2 (#) but this behavior can often be replicated via workspace-level parameters. See the [feature comparion](#feature-comparison) below for more details. + +### CLI + +Coder v2 uses a seperate [command line utility](https://coder.com/docs/coder-oss/latest/install). To use both CLIs on the same machine, you can install the Coder v2 CLI under a different name (e.g. `coder2`): + +```sh +curl -sL https://coder.com/install.sh | sh -s -- --method=standalone --binary-name=coder2 > /dev/null + +# Coder v1 CLI +coder workspaces list + +# Coder v2 CLI +coder2 list +``` + + +### Users + +If you + + +### Workspaces + +To migrate Coder v1 workspaces, you'll need at least one [template](https://coder.com/docs/coder-oss/latest/templates) +in your Coder v2 deployment, specifically with the image(s) you support in Coder v1. + + +> If you are interested in a bulk workspace migration utility, [we'd like to +> hear from you](https://calendly.com/bpmct/30min). + +From there, we recommend manually creating a workspace in Coder v2 and using a utility such as `scp` or `rsync` to copy the home directory from your v1 workspace. + +```sh +# Inside a Coder v1 workspace terminal (e.g. coder-v1.example.com) + +# Download the Coder v2 CLI (alias "coder2") +curl -sL https://coder.com/install.sh | sh -s -- --method=standalone --binary-name=coder2 > /dev/null + +# Log in to the Coder v2 deployment (e.g. coder-v2.example.com) +coder2 login https://coder-v2.example.com + +# Create a workspace +coder2 create + +# Gain SSH access to v2 workspaces +coder2 config-ssh + +# Use rsync to copy your home directory into the new workspace +rsync \ + --recursive \ + --itemize-changes \ + --info=progress2 \ + --links \ + --exclude='.cache/' \ + $HOME/. coder.$CODER_WORKSPACE_NAME:/home/coder/. +``` + +### Infrastructure + diff --git a/manifest.json b/manifest.json index c97421686..a5a13e6f5 100644 --- a/manifest.json +++ b/manifest.json @@ -560,6 +560,9 @@ }, { "path": "./guides/workspaces.md" + }, + { + "path": "./guides/moving-to-v2.md" } ] }, From 276ffa1a03b19c07dee082f6ba450197e9e981fd Mon Sep 17 00:00:00 2001 From: Ben Date: Mon, 15 Aug 2022 16:42:57 +0000 Subject: [PATCH 02/19] add users, infrastructure, and some rewording --- guides/moving-to-v2.md | 35 +++++++++++++++++++---------------- 1 file changed, 19 insertions(+), 16 deletions(-) diff --git a/guides/moving-to-v2.md b/guides/moving-to-v2.md index 4c7476169..f2f79bddd 100644 --- a/guides/moving-to-v2.md +++ b/guides/moving-to-v2.md @@ -8,11 +8,13 @@ is Coder's open core remote development platform first launched in June 2022. This document shares best practices for moving your workflows from Coder v1 to Coder v2. +![Coder v2 Dashboard](https://raw.githubusercontent.com/coder/coder/main/docs/images/hero-image.png) + > If you are current Coder v1 customer and to try Coder v2, [we'd like to hear from > you](https://calendly.com/bpmct/30min) to help inform our roadmap and > migration strategy. -## Key concepts +## High-level concepts Coder v2 introduces a number of new paradigms. We recommend reading the comparison table before you proceed. @@ -27,21 +29,20 @@ Coder v2 introduces a number of new paradigms. We recommend reading the comparis | **Deployment methods** | Kubernetes, Docker | Kubernetes, Docker, VM, or bare metal | | **Architecture** | Control plane + PostgreSQL database + workspaces | Same as Coder v1 | -For an in-depth comparison of features, keep reading. Also see the [Coder v2 documentation](https://coder.com/docs/coder-oss/) +Keep reading for an in-depth feature comparison. Also see the [Coder v2 documentation](https://coder.com/docs/coder-oss/) -## Migration +## Migration Strategy A seperate deployment is necessary to run Coder v2. A direct upgrade via Helm is not possible since Coder v2 introduces new concepts (e.g. templates, provisioners) and other features are still being developed (e.g. audit log, organization support). -Short term, we recommend keeping your Coder v1 deployment and inviting users to a Coder v2 "proof of concept" deployment that leverages new features (e.g. Windows support, dynamic secrets, faster builds). - -### Users +Short term, we recommend keeping your Coder v1 deployment and inviting a pilot group to your Coder v2 deployment to reproduce their workflows and try new features (e.g. Windows support, dynamic secrets, faster builds). -Like Coder v1, you can [enable SSO via OpenID Connect](https://coder.com/docs/coder-oss/latest/install/auth#step-2-configure-coder-with-the-openid-connect-credentials) so that any user in your federation can log in. +### Infrastructure -3Coder v2 optionally supports [GitHub (Enterprise)](https://coder.com/docs/coder-oss/latest/install/auth#step-1-configure-the-oauth-application-in-github) and [username/password](https://coder.com/docs/coder-oss/latest/users) authentication. +For small "proof-of-concept" deployments, you can use Coder's [built-in database and tunnel](https://github.com/coder/coder#getting-started) on a VM to avoid setting up a +database, reverse proxy, and TLS. -User-wide settings (e.g. avatar, shell, autostart times, dotfiles URL) are not currently supported in Coder v2 (#) but this behavior can often be replicated via workspace-level parameters. See the [feature comparion](#feature-comparison) below for more details. +For production use, we recommend running Coder with an external PostgresSQL database and a reverse proxy for TLS. These configuration options and other deployment-wide settings are set via [environment variables](https://coder.com/docs/coder-oss/latest/install/configure). See the [feature comparison](./#feature-comparison) for in-depth details and installation methods (e.g. Helm). ### CLI @@ -57,19 +58,21 @@ coder workspaces list coder2 list ``` - ### Users -If you +Like Coder v1, you can [enable SSO via OpenID Connect](https://coder.com/docs/coder-oss/latest/install/auth#step-2-configure-coder-with-the-openid-connect-credentials) so that any user in your federation can log in. Coder v2 optionally supports [GitHub (Enterprise)](https://coder.com/docs/coder-oss/latest/install/auth#step-1-configure-the-oauth-application-in-github) and [username/password](https://coder.com/docs/coder-oss/latest/users) authentication. +> If you are interested in a bulk user and/or workspace migration utility, [we'd like to +> hear from you](https://calendly.com/bpmct/30min). + +User-wide settings (e.g. avatar, shell, autostart times, dotfiles URL) are not currently supported in Coder v2 [(#3506)](https://github.com/coder/coder/issues/3506) but this behavior can often be replicated via workspace-level parameters. See the [feature comparion](#feature-comparison) below for more details. ### Workspaces To migrate Coder v1 workspaces, you'll need at least one [template](https://coder.com/docs/coder-oss/latest/templates) in your Coder v2 deployment, specifically with the image(s) you support in Coder v1. - -> If you are interested in a bulk workspace migration utility, [we'd like to +> If you are interested in a bulk user and/or workspace migration utility, [we'd like to > hear from you](https://calendly.com/bpmct/30min). From there, we recommend manually creating a workspace in Coder v2 and using a utility such as `scp` or `rsync` to copy the home directory from your v1 workspace. @@ -87,9 +90,9 @@ coder2 login https://coder-v2.example.com coder2 create # Gain SSH access to v2 workspaces -coder2 config-ssh +coder2 config-ssh -y -# Use rsync to copy your home directory into the new workspace +# Copy your home directory into the new Coder v2 workspace rsync \ --recursive \ --itemize-changes \ @@ -99,5 +102,5 @@ rsync \ $HOME/. coder.$CODER_WORKSPACE_NAME:/home/coder/. ``` -### Infrastructure +## Feature Comparison From 59bff4e5d3de9fa723f2ce0d8fbb3e5941263fcd Mon Sep 17 00:00:00 2001 From: Ben Date: Mon, 15 Aug 2022 21:02:38 +0000 Subject: [PATCH 03/19] add more comparison tables --- guides/{moving-to-v2.md => moving-to-oss.md} | 57 ++++++++++++++++++-- manifest.json | 2 +- 2 files changed, 54 insertions(+), 5 deletions(-) rename guides/{moving-to-v2.md => moving-to-oss.md} (56%) diff --git a/guides/moving-to-v2.md b/guides/moving-to-oss.md similarity index 56% rename from guides/moving-to-v2.md rename to guides/moving-to-oss.md index f2f79bddd..4524eaa05 100644 --- a/guides/moving-to-v2.md +++ b/guides/moving-to-oss.md @@ -1,6 +1,6 @@ --- -title: "Moving to Coder v2 Beta" -description: What you need to know about Coder v2 +title: "Moving to Coder OSS Beta" +description: What you need to know about Coder OSS --- Coder v2 (also referred to as [Coder OSS](https://github.com/coder/coder)) @@ -42,7 +42,26 @@ Short term, we recommend keeping your Coder v1 deployment and inviting a pilot g For small "proof-of-concept" deployments, you can use Coder's [built-in database and tunnel](https://github.com/coder/coder#getting-started) on a VM to avoid setting up a database, reverse proxy, and TLS. -For production use, we recommend running Coder with an external PostgresSQL database and a reverse proxy for TLS. These configuration options and other deployment-wide settings are set via [environment variables](https://coder.com/docs/coder-oss/latest/install/configure). See the [feature comparison](./#feature-comparison) for in-depth details and installation methods (e.g. Helm). +For production use, we recommend running Coder with an external PostgresSQL database and a reverse proxy for TLS. + +| | Coder v1 | Coder v2 | +| - | - | - | +| Kubernetes | ✅ Helm chart | ⌛ Helm chart [(needs docs)](https://github.com/coder/coder/issues/3224) | +| Kubernetes (HA/multiple replicas) | ✅ | ⌛ [#3502](https://github.com/coder/coder/issues/3502) | +| Kubernetes (built-in database) | ✅ | ❌ | +| Docker deployment | ✅ | ✅ | +| VM deployment | ❌ | ✅ [system packages](https://coder.com/docs/coder-oss/latest/install#system-packages) and [prebuilt binaries](https://coder.com/docs/coder-oss/latest/install#manual) | +| Built-in PostgreSQL | ✅ | ✅ | +| Built-in TLS tunnel | ❌ | ✅ | +| External PostgreSQL support | ✅ | ✅ ([configuration flag](https://coder.com/docs/coder-oss/latest/install/configure)) | +| External TLS documentation | ✅ (via [cert-manager](https://coder.com/docs/coder/latest/guides/tls-certificates)) | ⌛ [#3518](https://github.com/coder/coder/issues/3518) | +| **Multi region/cloud (workspaces)** | ✅ [Workspace providers](https://coder.com/docs/coder/latest/admin/workspace-providers) support additional clusters. | ✅ [Templates](https://coder.com/docs/coder/latest/admin/templates) can provision resources in any clouds, clusters, or region | +| **Multi region/cloud (provisioning)** | ❌ | ⌛ [#44](https://github.com/coder/coder/issues/44) | +| **Multi region/cloud (authentication)** | ✅ Authenticates to clusters via secrets stored in the database | ✅ Authenticates via Terraform provider and [provisioner](https://coder.com/docs/coder-oss/latest/architecture) environment | +| **Multi region/cloud (dashboard)** | ✅ Multi-region [satellites](https://coder.com/docs/coder/latest/admin/satellites) for faster IDE connections. | ⌛ [#3227](https://github.com/coder/coder/issues/3227) | +| **Multi region/cloud (tunnel/SSH)** | ✅ [Direct connections via STUN](https://coder.com/docs/coder/latest/admin/stun) | ✅ Direct connections via STUN ([configuration flag](https://coder.com/docs/coder-oss/latest/install/configure)) | + +See the Coder OSS [installation docs](https://coder.com/docs/coder-oss/latest/install) for more details. Missing something or have feedback? [Let us know](https://coder.com/contact) ### CLI @@ -65,6 +84,18 @@ Like Coder v1, you can [enable SSO via OpenID Connect](https://coder.com/docs/co > If you are interested in a bulk user and/or workspace migration utility, [we'd like to > hear from you](https://calendly.com/bpmct/30min). + +| | Coder v1 | Coder v2 | +| - | - | - | +| Avatar | ✅ | ❌ | +| Dotfiles | ✅ | Per-workspace [(dotfiles docs)](https://coder.com/docs/coder-oss/latest/dotfiles) | +| Generated SSH key | ✅ | ✅ | +| Default shell | ✅ | Per-workspace [(with parameters)](https://coder.com/docs/coder-oss/latest/templates#parameters) | +| Auto-start times | ✅ | Per-workspace | +| Git OAuth | ✅ | SSH-key only | + +Missing something or have feedback? [Let us know](https://coder.com/contact) + User-wide settings (e.g. avatar, shell, autostart times, dotfiles URL) are not currently supported in Coder v2 [(#3506)](https://github.com/coder/coder/issues/3506) but this behavior can often be replicated via workspace-level parameters. See the [feature comparion](#feature-comparison) below for more details. ### Workspaces @@ -102,5 +133,23 @@ rsync \ $HOME/. coder.$CODER_WORKSPACE_NAME:/home/coder/. ``` -## Feature Comparison +| | Coder v1 | Coder v2 | +| - | - | - | +| **Kubernetes workspaces** | ✅ Hardcoded spec | ✅ Any spec via the [template](https://github.com/coder/coder/tree/main/examples/templates/kubernetes-multi-service) | +| **Docker workspaces** | ✅ Hardcoded spec | ✅ Any spec via the Terraform [template](https://coder.com/docs/coder-oss/latest/templates) | +| **VM workspaces** | [EC2 containers only](https://coder.com/docs/coder/latest/admin/workspace-providers/deployment/ec2#prerequisites) | ✅ Any spec via the Terraform [template](https://coder.com/docs/coder-oss/latest/templates) | +| **Linux workspaces** | ✅ | ✅ | +| **Windows workspaces** | ✅ | ✅ | +| **macOS workspaces** | ❌ | ✅ | +| **ARM workspaces** | ❌ | ✅ | +| **Additional resources in workspace (volume mounts, API keys, etc)** | ❌ | ✅ Any [Terraform resource](https:///registry.terraform.io) | +| **Workspace options** | ✅ Hardcoded options | ✅ Any options via [template parameters](https://coder.com/docs/coder-oss/latest/templates#parameters) | +| **Edit workspace** | ✅ | ⌛ [#802](https://github.com/coder/coder/issues/802) | +| **Resource provisoning rates** | ✅ Organization wide | ✅ Template wide [(needs docs)](https://github.com/coder/coder/issues/3519) | +| **Delete workspace** | ✅ | ✅ | + +### Other features +| | Coder v1 | Coder v2 | +| - | - | - | +| **Organizations** | ✅ | ❌ | diff --git a/manifest.json b/manifest.json index a5a13e6f5..4bfad6fe9 100644 --- a/manifest.json +++ b/manifest.json @@ -562,7 +562,7 @@ "path": "./guides/workspaces.md" }, { - "path": "./guides/moving-to-v2.md" + "path": "./guides/moving-to-oss.md" } ] }, From c5850d79c0ae0b3613805c66c21355ee6c6f044b Mon Sep 17 00:00:00 2001 From: Ben Date: Mon, 15 Aug 2022 21:44:24 +0000 Subject: [PATCH 04/19] Add developer experience section --- guides/moving-to-oss.md | 107 +++++++++++++++++++++++++++------------- 1 file changed, 73 insertions(+), 34 deletions(-) diff --git a/guides/moving-to-oss.md b/guides/moving-to-oss.md index 4524eaa05..445f380ec 100644 --- a/guides/moving-to-oss.md +++ b/guides/moving-to-oss.md @@ -3,22 +3,22 @@ title: "Moving to Coder OSS Beta" description: What you need to know about Coder OSS --- -Coder v2 (also referred to as [Coder OSS](https://github.com/coder/coder)) +Coder OSS (also referred to as [Coder OSS](https://github.com/coder/coder)) is Coder's open core remote development platform first launched in June 2022. This document shares best practices for moving your workflows from Coder v1 to -Coder v2. +Coder OSS. -![Coder v2 Dashboard](https://raw.githubusercontent.com/coder/coder/main/docs/images/hero-image.png) +![Coder OSS Dashboard](https://raw.githubusercontent.com/coder/coder/main/docs/images/hero-image.png) -> If you are current Coder v1 customer and to try Coder v2, [we'd like to hear from +> If you are current Coder v1 customer and to try Coder OSS, [we'd like to hear from > you](https://calendly.com/bpmct/30min) to help inform our roadmap and > migration strategy. ## High-level concepts -Coder v2 introduces a number of new paradigms. We recommend reading the comparison table before you proceed. +Coder OSS introduces a number of new paradigms. We recommend reading the comparison table before you proceed. -| | Coder v1 | Coder v2 | +| | Coder v1 | Coder OSS | | - | - | - | | **Workspace** | Each user creates and develops on remote workspaces | Same as Coder v1 | | **Supported IDEs** | Web IDEs (code-server, Jupyter) + SSH-powered desktop IDEs (e.g. VS Code, Jetbrains) | Same as Coder v1 | @@ -29,13 +29,25 @@ Coder v2 introduces a number of new paradigms. We recommend reading the comparis | **Deployment methods** | Kubernetes, Docker | Kubernetes, Docker, VM, or bare metal | | **Architecture** | Control plane + PostgreSQL database + workspaces | Same as Coder v1 | -Keep reading for an in-depth feature comparison. Also see the [Coder v2 documentation](https://coder.com/docs/coder-oss/) +Keep reading for an in-depth feature comparison. Also see the [Coder OSS documentation](https://coder.com/docs/coder-oss/) ## Migration Strategy -A seperate deployment is necessary to run Coder v2. A direct upgrade via Helm is not possible since Coder v2 introduces new concepts (e.g. templates, provisioners) and other features are still being developed (e.g. audit log, organization support). +A seperate deployment is necessary to run Coder OSS. A direct upgrade via Helm is not possible since Coder OSS introduces new concepts (e.g. templates, provisioners) and other features are still being developed (e.g. audit log, organization support). -Short term, we recommend keeping your Coder v1 deployment and inviting a pilot group to your Coder v2 deployment to reproduce their workflows and try new features (e.g. Windows support, dynamic secrets, faster builds). +Short term, we recommend keeping your Coder v1 deployment and inviting a pilot group to your Coder OSS deployment to reproduce their workflows and try new features (e.g. Windows support, dynamic secrets, faster builds). + +### Feature list key + +Please comment on any issues in the [coder/coder](https://github.com/coder/coder) repo or [contact us](https://coder.com/contact) if they are important to you. + +✅ = Complete + +⌛ = WIP/planned [on a roadmap](https://github.com/coder/coder/discussions/categories/roadmap) + +🤔 = Still considering + +❌ = No current plans for feature ### Infrastructure @@ -44,7 +56,7 @@ database, reverse proxy, and TLS. For production use, we recommend running Coder with an external PostgresSQL database and a reverse proxy for TLS. -| | Coder v1 | Coder v2 | +| | Coder v1 | Coder OSS | | - | - | - | | Kubernetes | ✅ Helm chart | ⌛ Helm chart [(needs docs)](https://github.com/coder/coder/issues/3224) | | Kubernetes (HA/multiple replicas) | ✅ | ⌛ [#3502](https://github.com/coder/coder/issues/3502) | @@ -61,69 +73,68 @@ For production use, we recommend running Coder with an external PostgresSQL data | **Multi region/cloud (dashboard)** | ✅ Multi-region [satellites](https://coder.com/docs/coder/latest/admin/satellites) for faster IDE connections. | ⌛ [#3227](https://github.com/coder/coder/issues/3227) | | **Multi region/cloud (tunnel/SSH)** | ✅ [Direct connections via STUN](https://coder.com/docs/coder/latest/admin/stun) | ✅ Direct connections via STUN ([configuration flag](https://coder.com/docs/coder-oss/latest/install/configure)) | -See the Coder OSS [installation docs](https://coder.com/docs/coder-oss/latest/install) for more details. Missing something or have feedback? [Let us know](https://coder.com/contact) +See the Coder OSS [installation docs](https://coder.com/docs/coder-oss/latest/install) for more details. Something missing, or have feedback? [Let us know](https://coder.com/contact) ### CLI -Coder v2 uses a seperate [command line utility](https://coder.com/docs/coder-oss/latest/install). To use both CLIs on the same machine, you can install the Coder v2 CLI under a different name (e.g. `coder2`): +Coder OSS uses a seperate [command line utility](https://coder.com/docs/coder-oss/latest/install). To use both CLIs on the same machine, you can install the Coder OSS CLI under a different name (e.g. `codeross`): ```sh -curl -sL https://coder.com/install.sh | sh -s -- --method=standalone --binary-name=coder2 > /dev/null +curl -sL https://coder.com/install.sh | sh -s -- --method=standalone --binary-name=codeross > /dev/null # Coder v1 CLI coder workspaces list -# Coder v2 CLI -coder2 list +# Coder OSS CLI +codeross list ``` ### Users -Like Coder v1, you can [enable SSO via OpenID Connect](https://coder.com/docs/coder-oss/latest/install/auth#step-2-configure-coder-with-the-openid-connect-credentials) so that any user in your federation can log in. Coder v2 optionally supports [GitHub (Enterprise)](https://coder.com/docs/coder-oss/latest/install/auth#step-1-configure-the-oauth-application-in-github) and [username/password](https://coder.com/docs/coder-oss/latest/users) authentication. +Like Coder v1, you can [enable SSO via OpenID Connect](https://coder.com/docs/coder-oss/latest/install/auth#step-2-configure-coder-with-the-openid-connect-credentials) so that any user in your federation can log in. Coder OSS optionally supports [GitHub (Enterprise)](https://coder.com/docs/coder-oss/latest/install/auth#step-1-configure-the-oauth-application-in-github) and [username/password](https://coder.com/docs/coder-oss/latest/users) authentication. > If you are interested in a bulk user and/or workspace migration utility, [we'd like to > hear from you](https://calendly.com/bpmct/30min). - -| | Coder v1 | Coder v2 | +| | Coder v1 | Coder OSS | | - | - | - | | Avatar | ✅ | ❌ | | Dotfiles | ✅ | Per-workspace [(dotfiles docs)](https://coder.com/docs/coder-oss/latest/dotfiles) | | Generated SSH key | ✅ | ✅ | | Default shell | ✅ | Per-workspace [(with parameters)](https://coder.com/docs/coder-oss/latest/templates#parameters) | | Auto-start times | ✅ | Per-workspace | -| Git OAuth | ✅ | SSH-key only | +| Git OAuth | ✅ | SSH key only | -Missing something or have feedback? [Let us know](https://coder.com/contact) +Something missing, or have feedback? [Let us know](https://coder.com/contact) -User-wide settings (e.g. avatar, shell, autostart times, dotfiles URL) are not currently supported in Coder v2 [(#3506)](https://github.com/coder/coder/issues/3506) but this behavior can often be replicated via workspace-level parameters. See the [feature comparion](#feature-comparison) below for more details. +User-wide settings (e.g. avatar, shell, autostart times, dotfiles URL) are not currently supported in Coder OSS [(#3506)](https://github.com/coder/coder/issues/3506). ### Workspaces To migrate Coder v1 workspaces, you'll need at least one [template](https://coder.com/docs/coder-oss/latest/templates) -in your Coder v2 deployment, specifically with the image(s) you support in Coder v1. +in your Coder OSS deployment, specifically with the image(s) you support in Coder v1. > If you are interested in a bulk user and/or workspace migration utility, [we'd like to > hear from you](https://calendly.com/bpmct/30min). -From there, we recommend manually creating a workspace in Coder v2 and using a utility such as `scp` or `rsync` to copy the home directory from your v1 workspace. +From there, we recommend manually creating a workspace in Coder OSS and using a utility such as `scp` or `rsync` to copy the home directory from your v1 workspace. ```sh # Inside a Coder v1 workspace terminal (e.g. coder-v1.example.com) -# Download the Coder v2 CLI (alias "coder2") -curl -sL https://coder.com/install.sh | sh -s -- --method=standalone --binary-name=coder2 > /dev/null +# Download the Coder OSS CLI (alias "codeross") +curl -sL https://coder.com/install.sh | sh -s -- --method=standalone --binary-name=codeross > /dev/null -# Log in to the Coder v2 deployment (e.g. coder-v2.example.com) -coder2 login https://coder-v2.example.com +# Log in to the Coder OSS deployment (e.g. coder-v2.example.com) +codeross login https://coder-v2.example.com # Create a workspace -coder2 create +codeross create # Gain SSH access to v2 workspaces -coder2 config-ssh -y +codeross config-ssh -y -# Copy your home directory into the new Coder v2 workspace +# Copy your home directory into the new Coder OSS workspace rsync \ --recursive \ --itemize-changes \ @@ -133,7 +144,7 @@ rsync \ $HOME/. coder.$CODER_WORKSPACE_NAME:/home/coder/. ``` -| | Coder v1 | Coder v2 | +| | Coder v1 | Coder OSS | | - | - | - | | **Kubernetes workspaces** | ✅ Hardcoded spec | ✅ Any spec via the [template](https://github.com/coder/coder/tree/main/examples/templates/kubernetes-multi-service) | | **Docker workspaces** | ✅ Hardcoded spec | ✅ Any spec via the Terraform [template](https://coder.com/docs/coder-oss/latest/templates) | @@ -148,8 +159,36 @@ rsync \ | **Resource provisoning rates** | ✅ Organization wide | ✅ Template wide [(needs docs)](https://github.com/coder/coder/issues/3519) | | **Delete workspace** | ✅ | ✅ | -### Other features +Something missing, or have feedback? [Let us know](https://coder.com/contact) + +### Developer experience + +| | Coder v1 | Coder OSS | +| - | - | - | +| **Auto-start workspace (schedule)** | ✅ | ✅ | +| **Auto-start workspace (SSH or visit app)** | ❌ | 🤔 [#2909](https://github.com/coder/coder/issues/2909) | +| **Code via web terminal** | ✅ | ✅ | +| **Code via code-server (Code Web)** | ✅ Hardcoded version | ✅ Any version [via the template](https://coder.com/docs/coder-oss/latest/ides/web-ides#code-server) | +| **Code via JetBrains Projector (web)** | ✅ Hardcoded version | ✅ Any version [via the template](https://coder.com/docs/coder-oss/latest/ides/web-ides#jetbrains-projector) | +| **Code via SSH (VS Code Remote, Jetbrains Gateway)** | ✅ With [coder-cli](https://github.com/coder/coder-cli) installed | ✅ With [coder](https://coder.com/docs/coder-oss/latest/install) installed | +| **Custom workspace applications** | ✅ | ✅ Defined in [templates](https://coder.com/docs/coder-oss/latest/templates#coder-apps) | +| **Access ports (SSH/tunnel)** | ✅ | ✅ | +| **Access ports (web UI)** | ✅ [Dev URLs](https://coder.com/docs/coder/latest/workspaces/devurls) | ⌛ [(#1624)](https://github.com/coder/coder/issues/1624) | +| **Share ports (web UI)** | ✅ [Dev URLs](https://coder.com/docs/coder/latest/workspaces/devurls) | ⌛ [(#3515)](https://github.com/coder/coder/issues/3515) | + +Something missing, or have feedback? [Let us know](https://coder.com/contact) + + +### Enterprise/management -| | Coder v1 | Coder v2 | +| | Coder v1 | Coder OSS | | - | - | - | -| **Organizations** | ✅ | ❌ | +| **Auto-stop workspace** | ✅ Activity-based | ✅ Schedule-based ⌛ Activity-based [(#2995)](https://github.com/coder/coder/issues/2995) | +| **Audit logging** | ✅ | ⌛ [#3251](https://github.com/coder/coder/issues/3251) | +| **Organizations** | ✅ | ❌ | +| **User metrics** | ✅ | Some via Prometheus export [(needs docs)](https://github.com/coder/coder/issues/3520) | +| **Resource limits/quotas** | ✅ | ⌛ [#2988](https://github.com/coder/coder/issues/2988) | +| **SDK** | ✅ | ✅ [codersdk](https://github.com/coder/coder/tree/main/codersdk) | +| **REST API** | ✅ | 🤔 [(needs docs)](https://github.com/coder/coder/issues/3522) | + +Something missing, or have feedback? [Let us know](https://coder.com/contact) \ No newline at end of file From 9a751aa418783c257cb85f71c7c1950f041d7527 Mon Sep 17 00:00:00 2001 From: Ben Date: Mon, 15 Aug 2022 21:47:11 +0000 Subject: [PATCH 05/19] =?UTF-8?q?edits=20from=20=F0=9F=A6=88=20feedback?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- guides/moving-to-oss.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/guides/moving-to-oss.md b/guides/moving-to-oss.md index 445f380ec..2990aecaf 100644 --- a/guides/moving-to-oss.md +++ b/guides/moving-to-oss.md @@ -11,7 +11,7 @@ Coder OSS. ![Coder OSS Dashboard](https://raw.githubusercontent.com/coder/coder/main/docs/images/hero-image.png) > If you are current Coder v1 customer and to try Coder OSS, [we'd like to hear from -> you](https://calendly.com/bpmct/30min) to help inform our roadmap and +> you](https://coder.com/contact) to help inform our roadmap and > migration strategy. ## High-level concepts @@ -21,7 +21,7 @@ Coder OSS introduces a number of new paradigms. We recommend reading the compari | | Coder v1 | Coder OSS | | - | - | - | | **Workspace** | Each user creates and develops on remote workspaces | Same as Coder v1 | -| **Supported IDEs** | Web IDEs (code-server, Jupyter) + SSH-powered desktop IDEs (e.g. VS Code, Jetbrains) | Same as Coder v1 | +| **Supported IDEs** | Web IDEs (code-server, Jupyter) + SSH-powered desktop IDEs (e.g. VS Code, JetBrains) | Same as Coder v1 | | **Provisioner** | Provisions workspaces on Kubernetes with hardcoded spec (pod + home volume) | Provisions workspaces via [Terraform](https://terraform.io). Supports any resource (e.g. Windows VM, Kubernetes pod) | | **Template** | Optional YAML [configuration syntax](https://coder.com/docs/coder/latest/admin/templates) for workspaces. Managed by Coder admins or git/CI | [Terraform code](https://coder.com/docs/coder-oss/latest/templates) that defines workspace specs. Managed by Coder admins or git/CI | | **Image** | Container image for workspace, contains dev tools and dependencies | Often included in [the template](https://coder.com/docs/coder-oss/latest/templates) | @@ -94,7 +94,7 @@ codeross list Like Coder v1, you can [enable SSO via OpenID Connect](https://coder.com/docs/coder-oss/latest/install/auth#step-2-configure-coder-with-the-openid-connect-credentials) so that any user in your federation can log in. Coder OSS optionally supports [GitHub (Enterprise)](https://coder.com/docs/coder-oss/latest/install/auth#step-1-configure-the-oauth-application-in-github) and [username/password](https://coder.com/docs/coder-oss/latest/users) authentication. > If you are interested in a bulk user and/or workspace migration utility, [we'd like to -> hear from you](https://calendly.com/bpmct/30min). +> hear from you](https://coder.com/contact). | | Coder v1 | Coder OSS | | - | - | - | @@ -115,7 +115,7 @@ To migrate Coder v1 workspaces, you'll need at least one [template](https://code in your Coder OSS deployment, specifically with the image(s) you support in Coder v1. > If you are interested in a bulk user and/or workspace migration utility, [we'd like to -> hear from you](https://calendly.com/bpmct/30min). +> hear from you](https://coder.com/contact). From there, we recommend manually creating a workspace in Coder OSS and using a utility such as `scp` or `rsync` to copy the home directory from your v1 workspace. @@ -170,7 +170,7 @@ rsync \ | **Code via web terminal** | ✅ | ✅ | | **Code via code-server (Code Web)** | ✅ Hardcoded version | ✅ Any version [via the template](https://coder.com/docs/coder-oss/latest/ides/web-ides#code-server) | | **Code via JetBrains Projector (web)** | ✅ Hardcoded version | ✅ Any version [via the template](https://coder.com/docs/coder-oss/latest/ides/web-ides#jetbrains-projector) | -| **Code via SSH (VS Code Remote, Jetbrains Gateway)** | ✅ With [coder-cli](https://github.com/coder/coder-cli) installed | ✅ With [coder](https://coder.com/docs/coder-oss/latest/install) installed | +| **Code via SSH (VS Code Remote, JetBrains Gateway)** | ✅ With [coder-cli](https://github.com/coder/coder-cli) installed | ✅ With [coder](https://coder.com/docs/coder-oss/latest/install) installed | | **Custom workspace applications** | ✅ | ✅ Defined in [templates](https://coder.com/docs/coder-oss/latest/templates#coder-apps) | | **Access ports (SSH/tunnel)** | ✅ | ✅ | | **Access ports (web UI)** | ✅ [Dev URLs](https://coder.com/docs/coder/latest/workspaces/devurls) | ⌛ [(#1624)](https://github.com/coder/coder/issues/1624) | From b98a9b9a828a893e87aef66be37a3e02a0399a8f Mon Sep 17 00:00:00 2001 From: Ben Date: Mon, 15 Aug 2022 22:02:17 +0000 Subject: [PATCH 06/19] format/lint --- .markdownlint.jsonc | 3 +- guides/moving-to-oss.md | 256 ++++++++++++++++++++++------------------ 2 files changed, 146 insertions(+), 113 deletions(-) diff --git a/.markdownlint.jsonc b/.markdownlint.jsonc index 8dd9094f5..b0711b869 100644 --- a/.markdownlint.jsonc +++ b/.markdownlint.jsonc @@ -11,7 +11,8 @@ }, "MD013": { - "code_blocks": false + "code_blocks": false, + "tables": false }, // Enforces that the only punctuation that may appear at the end of a heading diff --git a/guides/moving-to-oss.md b/guides/moving-to-oss.md index 2990aecaf..f4c967862 100644 --- a/guides/moving-to-oss.md +++ b/guides/moving-to-oss.md @@ -1,49 +1,60 @@ --- title: "Moving to Coder OSS Beta" -description: What you need to know about Coder OSS +description: What you need to know about Coder OSS --- -Coder OSS (also referred to as [Coder OSS](https://github.com/coder/coder)) -is Coder's open core remote development platform first launched in June 2022. -This document shares best practices for moving your workflows from Coder v1 to -Coder OSS. +Coder OSS (also referred to as [Coder OSS](https://github.com/coder/coder)) is +Coder's open core remote development platform first launched in June 2022. This +document shares best practices for moving your workflows from Coder v1 to Coder +OSS. -![Coder OSS Dashboard](https://raw.githubusercontent.com/coder/coder/main/docs/images/hero-image.png) +![Coder OSS +Dashboard](https://raw.githubusercontent.com/coder/coder/main/docs/images/hero-image.png) -> If you are current Coder v1 customer and to try Coder OSS, [we'd like to hear from -> you](https://coder.com/contact) to help inform our roadmap and -> migration strategy. +> If you are current Coder v1 customer and to try Coder OSS, +> [we'd like to hear from you](https://coder.com/contact) to help inform our +> roadmap and migration strategy. ## High-level concepts -Coder OSS introduces a number of new paradigms. We recommend reading the comparison table before you proceed. +Coder OSS introduces a number of new paradigms. We recommend reading the +comparison table before you proceed. -| | Coder v1 | Coder OSS | -| - | - | - | -| **Workspace** | Each user creates and develops on remote workspaces | Same as Coder v1 | -| **Supported IDEs** | Web IDEs (code-server, Jupyter) + SSH-powered desktop IDEs (e.g. VS Code, JetBrains) | Same as Coder v1 | -| **Provisioner** | Provisions workspaces on Kubernetes with hardcoded spec (pod + home volume) | Provisions workspaces via [Terraform](https://terraform.io). Supports any resource (e.g. Windows VM, Kubernetes pod) | -| **Template** | Optional YAML [configuration syntax](https://coder.com/docs/coder/latest/admin/templates) for workspaces. Managed by Coder admins or git/CI | [Terraform code](https://coder.com/docs/coder-oss/latest/templates) that defines workspace specs. Managed by Coder admins or git/CI | -| **Image** | Container image for workspace, contains dev tools and dependencies | Often included in [the template](https://coder.com/docs/coder-oss/latest/templates) | -| **Workspace options** | CPU, RAM, GPU, disk size, image name, CVM (on/off), dotfiles | Defined as variables in [the template](https://coder.com/docs/coder-oss/latest/templates) | -| **Deployment methods** | Kubernetes, Docker | Kubernetes, Docker, VM, or bare metal | -| **Architecture** | Control plane + PostgreSQL database + workspaces | Same as Coder v1 | +| | Coder v1 | Coder OSS | +| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | +| **Workspace** | Each user creates and develops on remote workspaces | Same as Coder v1 | +| **Supported IDEs** | Web IDEs (code-server, Jupyter) + SSH-powered desktop IDEs (e.g. VS Code, JetBrains) | Same as Coder v1 | +| **Provisioner** | Provisions workspaces on Kubernetes with hardcoded spec (pod + home volume) | Provisions workspaces via [Terraform](https://terraform.io). Supports any resource (e.g. Windows VM, Kubernetes pod) | +| **Template** | Optional YAML [configuration syntax](https://coder.com/docs/coder/latest/admin/templates) for workspaces. Managed by Coder admins or git/CI | [Terraform code](https://coder.com/docs/coder-oss/latest/templates) that defines workspace specs. Managed by Coder admins or git/CI | +| **Image** | Container image for workspace, contains dev tools and dependencies | Often included in [the template](https://coder.com/docs/coder-oss/latest/templates) | +| **Workspace options** | CPU, RAM, GPU, disk size, image name, CVM (on/off), dotfiles | Defined as variables in [the template](https://coder.com/docs/coder-oss/latest/templates) | +| **Deployment methods** | Kubernetes, Docker | Kubernetes, Docker, VM, or bare metal | +| **Architecture** | Control plane + PostgreSQL database + workspaces | Same as Coder v1 | -Keep reading for an in-depth feature comparison. Also see the [Coder OSS documentation](https://coder.com/docs/coder-oss/) +Keep reading for an in-depth feature comparison. Also see the +[Coder OSS documentation](https://coder.com/docs/coder-oss/) ## Migration Strategy -A seperate deployment is necessary to run Coder OSS. A direct upgrade via Helm is not possible since Coder OSS introduces new concepts (e.g. templates, provisioners) and other features are still being developed (e.g. audit log, organization support). +A seperate deployment is necessary to run Coder OSS. A direct upgrade via Helm +is not possible since Coder OSS introduces new concepts (e.g. templates, +provisioners) and other features are still being developed (e.g. audit log, +organization support). -Short term, we recommend keeping your Coder v1 deployment and inviting a pilot group to your Coder OSS deployment to reproduce their workflows and try new features (e.g. Windows support, dynamic secrets, faster builds). +Short term, we recommend keeping your Coder v1 deployment and inviting a pilot +group to your Coder OSS deployment to reproduce their workflows and try new +features (e.g. Windows support, dynamic secrets, faster builds). ### Feature list key -Please comment on any issues in the [coder/coder](https://github.com/coder/coder) repo or [contact us](https://coder.com/contact) if they are important to you. +Please comment on any issues in the +[coder/coder](https://github.com/coder/coder) repo or +[contact us](https://coder.com/contact) if they are important to you. ✅ = Complete -⌛ = WIP/planned [on a roadmap](https://github.com/coder/coder/discussions/categories/roadmap) +⌛ = WIP/planned +[on a roadmap](https://github.com/coder/coder/discussions/categories/roadmap) 🤔 = Still considering @@ -51,33 +62,41 @@ Please comment on any issues in the [coder/coder](https://github.com/coder/coder ### Infrastructure -For small "proof-of-concept" deployments, you can use Coder's [built-in database and tunnel](https://github.com/coder/coder#getting-started) on a VM to avoid setting up a -database, reverse proxy, and TLS. - -For production use, we recommend running Coder with an external PostgresSQL database and a reverse proxy for TLS. - -| | Coder v1 | Coder OSS | -| - | - | - | -| Kubernetes | ✅ Helm chart | ⌛ Helm chart [(needs docs)](https://github.com/coder/coder/issues/3224) | -| Kubernetes (HA/multiple replicas) | ✅ | ⌛ [#3502](https://github.com/coder/coder/issues/3502) | -| Kubernetes (built-in database) | ✅ | ❌ | -| Docker deployment | ✅ | ✅ | -| VM deployment | ❌ | ✅ [system packages](https://coder.com/docs/coder-oss/latest/install#system-packages) and [prebuilt binaries](https://coder.com/docs/coder-oss/latest/install#manual) | -| Built-in PostgreSQL | ✅ | ✅ | -| Built-in TLS tunnel | ❌ | ✅ | -| External PostgreSQL support | ✅ | ✅ ([configuration flag](https://coder.com/docs/coder-oss/latest/install/configure)) | -| External TLS documentation | ✅ (via [cert-manager](https://coder.com/docs/coder/latest/guides/tls-certificates)) | ⌛ [#3518](https://github.com/coder/coder/issues/3518) | -| **Multi region/cloud (workspaces)** | ✅ [Workspace providers](https://coder.com/docs/coder/latest/admin/workspace-providers) support additional clusters. | ✅ [Templates](https://coder.com/docs/coder/latest/admin/templates) can provision resources in any clouds, clusters, or region | -| **Multi region/cloud (provisioning)** | ❌ | ⌛ [#44](https://github.com/coder/coder/issues/44) | -| **Multi region/cloud (authentication)** | ✅ Authenticates to clusters via secrets stored in the database | ✅ Authenticates via Terraform provider and [provisioner](https://coder.com/docs/coder-oss/latest/architecture) environment | -| **Multi region/cloud (dashboard)** | ✅ Multi-region [satellites](https://coder.com/docs/coder/latest/admin/satellites) for faster IDE connections. | ⌛ [#3227](https://github.com/coder/coder/issues/3227) | -| **Multi region/cloud (tunnel/SSH)** | ✅ [Direct connections via STUN](https://coder.com/docs/coder/latest/admin/stun) | ✅ Direct connections via STUN ([configuration flag](https://coder.com/docs/coder-oss/latest/install/configure)) | - -See the Coder OSS [installation docs](https://coder.com/docs/coder-oss/latest/install) for more details. Something missing, or have feedback? [Let us know](https://coder.com/contact) +For small "proof-of-concept" deployments, you can use Coder's +[built-in database and tunnel](https://github.com/coder/coder#getting-started) +on a VM to avoid setting up a database, reverse proxy, and TLS. + +For production use, we recommend running Coder with an external PostgresSQL +database and a reverse proxy for TLS. + +| | Coder v1 | Coder OSS | +| --------------------------------------- | -------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Kubernetes | ✅ Helm chart | ⌛ Helm chart [(needs docs)](https://github.com/coder/coder/issues/3224) | +| Kubernetes (HA/multiple replicas) | ✅ | ⌛ [#3502](https://github.com/coder/coder/issues/3502) | +| Kubernetes (built-in database) | ✅ | ❌ | +| Docker deployment | ✅ | ✅ | +| VM deployment | ❌ | ✅ [system packages](https://coder.com/docs/coder-oss/latest/install#system-packages) and [prebuilt binaries](https://coder.com/docs/coder-oss/latest/install#manual) | +| Built-in PostgreSQL | ✅ | ✅ | +| Built-in TLS tunnel | ❌ | ✅ | +| External PostgreSQL support | ✅ | ✅ ([configuration flag](https://coder.com/docs/coder-oss/latest/install/configure)) | +| External TLS documentation | ✅ (via [cert-manager](https://coder.com/docs/coder/latest/guides/tls-certificates)) | ⌛ [#3518](https://github.com/coder/coder/issues/3518) | +| **Multi region/cloud (workspaces)** | ✅ [Workspace providers](https://coder.com/docs/coder/latest/admin/workspace-providers) support additional clusters. | ✅ [Templates](https://coder.com/docs/coder/latest/admin/templates) can provision resources in any clouds, clusters, or region | +| **Multi region/cloud (provisioning)** | ❌ | ⌛ [#44](https://github.com/coder/coder/issues/44) | +| **Multi region/cloud (authentication)** | ✅ Authenticates to clusters via secrets stored in the database | ✅ Authenticates via Terraform provider and [provisioner](https://coder.com/docs/coder-oss/latest/architecture) environment | +| **Multi region/cloud (dashboard)** | ✅ Multi-region [satellites](https://coder.com/docs/coder/latest/admin/satellites) for faster IDE connections. | ⌛ [#3227](https://github.com/coder/coder/issues/3227) | +| **Multi region/cloud (tunnel/SSH)** | ✅ [Direct connections via STUN](https://coder.com/docs/coder/latest/admin/stun) | ✅ Direct connections via STUN ([configuration flag](https://coder.com/docs/coder-oss/latest/install/configure)) | + +See the Coder OSS +[installation docs](https://coder.com/docs/coder-oss/latest/install) for more +details. Something missing, or have feedback? +[Let us know](https://coder.com/contact) ### CLI -Coder OSS uses a seperate [command line utility](https://coder.com/docs/coder-oss/latest/install). To use both CLIs on the same machine, you can install the Coder OSS CLI under a different name (e.g. `codeross`): +Coder OSS uses a seperate +[command line utility](https://coder.com/docs/coder-oss/latest/install). To use +both CLIs on the same machine, you can install the Coder OSS CLI under a +different name (e.g. `codeross`): ```sh curl -sL https://coder.com/install.sh | sh -s -- --method=standalone --binary-name=codeross > /dev/null @@ -91,33 +110,44 @@ codeross list ### Users -Like Coder v1, you can [enable SSO via OpenID Connect](https://coder.com/docs/coder-oss/latest/install/auth#step-2-configure-coder-with-the-openid-connect-credentials) so that any user in your federation can log in. Coder OSS optionally supports [GitHub (Enterprise)](https://coder.com/docs/coder-oss/latest/install/auth#step-1-configure-the-oauth-application-in-github) and [username/password](https://coder.com/docs/coder-oss/latest/users) authentication. +Like Coder v1, you can +[enable SSO via OpenID Connect](https://coder.com/docs/coder-oss/latest/install/auth#step-2-configure-coder-with-the-openid-connect-credentials) +so that any user in your federation can log in. Coder OSS optionally supports +[GitHub (Enterprise)](https://coder.com/docs/coder-oss/latest/install/auth#step-1-configure-the-oauth-application-in-github) +and [username/password](https://coder.com/docs/coder-oss/latest/users) +authentication. -> If you are interested in a bulk user and/or workspace migration utility, [we'd like to -> hear from you](https://coder.com/contact). +> If you are interested in a bulk user and/or workspace migration utility, +> [we'd like to hear from you](https://coder.com/contact). -| | Coder v1 | Coder OSS | -| - | - | - | -| Avatar | ✅ | ❌ | -| Dotfiles | ✅ | Per-workspace [(dotfiles docs)](https://coder.com/docs/coder-oss/latest/dotfiles) | -| Generated SSH key | ✅ | ✅ | -| Default shell | ✅ | Per-workspace [(with parameters)](https://coder.com/docs/coder-oss/latest/templates#parameters) | -| Auto-start times | ✅ | Per-workspace | -| Git OAuth | ✅ | SSH key only | +| | Coder v1 | Coder OSS | +| ----------------- | -------- | ----------------------------------------------------------------------------------------------- | +| Avatar | ✅ | ❌ | +| Dotfiles | ✅ | Per-workspace [(dotfiles docs)](https://coder.com/docs/coder-oss/latest/dotfiles) | +| Generated SSH key | ✅ | ✅ | +| Default shell | ✅ | Per-workspace [(with parameters)](https://coder.com/docs/coder-oss/latest/templates#parameters) | +| Auto-start times | ✅ | Per-workspace | +| Git OAuth | ✅ | SSH key only | -Something missing, or have feedback? [Let us know](https://coder.com/contact) +Something missing, or have feedback? +[Let us know](https://coder.com/contact) -User-wide settings (e.g. avatar, shell, autostart times, dotfiles URL) are not currently supported in Coder OSS [(#3506)](https://github.com/coder/coder/issues/3506). +User-wide settings (e.g. avatar, shell, autostart times, dotfiles URL) are not +currently supported in Coder OSS +[(#3506)](https://github.com/coder/coder/issues/3506). ### Workspaces -To migrate Coder v1 workspaces, you'll need at least one [template](https://coder.com/docs/coder-oss/latest/templates) -in your Coder OSS deployment, specifically with the image(s) you support in Coder v1. +To migrate Coder v1 workspaces, you'll need at least one +[template](https://coder.com/docs/coder-oss/latest/templates) in your Coder OSS +deployment, specifically with the image(s) you support in Coder v1. -> If you are interested in a bulk user and/or workspace migration utility, [we'd like to -> hear from you](https://coder.com/contact). +> If you are interested in a bulk user and/or workspace migration utility, +> [we'd like to hear from you](https://coder.com/contact). -From there, we recommend manually creating a workspace in Coder OSS and using a utility such as `scp` or `rsync` to copy the home directory from your v1 workspace. +From there, we recommend manually creating a workspace in Coder OSS and using a +utility such as `scp` or `rsync` to copy the home directory from your v1 +workspace. ```sh # Inside a Coder v1 workspace terminal (e.g. coder-v1.example.com) @@ -144,51 +174,53 @@ rsync \ $HOME/. coder.$CODER_WORKSPACE_NAME:/home/coder/. ``` -| | Coder v1 | Coder OSS | -| - | - | - | -| **Kubernetes workspaces** | ✅ Hardcoded spec | ✅ Any spec via the [template](https://github.com/coder/coder/tree/main/examples/templates/kubernetes-multi-service) | -| **Docker workspaces** | ✅ Hardcoded spec | ✅ Any spec via the Terraform [template](https://coder.com/docs/coder-oss/latest/templates) | -| **VM workspaces** | [EC2 containers only](https://coder.com/docs/coder/latest/admin/workspace-providers/deployment/ec2#prerequisites) | ✅ Any spec via the Terraform [template](https://coder.com/docs/coder-oss/latest/templates) | -| **Linux workspaces** | ✅ | ✅ | -| **Windows workspaces** | ✅ | ✅ | -| **macOS workspaces** | ❌ | ✅ | -| **ARM workspaces** | ❌ | ✅ | -| **Additional resources in workspace (volume mounts, API keys, etc)** | ❌ | ✅ Any [Terraform resource](https:///registry.terraform.io) | -| **Workspace options** | ✅ Hardcoded options | ✅ Any options via [template parameters](https://coder.com/docs/coder-oss/latest/templates#parameters) | -| **Edit workspace** | ✅ | ⌛ [#802](https://github.com/coder/coder/issues/802) | -| **Resource provisoning rates** | ✅ Organization wide | ✅ Template wide [(needs docs)](https://github.com/coder/coder/issues/3519) | -| **Delete workspace** | ✅ | ✅ | - -Something missing, or have feedback? [Let us know](https://coder.com/contact) +| | Coder v1 | Coder OSS | +| -------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- | +| **Kubernetes workspaces** | ✅ Hardcoded spec | ✅ Any spec via the [template](https://github.com/coder/coder/tree/main/examples/templates/kubernetes-multi-service) | +| **Docker workspaces** | ✅ Hardcoded spec | ✅ Any spec via the Terraform [template](https://coder.com/docs/coder-oss/latest/templates) | +| **VM workspaces** | [EC2 containers only](https://coder.com/docs/coder/latest/admin/workspace-providers/deployment/ec2#prerequisites) | ✅ Any spec via the Terraform [template](https://coder.com/docs/coder-oss/latest/templates) | +| **Linux workspaces** | ✅ | ✅ | +| **Windows workspaces** | ✅ | ✅ | +| **macOS workspaces** | ❌ | ✅ | +| **ARM workspaces** | ❌ | ✅ | +| **Additional resources in workspace (volume mounts, API keys, etc)** | ❌ | ✅ Any [Terraform resource](https:///registry.terraform.io) | +| **Workspace options** | ✅ Hardcoded options | ✅ Any options via [template parameters](https://coder.com/docs/coder-oss/latest/templates#parameters) | +| **Edit workspace** | ✅ | ⌛ [#802](https://github.com/coder/coder/issues/802) | +| **Resource provisoning rates** | ✅ Organization wide | ✅ Template wide [(needs docs)](https://github.com/coder/coder/issues/3519) | +| **Delete workspace** | ✅ | ✅ | + +Something missing, or have feedback? +[Let us know](https://coder.com/contact) ### Developer experience -| | Coder v1 | Coder OSS | -| - | - | - | -| **Auto-start workspace (schedule)** | ✅ | ✅ | -| **Auto-start workspace (SSH or visit app)** | ❌ | 🤔 [#2909](https://github.com/coder/coder/issues/2909) | -| **Code via web terminal** | ✅ | ✅ | -| **Code via code-server (Code Web)** | ✅ Hardcoded version | ✅ Any version [via the template](https://coder.com/docs/coder-oss/latest/ides/web-ides#code-server) | -| **Code via JetBrains Projector (web)** | ✅ Hardcoded version | ✅ Any version [via the template](https://coder.com/docs/coder-oss/latest/ides/web-ides#jetbrains-projector) | -| **Code via SSH (VS Code Remote, JetBrains Gateway)** | ✅ With [coder-cli](https://github.com/coder/coder-cli) installed | ✅ With [coder](https://coder.com/docs/coder-oss/latest/install) installed | -| **Custom workspace applications** | ✅ | ✅ Defined in [templates](https://coder.com/docs/coder-oss/latest/templates#coder-apps) | -| **Access ports (SSH/tunnel)** | ✅ | ✅ | -| **Access ports (web UI)** | ✅ [Dev URLs](https://coder.com/docs/coder/latest/workspaces/devurls) | ⌛ [(#1624)](https://github.com/coder/coder/issues/1624) | -| **Share ports (web UI)** | ✅ [Dev URLs](https://coder.com/docs/coder/latest/workspaces/devurls) | ⌛ [(#3515)](https://github.com/coder/coder/issues/3515) | - -Something missing, or have feedback? [Let us know](https://coder.com/contact) - - -### Enterprise/management - -| | Coder v1 | Coder OSS | -| - | - | - | -| **Auto-stop workspace** | ✅ Activity-based | ✅ Schedule-based ⌛ Activity-based [(#2995)](https://github.com/coder/coder/issues/2995) | -| **Audit logging** | ✅ | ⌛ [#3251](https://github.com/coder/coder/issues/3251) | -| **Organizations** | ✅ | ❌ | -| **User metrics** | ✅ | Some via Prometheus export [(needs docs)](https://github.com/coder/coder/issues/3520) | -| **Resource limits/quotas** | ✅ | ⌛ [#2988](https://github.com/coder/coder/issues/2988) | -| **SDK** | ✅ | ✅ [codersdk](https://github.com/coder/coder/tree/main/codersdk) | -| **REST API** | ✅ | 🤔 [(needs docs)](https://github.com/coder/coder/issues/3522) | - -Something missing, or have feedback? [Let us know](https://coder.com/contact) \ No newline at end of file +| | Coder v1 | Coder OSS | +| ---------------------------------------------------- | --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ | +| **Auto-start workspace (schedule)** | ✅ | ✅ | +| **Auto-start workspace (SSH or visit app)** | ❌ | 🤔 [#2909](https://github.com/coder/coder/issues/2909) | +| **Code via web terminal** | ✅ | ✅ | +| **Code via code-server (Code Web)** | ✅ Hardcoded version | ✅ Any version [via the template](https://coder.com/docs/coder-oss/latest/ides/web-ides#code-server) | +| **Code via JetBrains Projector (web)** | ✅ Hardcoded version | ✅ Any version [via the template](https://coder.com/docs/coder-oss/latest/ides/web-ides#jetbrains-projector) | +| **Code via SSH (VS Code Remote, JetBrains Gateway)** | ✅ With [coder-cli](https://github.com/coder/coder-cli) installed | ✅ With [coder](https://coder.com/docs/coder-oss/latest/install) installed | +| **Custom workspace applications** | ✅ | ✅ Defined in [templates](https://coder.com/docs/coder-oss/latest/templates#coder-apps) | +| **Access ports (SSH/tunnel)** | ✅ | ✅ | +| **Access ports (web UI)** | ✅ [Dev URLs](https://coder.com/docs/coder/latest/workspaces/devurls) | ⌛ [(#1624)](https://github.com/coder/coder/issues/1624) | +| **Share ports (web UI)** | ✅ [Dev URLs](https://coder.com/docs/coder/latest/workspaces/devurls) | ⌛ [(#3515)](https://github.com/coder/coder/issues/3515) | + +Something missing, or have feedback? +[Let us know](https://coder.com/contact) + +### Enterprise/management + +| | Coder v1 | Coder OSS | +| -------------------------- | ----------------- | ----------------------------------------------------------------------------------------- | +| **Auto-stop workspace** | ✅ Activity-based | ✅ Schedule-based ⌛ Activity-based [(#2995)](https://github.com/coder/coder/issues/2995) | +| **Audit logging** | ✅ | ⌛ [#3251](https://github.com/coder/coder/issues/3251) | +| **Organizations** | ✅ | ❌ | +| **User metrics** | ✅ | Some via Prometheus export [(needs docs)](https://github.com/coder/coder/issues/3520) | +| **Resource limits/quotas** | ✅ | ⌛ [#2988](https://github.com/coder/coder/issues/2988) | +| **SDK** | ✅ | ✅ [codersdk](https://github.com/coder/coder/tree/main/codersdk) | +| **REST API** | ✅ | 🤔 [(needs docs)](https://github.com/coder/coder/issues/3522) | + +Something missing, or have feedback? +[Let us know](https://coder.com/contact) From 39da80ae403de5a0afa3c0d5b9de32b946008d10 Mon Sep 17 00:00:00 2001 From: Ben Date: Tue, 16 Aug 2022 11:20:56 +0000 Subject: [PATCH 07/19] include CVMs --- guides/moving-to-oss.md | 1 + 1 file changed, 1 insertion(+) diff --git a/guides/moving-to-oss.md b/guides/moving-to-oss.md index f4c967862..6a6b7bd6c 100644 --- a/guides/moving-to-oss.md +++ b/guides/moving-to-oss.md @@ -206,6 +206,7 @@ rsync \ | **Access ports (SSH/tunnel)** | ✅ | ✅ | | **Access ports (web UI)** | ✅ [Dev URLs](https://coder.com/docs/coder/latest/workspaces/devurls) | ⌛ [(#1624)](https://github.com/coder/coder/issues/1624) | | **Share ports (web UI)** | ✅ [Dev URLs](https://coder.com/docs/coder/latest/workspaces/devurls) | ⌛ [(#3515)](https://github.com/coder/coder/issues/3515) | +| **Docker in workspaces (Kubernetes)** | ✅ [CVMs](https://coder.com/docs/coder/latest/workspaces/cvms) | ⌛ [(needs docs)](https://github.com/coder/coder/issues/3376) | Something missing, or have feedback? [Let us know](https://coder.com/contact) From 120ffffaebfe1fe51beab9e21610be81f20af46d Mon Sep 17 00:00:00 2001 From: Ben Date: Tue, 16 Aug 2022 11:23:15 +0000 Subject: [PATCH 08/19] changes from mark feedback --- guides/moving-to-oss.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guides/moving-to-oss.md b/guides/moving-to-oss.md index 6a6b7bd6c..2990573ea 100644 --- a/guides/moving-to-oss.md +++ b/guides/moving-to-oss.md @@ -26,7 +26,7 @@ comparison table before you proceed. | **Supported IDEs** | Web IDEs (code-server, Jupyter) + SSH-powered desktop IDEs (e.g. VS Code, JetBrains) | Same as Coder v1 | | **Provisioner** | Provisions workspaces on Kubernetes with hardcoded spec (pod + home volume) | Provisions workspaces via [Terraform](https://terraform.io). Supports any resource (e.g. Windows VM, Kubernetes pod) | | **Template** | Optional YAML [configuration syntax](https://coder.com/docs/coder/latest/admin/templates) for workspaces. Managed by Coder admins or git/CI | [Terraform code](https://coder.com/docs/coder-oss/latest/templates) that defines workspace specs. Managed by Coder admins or git/CI | -| **Image** | Container image for workspace, contains dev tools and dependencies | Often included in [the template](https://coder.com/docs/coder-oss/latest/templates) | +| **Image** | Container image for workspace, contains dev tools and dependencies | Container and VM image included in [the template](https://coder.com/docs/coder-oss/latest/templates) | | **Workspace options** | CPU, RAM, GPU, disk size, image name, CVM (on/off), dotfiles | Defined as variables in [the template](https://coder.com/docs/coder-oss/latest/templates) | | **Deployment methods** | Kubernetes, Docker | Kubernetes, Docker, VM, or bare metal | | **Architecture** | Control plane + PostgreSQL database + workspaces | Same as Coder v1 | From d9f1b33a1c0dc650e08fc43fe8203c643f0a20cb Mon Sep 17 00:00:00 2001 From: Ben Date: Wed, 17 Aug 2022 20:50:51 +0000 Subject: [PATCH 09/19] fixes from Ali feedback --- guides/moving-to-oss.md | 48 ++++++++++++++++++++++++----------------- 1 file changed, 28 insertions(+), 20 deletions(-) diff --git a/guides/moving-to-oss.md b/guides/moving-to-oss.md index 2990573ea..bd4166a5f 100644 --- a/guides/moving-to-oss.md +++ b/guides/moving-to-oss.md @@ -3,15 +3,14 @@ title: "Moving to Coder OSS Beta" description: What you need to know about Coder OSS --- -Coder OSS (also referred to as [Coder OSS](https://github.com/coder/coder)) is -Coder's open core remote development platform first launched in June 2022. This -document shares best practices for moving your workflows from Coder v1 to Coder -OSS. +[Coder OSS](https://github.com/coder/coder)) is Coder's open core remote +development platform first launched in June 2022. This document shares best +practices for moving your workflows from Coder v1 to Coder OSS. ![Coder OSS Dashboard](https://raw.githubusercontent.com/coder/coder/main/docs/images/hero-image.png) -> If you are current Coder v1 customer and to try Coder OSS, +> If you are current a Coder v1 customer and would like to try Coder OSS, > [we'd like to hear from you](https://coder.com/contact) to help inform our > roadmap and migration strategy. @@ -47,9 +46,8 @@ features (e.g. Windows support, dynamic secrets, faster builds). ### Feature list key -Please comment on any issues in the -[coder/coder](https://github.com/coder/coder) repo or -[contact us](https://coder.com/contact) if they are important to you. +Each of the following features have open issues on coder/coder - if they're a +priority for your team, please chime in on the GitHub issue. ✅ = Complete @@ -69,6 +67,8 @@ on a VM to avoid setting up a database, reverse proxy, and TLS. For production use, we recommend running Coder with an external PostgresSQL database and a reverse proxy for TLS. +- [Installing Coder OSS](https://coder.com/docs/coder-oss/latest/install) + | | Coder v1 | Coder OSS | | --------------------------------------- | -------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Kubernetes | ✅ Helm chart | ⌛ Helm chart [(needs docs)](https://github.com/coder/coder/issues/3224) | @@ -86,9 +86,7 @@ database and a reverse proxy for TLS. | **Multi region/cloud (dashboard)** | ✅ Multi-region [satellites](https://coder.com/docs/coder/latest/admin/satellites) for faster IDE connections. | ⌛ [#3227](https://github.com/coder/coder/issues/3227) | | **Multi region/cloud (tunnel/SSH)** | ✅ [Direct connections via STUN](https://coder.com/docs/coder/latest/admin/stun) | ✅ Direct connections via STUN ([configuration flag](https://coder.com/docs/coder-oss/latest/install/configure)) | -See the Coder OSS -[installation docs](https://coder.com/docs/coder-oss/latest/install) for more -details. Something missing, or have feedback? +Something missing, or have feedback? [Let us know](https://coder.com/contact) ### CLI @@ -138,20 +136,21 @@ currently supported in Coder OSS ### Workspaces -To migrate Coder v1 workspaces, you'll need at least one -[template](https://coder.com/docs/coder-oss/latest/templates) in your Coder OSS -deployment, specifically with the image(s) you support in Coder v1. - > If you are interested in a bulk user and/or workspace migration utility, > [we'd like to hear from you](https://coder.com/contact). -From there, we recommend manually creating a workspace in Coder OSS and using a -utility such as `scp` or `rsync` to copy the home directory from your v1 -workspace. +To migrate Coder v1 workspaces, you'll need at least one template in your Coder +OSS deployment, specifically with the image(s) you support in Coder v1. -```sh -# Inside a Coder v1 workspace terminal (e.g. coder-v1.example.com) +- Docs: [Adding templates](https://coder.com/docs/coder-oss/latest/templates) + +We recommend manually creating a new workspace in Coder OSS and using a utility +such as `scp` or `rsync` to copy the home directory from your v1 workspace. +You can run the following commands inside a Coder v1 workspace to create a Coder +OSS workspace and migrate your files: + +```sh # Download the Coder OSS CLI (alias "codeross") curl -sL https://coder.com/install.sh | sh -s -- --method=standalone --binary-name=codeross > /dev/null @@ -174,6 +173,9 @@ rsync \ $HOME/. coder.$CODER_WORKSPACE_NAME:/home/coder/. ``` +Some workspace-level features are different in Coder OSS. Refer to this +comparison: + | | Coder v1 | Coder OSS | | -------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- | | **Kubernetes workspaces** | ✅ Hardcoded spec | ✅ Any spec via the [template](https://github.com/coder/coder/tree/main/examples/templates/kubernetes-multi-service) | @@ -194,6 +196,9 @@ rsync \ ### Developer experience +Some developer experience features are different, or still being worked on in +Coder OSS. Refer to this table: + | | Coder v1 | Coder OSS | | ---------------------------------------------------- | --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ | | **Auto-start workspace (schedule)** | ✅ | ✅ | @@ -213,6 +218,9 @@ rsync \ ### Enterprise/management +Some enterprise features are different, or still being worked on in Coder OSS. +Refer to this table: + | | Coder v1 | Coder OSS | | -------------------------- | ----------------- | ----------------------------------------------------------------------------------------- | | **Auto-stop workspace** | ✅ Activity-based | ✅ Schedule-based ⌛ Activity-based [(#2995)](https://github.com/coder/coder/issues/2995) | From fccd2b764d6594b58749d8fb21ee40885f221f30 Mon Sep 17 00:00:00 2001 From: Ben Potter Date: Fri, 9 Sep 2022 12:45:40 -0500 Subject: [PATCH 10/19] Update guides/moving-to-oss.md Co-authored-by: Ammar Bandukwala --- guides/moving-to-oss.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guides/moving-to-oss.md b/guides/moving-to-oss.md index bd4166a5f..f94ea7c1f 100644 --- a/guides/moving-to-oss.md +++ b/guides/moving-to-oss.md @@ -3,7 +3,7 @@ title: "Moving to Coder OSS Beta" description: What you need to know about Coder OSS --- -[Coder OSS](https://github.com/coder/coder)) is Coder's open core remote +[Coder OSS](https://github.com/coder/coder) is Coder's open core remote development platform first launched in June 2022. This document shares best practices for moving your workflows from Coder v1 to Coder OSS. From 97e1382257ca7ab5b7cee080634da1b82821aa2a Mon Sep 17 00:00:00 2001 From: Ben Date: Fri, 9 Sep 2022 17:48:47 +0000 Subject: [PATCH 11/19] remove link to tunnel --- guides/moving-to-oss.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/guides/moving-to-oss.md b/guides/moving-to-oss.md index bd4166a5f..3654fb8c7 100644 --- a/guides/moving-to-oss.md +++ b/guides/moving-to-oss.md @@ -3,7 +3,7 @@ title: "Moving to Coder OSS Beta" description: What you need to know about Coder OSS --- -[Coder OSS](https://github.com/coder/coder)) is Coder's open core remote +[Coder OSS](https://github.com/coder/coder) is Coder's open core remote development platform first launched in June 2022. This document shares best practices for moving your workflows from Coder v1 to Coder OSS. @@ -36,7 +36,7 @@ comparison table before you proceed. ## Migration Strategy A seperate deployment is necessary to run Coder OSS. A direct upgrade via Helm -is not possible since Coder OSS introduces new concepts (e.g. templates, +is not possible since Coder OSS redefines some concepts (e.g. templates, provisioners) and other features are still being developed (e.g. audit log, organization support). @@ -77,7 +77,6 @@ database and a reverse proxy for TLS. | Docker deployment | ✅ | ✅ | | VM deployment | ❌ | ✅ [system packages](https://coder.com/docs/coder-oss/latest/install#system-packages) and [prebuilt binaries](https://coder.com/docs/coder-oss/latest/install#manual) | | Built-in PostgreSQL | ✅ | ✅ | -| Built-in TLS tunnel | ❌ | ✅ | | External PostgreSQL support | ✅ | ✅ ([configuration flag](https://coder.com/docs/coder-oss/latest/install/configure)) | | External TLS documentation | ✅ (via [cert-manager](https://coder.com/docs/coder/latest/guides/tls-certificates)) | ⌛ [#3518](https://github.com/coder/coder/issues/3518) | | **Multi region/cloud (workspaces)** | ✅ [Workspace providers](https://coder.com/docs/coder/latest/admin/workspace-providers) support additional clusters. | ✅ [Templates](https://coder.com/docs/coder/latest/admin/templates) can provision resources in any clouds, clusters, or region | From fe117ffe880459086623973b666d3ae07d2f3f1e Mon Sep 17 00:00:00 2001 From: Ben Date: Fri, 9 Sep 2022 17:55:49 +0000 Subject: [PATCH 12/19] fixes from Spike feedback --- guides/moving-to-oss.md | 1 - 1 file changed, 1 deletion(-) diff --git a/guides/moving-to-oss.md b/guides/moving-to-oss.md index 3654fb8c7..d9c6ab85e 100644 --- a/guides/moving-to-oss.md +++ b/guides/moving-to-oss.md @@ -80,7 +80,6 @@ database and a reverse proxy for TLS. | External PostgreSQL support | ✅ | ✅ ([configuration flag](https://coder.com/docs/coder-oss/latest/install/configure)) | | External TLS documentation | ✅ (via [cert-manager](https://coder.com/docs/coder/latest/guides/tls-certificates)) | ⌛ [#3518](https://github.com/coder/coder/issues/3518) | | **Multi region/cloud (workspaces)** | ✅ [Workspace providers](https://coder.com/docs/coder/latest/admin/workspace-providers) support additional clusters. | ✅ [Templates](https://coder.com/docs/coder/latest/admin/templates) can provision resources in any clouds, clusters, or region | -| **Multi region/cloud (provisioning)** | ❌ | ⌛ [#44](https://github.com/coder/coder/issues/44) | | **Multi region/cloud (authentication)** | ✅ Authenticates to clusters via secrets stored in the database | ✅ Authenticates via Terraform provider and [provisioner](https://coder.com/docs/coder-oss/latest/architecture) environment | | **Multi region/cloud (dashboard)** | ✅ Multi-region [satellites](https://coder.com/docs/coder/latest/admin/satellites) for faster IDE connections. | ⌛ [#3227](https://github.com/coder/coder/issues/3227) | | **Multi region/cloud (tunnel/SSH)** | ✅ [Direct connections via STUN](https://coder.com/docs/coder/latest/admin/stun) | ✅ Direct connections via STUN ([configuration flag](https://coder.com/docs/coder-oss/latest/install/configure)) | From 8501488fbec4fa69539a1849892b0fda7ee550f4 Mon Sep 17 00:00:00 2001 From: Ben Date: Fri, 9 Sep 2022 17:56:46 +0000 Subject: [PATCH 13/19] remove beta --- guides/moving-to-oss.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guides/moving-to-oss.md b/guides/moving-to-oss.md index d9c6ab85e..a3a402d0e 100644 --- a/guides/moving-to-oss.md +++ b/guides/moving-to-oss.md @@ -1,5 +1,5 @@ --- -title: "Moving to Coder OSS Beta" +title: "Moving to Coder OSS" description: What you need to know about Coder OSS --- From 71e1face68556db80ccd42aacd0eaea2bcc58af6 Mon Sep 17 00:00:00 2001 From: Ben Date: Fri, 9 Sep 2022 17:59:51 +0000 Subject: [PATCH 14/19] fixes from mtm feedback --- guides/moving-to-oss.md | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/guides/moving-to-oss.md b/guides/moving-to-oss.md index a3a402d0e..7b4119e6c 100644 --- a/guides/moving-to-oss.md +++ b/guides/moving-to-oss.md @@ -19,16 +19,16 @@ Dashboard](https://raw.githubusercontent.com/coder/coder/main/docs/images/hero-i Coder OSS introduces a number of new paradigms. We recommend reading the comparison table before you proceed. -| | Coder v1 | Coder OSS | -| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | -| **Workspace** | Each user creates and develops on remote workspaces | Same as Coder v1 | -| **Supported IDEs** | Web IDEs (code-server, Jupyter) + SSH-powered desktop IDEs (e.g. VS Code, JetBrains) | Same as Coder v1 | -| **Provisioner** | Provisions workspaces on Kubernetes with hardcoded spec (pod + home volume) | Provisions workspaces via [Terraform](https://terraform.io). Supports any resource (e.g. Windows VM, Kubernetes pod) | -| **Template** | Optional YAML [configuration syntax](https://coder.com/docs/coder/latest/admin/templates) for workspaces. Managed by Coder admins or git/CI | [Terraform code](https://coder.com/docs/coder-oss/latest/templates) that defines workspace specs. Managed by Coder admins or git/CI | -| **Image** | Container image for workspace, contains dev tools and dependencies | Container and VM image included in [the template](https://coder.com/docs/coder-oss/latest/templates) | -| **Workspace options** | CPU, RAM, GPU, disk size, image name, CVM (on/off), dotfiles | Defined as variables in [the template](https://coder.com/docs/coder-oss/latest/templates) | -| **Deployment methods** | Kubernetes, Docker | Kubernetes, Docker, VM, or bare metal | -| **Architecture** | Control plane + PostgreSQL database + workspaces | Same as Coder v1 | +| | Coder v1 | Coder OSS | +| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | +| **Workspace** | Each user creates and develops on remote workspaces | Same as Coder v1 | +| **Supported IDEs** | Web IDEs (code-server, Jupyter) + SSH-powered desktop IDEs (e.g. VS Code, JetBrains) | Same as Coder v1 | +| **Provisioner** | Provisions workspaces on Kubernetes with hardcoded spec (pod + home volume) | Provisions workspaces via [Terraform](https://terraform.io). Supports any resource (e.g. VM, Kubernetes, Docker) | +| **Template** | Optional YAML [configuration syntax](https://coder.com/docs/coder/latest/admin/templates) for workspaces. Managed by Coder admins or git/CI | [Terraform code](https://coder.com/docs/coder-oss/latest/templates) that defines workspace specs. Managed by Coder admins or git/CI | +| **Image** | Container image for workspace, contains dev tools and dependencies | Container and VM image included in [the template](https://coder.com/docs/coder-oss/latest/templates) with dev tools and dependencies | +| **Workspace options** | CPU, RAM, GPU, disk size, image name, CVM (on/off), dotfiles | Defined as variables in [the template](https://coder.com/docs/coder-oss/latest/templates) | +| **Deployment methods** | Kubernetes, Docker | Kubernetes, Docker, VM, or bare metal | +| **Architecture** | Control plane + PostgreSQL database + workspaces | Same as Coder v1 | Keep reading for an in-depth feature comparison. Also see the [Coder OSS documentation](https://coder.com/docs/coder-oss/) From 7d17b01e7e7f1428e4fb3715976e4c5adc43a05c Mon Sep 17 00:00:00 2001 From: Ben Date: Fri, 9 Sep 2022 18:18:20 +0000 Subject: [PATCH 15/19] changes from mtm feedback --- guides/moving-to-oss.md | 39 ++++++++++++++++++--------------------- 1 file changed, 18 insertions(+), 21 deletions(-) diff --git a/guides/moving-to-oss.md b/guides/moving-to-oss.md index 7b4119e6c..0dc7c7b09 100644 --- a/guides/moving-to-oss.md +++ b/guides/moving-to-oss.md @@ -35,14 +35,14 @@ comparison table before you proceed. ## Migration Strategy -A seperate deployment is necessary to run Coder OSS. A direct upgrade via Helm -is not possible since Coder OSS redefines some concepts (e.g. templates, +A separate control plane is necessary to run Coder OSS. A direct upgrade via +Helm is not possible since Coder OSS redefines some concepts (e.g. templates, provisioners) and other features are still being developed (e.g. audit log, organization support). -Short term, we recommend keeping your Coder v1 deployment and inviting a pilot -group to your Coder OSS deployment to reproduce their workflows and try new -features (e.g. Windows support, dynamic secrets, faster builds). +Short term, we recommend keeping your Coder v1 control plane and inviting a +pilot group to your Coder OSS control plane to reproduce their workflows and try +new features (e.g. Windows support, dynamic secrets, faster builds). ### Feature list key @@ -69,27 +69,25 @@ database and a reverse proxy for TLS. - [Installing Coder OSS](https://coder.com/docs/coder-oss/latest/install) -| | Coder v1 | Coder OSS | -| --------------------------------------- | -------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Kubernetes | ✅ Helm chart | ⌛ Helm chart [(needs docs)](https://github.com/coder/coder/issues/3224) | -| Kubernetes (HA/multiple replicas) | ✅ | ⌛ [#3502](https://github.com/coder/coder/issues/3502) | -| Kubernetes (built-in database) | ✅ | ❌ | -| Docker deployment | ✅ | ✅ | -| VM deployment | ❌ | ✅ [system packages](https://coder.com/docs/coder-oss/latest/install#system-packages) and [prebuilt binaries](https://coder.com/docs/coder-oss/latest/install#manual) | -| Built-in PostgreSQL | ✅ | ✅ | -| External PostgreSQL support | ✅ | ✅ ([configuration flag](https://coder.com/docs/coder-oss/latest/install/configure)) | -| External TLS documentation | ✅ (via [cert-manager](https://coder.com/docs/coder/latest/guides/tls-certificates)) | ⌛ [#3518](https://github.com/coder/coder/issues/3518) | -| **Multi region/cloud (workspaces)** | ✅ [Workspace providers](https://coder.com/docs/coder/latest/admin/workspace-providers) support additional clusters. | ✅ [Templates](https://coder.com/docs/coder/latest/admin/templates) can provision resources in any clouds, clusters, or region | -| **Multi region/cloud (authentication)** | ✅ Authenticates to clusters via secrets stored in the database | ✅ Authenticates via Terraform provider and [provisioner](https://coder.com/docs/coder-oss/latest/architecture) environment | -| **Multi region/cloud (dashboard)** | ✅ Multi-region [satellites](https://coder.com/docs/coder/latest/admin/satellites) for faster IDE connections. | ⌛ [#3227](https://github.com/coder/coder/issues/3227) | -| **Multi region/cloud (tunnel/SSH)** | ✅ [Direct connections via STUN](https://coder.com/docs/coder/latest/admin/stun) | ✅ Direct connections via STUN ([configuration flag](https://coder.com/docs/coder-oss/latest/install/configure)) | +| | Coder v1 | Coder OSS | +| -------------------------------------- | -------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | +| Kubernetes | ✅ Helm chart | ⌛ Helm chart [(needs docs)](https://github.com/coder/coder/issues/3224) | +| Kubernetes (HA/multiple replicas) | ✅ | ⌛ [#3502](https://github.com/coder/coder/issues/3502) | +| Docker control plane | ✅ | ✅ | +| VM control plane | ❌ | ✅ | +| Built-in PostgreSQL | ✅ | ✅ | +| External PostgreSQL support | ✅ | ✅ | +| External TLS documentation | ✅ | ⌛ [#3518](https://github.com/coder/coder/issues/3518) | +| **Multi region/cloud (control plane)** | ✅ Multi-region [satellites](https://coder.com/docs/coder/latest/admin/satellites) for faster IDE connections. | ⌛ [#3227](https://github.com/coder/coder/issues/3227) | +| **Multi region/cloud (workspaces)** | ✅ [Workspace providers](https://coder.com/docs/coder/latest/admin/workspace-providers) support additional clusters. | ✅ [Templates](https://coder.com/docs/coder/latest/admin/templates) can provision resources in any clouds, clusters, or region | +| **Multi region/cloud (tunnel/SSH)** | ✅ | ✅ | Something missing, or have feedback? [Let us know](https://coder.com/contact) ### CLI -Coder OSS uses a seperate +Coder OSS uses a separate [command line utility](https://coder.com/docs/coder-oss/latest/install). To use both CLIs on the same machine, you can install the Coder OSS CLI under a different name (e.g. `codeross`): @@ -118,7 +116,6 @@ authentication. | | Coder v1 | Coder OSS | | ----------------- | -------- | ----------------------------------------------------------------------------------------------- | -| Avatar | ✅ | ❌ | | Dotfiles | ✅ | Per-workspace [(dotfiles docs)](https://coder.com/docs/coder-oss/latest/dotfiles) | | Generated SSH key | ✅ | ✅ | | Default shell | ✅ | Per-workspace [(with parameters)](https://coder.com/docs/coder-oss/latest/templates#parameters) | From 3fcb84f71f1b7bc5c05744849f3d9687a8a489de Mon Sep 17 00:00:00 2001 From: Ben Date: Fri, 9 Sep 2022 18:18:39 +0000 Subject: [PATCH 16/19] remove avatar --- guides/moving-to-oss.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/guides/moving-to-oss.md b/guides/moving-to-oss.md index 0dc7c7b09..9e2b1cb9a 100644 --- a/guides/moving-to-oss.md +++ b/guides/moving-to-oss.md @@ -125,9 +125,8 @@ authentication. Something missing, or have feedback? [Let us know](https://coder.com/contact) -User-wide settings (e.g. avatar, shell, autostart times, dotfiles URL) are not -currently supported in Coder OSS -[(#3506)](https://github.com/coder/coder/issues/3506). +User-wide settings (e.g. shell, autostart times, dotfiles URL) are not currently +supported in Coder OSS [(#3506)](https://github.com/coder/coder/issues/3506). ### Workspaces From 27f130af1e92cbb8e0a50e72ca7db095b4cbfc1c Mon Sep 17 00:00:00 2001 From: Ben Date: Fri, 9 Sep 2022 18:21:56 +0000 Subject: [PATCH 17/19] clarify instructions for rsync --- guides/moving-to-oss.md | 35 +++++++++++++++++++---------------- 1 file changed, 19 insertions(+), 16 deletions(-) diff --git a/guides/moving-to-oss.md b/guides/moving-to-oss.md index 9e2b1cb9a..f8e63d3e6 100644 --- a/guides/moving-to-oss.md +++ b/guides/moving-to-oss.md @@ -141,8 +141,11 @@ OSS deployment, specifically with the image(s) you support in Coder v1. We recommend manually creating a new workspace in Coder OSS and using a utility such as `scp` or `rsync` to copy the home directory from your v1 workspace. -You can run the following commands inside a Coder v1 workspace to create a Coder -OSS workspace and migrate your files: +Inside a v1 workspace, run the following commands to: + +1. Download the Coder OSS CLI +1. Create a Coder OSS workspace +1. rsync your files to the new workspace ```sh # Download the Coder OSS CLI (alias "codeross") @@ -170,20 +173,20 @@ rsync \ Some workspace-level features are different in Coder OSS. Refer to this comparison: -| | Coder v1 | Coder OSS | -| -------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- | -| **Kubernetes workspaces** | ✅ Hardcoded spec | ✅ Any spec via the [template](https://github.com/coder/coder/tree/main/examples/templates/kubernetes-multi-service) | -| **Docker workspaces** | ✅ Hardcoded spec | ✅ Any spec via the Terraform [template](https://coder.com/docs/coder-oss/latest/templates) | -| **VM workspaces** | [EC2 containers only](https://coder.com/docs/coder/latest/admin/workspace-providers/deployment/ec2#prerequisites) | ✅ Any spec via the Terraform [template](https://coder.com/docs/coder-oss/latest/templates) | -| **Linux workspaces** | ✅ | ✅ | -| **Windows workspaces** | ✅ | ✅ | -| **macOS workspaces** | ❌ | ✅ | -| **ARM workspaces** | ❌ | ✅ | -| **Additional resources in workspace (volume mounts, API keys, etc)** | ❌ | ✅ Any [Terraform resource](https:///registry.terraform.io) | -| **Workspace options** | ✅ Hardcoded options | ✅ Any options via [template parameters](https://coder.com/docs/coder-oss/latest/templates#parameters) | -| **Edit workspace** | ✅ | ⌛ [#802](https://github.com/coder/coder/issues/802) | -| **Resource provisoning rates** | ✅ Organization wide | ✅ Template wide [(needs docs)](https://github.com/coder/coder/issues/3519) | -| **Delete workspace** | ✅ | ✅ | +| | Coder v1 | Coder OSS | +| -------------------------------------------------------------------- | -------------------- | -------------------------------------------------------------------------------------------------------------------- | +| **Kubernetes workspaces** | ✅ Hardcoded spec | ✅ Any spec via the [template](https://github.com/coder/coder/tree/main/examples/templates/kubernetes-multi-service) | +| **Docker workspaces** | ✅ Hardcoded spec | ✅ Any spec via the Terraform [template](https://coder.com/docs/coder-oss/latest/templates) | +| **VM workspaces** | ❌ | ✅ Any spec via the Terraform [template](https://coder.com/docs/coder-oss/latest/templates) | +| **Linux workspaces** | ✅ | ✅ | +| **Windows workspaces** | ✅ | ✅ | +| **macOS workspaces** | ❌ | ✅ | +| **ARM workspaces** | ❌ | ✅ | +| **Additional resources in workspace (volume mounts, API keys, etc)** | ❌ | ✅ Any [Terraform resource](https:///registry.terraform.io) | +| **Workspace options** | ✅ Hardcoded options | ✅ Any options via [template parameters](https://coder.com/docs/coder-oss/latest/templates#parameters) | +| **Edit workspace** | ✅ | ⌛ [#802](https://github.com/coder/coder/issues/802) | +| **Resource provisoning rates** | ✅ Organization wide | ✅ Template wide [(needs docs)](https://github.com/coder/coder/issues/3519) | +| **Delete workspace** | ✅ | ✅ | Something missing, or have feedback? [Let us know](https://coder.com/contact) From 6f8fa63e05174cb142df7f3bb75646c8f6cc38f9 Mon Sep 17 00:00:00 2001 From: Ben Date: Fri, 9 Sep 2022 18:34:46 +0000 Subject: [PATCH 18/19] mtm feedback --- .vscode/settings.json | 5 ++++- guides/moving-to-oss.md | 49 ++++++++++++++++++++++------------------- 2 files changed, 30 insertions(+), 24 deletions(-) diff --git a/.vscode/settings.json b/.vscode/settings.json index 3ac2af607..8da176181 100644 --- a/.vscode/settings.json +++ b/.vscode/settings.json @@ -5,5 +5,8 @@ "editor.codeActionsOnSave": { "source.fixAll.markdownlint": true }, - "rewrap.autoWrap.enabled": true + "rewrap.autoWrap.enabled": true, + "[markdown]": { + "editor.defaultFormatter": "esbenp.prettier-vscode" + } } diff --git a/guides/moving-to-oss.md b/guides/moving-to-oss.md index f8e63d3e6..4988345fb 100644 --- a/guides/moving-to-oss.md +++ b/guides/moving-to-oss.md @@ -183,10 +183,11 @@ comparison: | **macOS workspaces** | ❌ | ✅ | | **ARM workspaces** | ❌ | ✅ | | **Additional resources in workspace (volume mounts, API keys, etc)** | ❌ | ✅ Any [Terraform resource](https:///registry.terraform.io) | -| **Workspace options** | ✅ Hardcoded options | ✅ Any options via [template parameters](https://coder.com/docs/coder-oss/latest/templates#parameters) | +| **Workspace options** | Limited options | ✅ Any options via [template parameters](https://coder.com/docs/coder-oss/latest/templates#parameters) | | **Edit workspace** | ✅ | ⌛ [#802](https://github.com/coder/coder/issues/802) | | **Resource provisoning rates** | ✅ Organization wide | ✅ Template wide [(needs docs)](https://github.com/coder/coder/issues/3519) | | **Delete workspace** | ✅ | ✅ | +| **Manage workspaces through UI and CLI** | ✅ | ✅ | Something missing, or have feedback? [Let us know](https://coder.com/contact) @@ -196,19 +197,21 @@ comparison: Some developer experience features are different, or still being worked on in Coder OSS. Refer to this table: -| | Coder v1 | Coder OSS | -| ---------------------------------------------------- | --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ | -| **Auto-start workspace (schedule)** | ✅ | ✅ | -| **Auto-start workspace (SSH or visit app)** | ❌ | 🤔 [#2909](https://github.com/coder/coder/issues/2909) | -| **Code via web terminal** | ✅ | ✅ | -| **Code via code-server (Code Web)** | ✅ Hardcoded version | ✅ Any version [via the template](https://coder.com/docs/coder-oss/latest/ides/web-ides#code-server) | -| **Code via JetBrains Projector (web)** | ✅ Hardcoded version | ✅ Any version [via the template](https://coder.com/docs/coder-oss/latest/ides/web-ides#jetbrains-projector) | -| **Code via SSH (VS Code Remote, JetBrains Gateway)** | ✅ With [coder-cli](https://github.com/coder/coder-cli) installed | ✅ With [coder](https://coder.com/docs/coder-oss/latest/install) installed | -| **Custom workspace applications** | ✅ | ✅ Defined in [templates](https://coder.com/docs/coder-oss/latest/templates#coder-apps) | -| **Access ports (SSH/tunnel)** | ✅ | ✅ | -| **Access ports (web UI)** | ✅ [Dev URLs](https://coder.com/docs/coder/latest/workspaces/devurls) | ⌛ [(#1624)](https://github.com/coder/coder/issues/1624) | -| **Share ports (web UI)** | ✅ [Dev URLs](https://coder.com/docs/coder/latest/workspaces/devurls) | ⌛ [(#3515)](https://github.com/coder/coder/issues/3515) | -| **Docker in workspaces (Kubernetes)** | ✅ [CVMs](https://coder.com/docs/coder/latest/workspaces/cvms) | ⌛ [(needs docs)](https://github.com/coder/coder/issues/3376) | +| | Coder v1 | Coder OSS | +| ------------------------------------------------------------------- | --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ | +| **Auto-start workspace (schedule)** | ✅ | ✅ | +| **Auto-start workspace (SSH or visit app)** | ❌ | 🤔 [#2909](https://github.com/coder/coder/issues/2909) | +| **Code via web terminal** | ✅ | ✅ | +| **Code via code-server (Code Web)** | ✅ Hardcoded version | ✅ Any version [via the template](https://coder.com/docs/coder-oss/latest/ides/web-ides#code-server) | +| **Code via JetBrains Projector (web)** | ✅ Hardcoded version | ✅ Any version [via the template](https://coder.com/docs/coder-oss/latest/ides/web-ides#jetbrains-projector) | +| **Code with local IDE via SSH (VS Code Remote, JetBrains Gateway)** | ✅ With [coder-cli](https://github.com/coder/coder-cli) installed | ✅ With [coder](https://coder.com/docs/coder-oss/latest/install) installed | +| **Custom workspace applications** | ✅ | ✅ Defined in [templates](https://coder.com/docs/coder-oss/latest/templates#coder-apps) | +| **Access ports (SSH/tunnel)** | ✅ | ✅ | +| **Access ports (web UI)** | ✅ [Dev URLs](https://coder.com/docs/coder/latest/workspaces/devurls) | ⌛ [(#1624)](https://github.com/coder/coder/issues/1624) | +| **Share ports (web UI)** | ✅ [Dev URLs](https://coder.com/docs/coder/latest/workspaces/devurls) | ⌛ [(#3515)](https://github.com/coder/coder/issues/3515) | +| **Docker in workspaces (Kubernetes)** | ✅ [CVMs](https://coder.com/docs/coder/latest/workspaces/cvms) | ⌛ [(needs docs)](https://github.com/coder/coder/issues/3376) | +| **Manage workspaces through UI and CLI** | ✅ | ✅ | +| **Open in Coder button** | ✅ | 🤔 [(needs docs)](https://github.com/coder/coder/issues/3981) | Something missing, or have feedback? [Let us know](https://coder.com/contact) @@ -218,15 +221,15 @@ Coder OSS. Refer to this table: Some enterprise features are different, or still being worked on in Coder OSS. Refer to this table: -| | Coder v1 | Coder OSS | -| -------------------------- | ----------------- | ----------------------------------------------------------------------------------------- | -| **Auto-stop workspace** | ✅ Activity-based | ✅ Schedule-based ⌛ Activity-based [(#2995)](https://github.com/coder/coder/issues/2995) | -| **Audit logging** | ✅ | ⌛ [#3251](https://github.com/coder/coder/issues/3251) | -| **Organizations** | ✅ | ❌ | -| **User metrics** | ✅ | Some via Prometheus export [(needs docs)](https://github.com/coder/coder/issues/3520) | -| **Resource limits/quotas** | ✅ | ⌛ [#2988](https://github.com/coder/coder/issues/2988) | -| **SDK** | ✅ | ✅ [codersdk](https://github.com/coder/coder/tree/main/codersdk) | -| **REST API** | ✅ | 🤔 [(needs docs)](https://github.com/coder/coder/issues/3522) | +| | Coder v1 | Coder OSS | +| ----------------------- | ----------------- | ------------------------------------------------------------------------------------------- | +| **Auto-stop workspace** | ✅ Activity-based | ✅ Schedule-based & ⌛ Activity-based [(#2995)](https://github.com/coder/coder/issues/2995) | +| **Audit logging** | ✅ | ⌛ [#3251](https://github.com/coder/coder/issues/3251) | +| **Organizations** | ✅ | ❌ [#3039](https://github.com/coder/coder/issues/3039) | +| **User metrics** | ✅ | Template-wide metrics [(needs docs)](https://github.com/coder/coder/issues/3980) | +| **Resource quotas** | ✅ | ⌛ [#2988](https://github.com/coder/coder/issues/2988) | +| **SDK** | ❌ | ✅ [codersdk](https://github.com/coder/coder/tree/main/codersdk) | +| **REST API** | ✅ | 🤔 [(needs docs)](https://github.com/coder/coder/issues/3522) | Something missing, or have feedback? [Let us know](https://coder.com/contact) From 6549536aaf694136d41f5ea50006bfd2894f0e5d Mon Sep 17 00:00:00 2001 From: Ben Date: Fri, 9 Sep 2022 18:49:02 +0000 Subject: [PATCH 19/19] updates --- guides/moving-to-oss.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/guides/moving-to-oss.md b/guides/moving-to-oss.md index 4988345fb..ec34d14d1 100644 --- a/guides/moving-to-oss.md +++ b/guides/moving-to-oss.md @@ -120,7 +120,7 @@ authentication. | Generated SSH key | ✅ | ✅ | | Default shell | ✅ | Per-workspace [(with parameters)](https://coder.com/docs/coder-oss/latest/templates#parameters) | | Auto-start times | ✅ | Per-workspace | -| Git OAuth | ✅ | SSH key only | +| Git OAuth | ✅ | SSH key only [(#3078)](https://github.com/coder/coder/issues/3078) | Something missing, or have feedback? [Let us know](https://coder.com/contact) @@ -186,7 +186,6 @@ comparison: | **Workspace options** | Limited options | ✅ Any options via [template parameters](https://coder.com/docs/coder-oss/latest/templates#parameters) | | **Edit workspace** | ✅ | ⌛ [#802](https://github.com/coder/coder/issues/802) | | **Resource provisoning rates** | ✅ Organization wide | ✅ Template wide [(needs docs)](https://github.com/coder/coder/issues/3519) | -| **Delete workspace** | ✅ | ✅ | | **Manage workspaces through UI and CLI** | ✅ | ✅ | Something missing, or have feedback?