start

bpmct · bpmct · commit 4aec9cf267a4 · 2023-06-28T13:42:42.000Z
diff --git a/docs/manifest.json b/docs/manifest.json
@@ -175,6 +175,12 @@
           "description": "Use docker inside containerized templates",
           "path": "./templates/docker-in-workspaces.md",
           "icon_path": "./images/icons/docker.svg"
+        },
+        {
+          "title": "Devcontainers",
+          "description": "Use devcontainers in workspaces",
+          "path": "./templates/devcontainers.md",
+          "state": "alpha"
         }
       ]
     },
diff --git a/docs/templates/devcontainers.md b/docs/templates/devcontainers.md
@@ -0,0 +1,16 @@
+# Devcontainers (alpha)
+
+[Devcontainers](https://containers.dev) are an open source specification for defining development environments. With [envbuilder](https://github.com/coder/coder), an open source project by Coder, you can support devcontainers in your Coder templates. There are several benefits to this:
+
+- Drop-in migration from Codespaces or any repositories that use devcontainers
+- Developer teams can manage their own images/dependencies in the project repository without relying on an image registry, CI pipelines, or manual effort from platform teams
+
+## How it works
+
+- Coder admins add a devcontainer-compatible template to Coder (this can run on VMs, Docker, or Kubernetes)
+
+- Developers enter their repository URL as a [parameter](./parameters.md) when creating workspaces. [envbuilder](https://github.com/coder/envbuilder) clones the repo and builds a container from the `devcontainer.json` specified in the repo.
+
+- Developers can edit the `devcontainer.json` in their workspace and rebuild to iterate on their development environment.
+
+## Caching

Original file line number	Diff line number	Diff line change
`@@ -175,6 +175,12 @@`
`175`	`175`	`"description": "Use docker inside containerized templates",`
`176`	`176`	`"path": "./templates/docker-in-workspaces.md",`
`177`	`177`	`"icon_path": "./images/icons/docker.svg"`
	`178`	`+ },`
	`179`	`+ {`
	`180`	`+ "title": "Devcontainers",`
	`181`	`+ "description": "Use devcontainers in workspaces",`
	`182`	`+ "path": "./templates/devcontainers.md",`
	`183`	`+ "state": "alpha"`
`178`	`184`	`}`
`179`	`185`	`]`
`180`	`186`	`},`