aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorJosh Spicer <joshspicer@github.com>2022-06-29 20:27:25 +0300
committerGitHub <noreply@github.com>2022-06-29 20:27:25 +0300
commitc2408ed9e4c16cbdad0ae407ffff33e90884357d (patch)
tree779e270f78207733bb39a4d789297b08bf5e5956 /README.md
parentd45626b2b97c161853800d82f47681675f1e234b (diff)
(no-ci) how to build
Diffstat (limited to 'README.md')
-rw-r--r--README.md15
1 files changed, 11 insertions, 4 deletions
diff --git a/README.md b/README.md
index dc34c22..51b0ac2 100644
--- a/README.md
+++ b/README.md
@@ -12,11 +12,10 @@
Missing a CLI or language in your otherwise _perfect_ container image? Add the relevant 'feature' to the `features` property of a [`devcontainer.json`](https://containers.dev/implementors/json_reference/#general-properties). A [tool supporting the dev container specification](https://containers.dev/supporting) is required to build a development container.
-Development container 'features' are a [proposed](https://github.com/devcontainers/spec/blob/main/proposals/devcontainer-features.md) addition to the [development container specification](https://github.com/devcontainers/spec/blob/main/proposals/devcontainer-features.md). **Please note that 'features' are in preview and subject to breaking changes**.
+⚠️ Development container 'features' are a [**proposed**](https://github.com/devcontainers/spec/blob/main/proposals/devcontainer-features.md) addition to the [development container specification](https://github.com/devcontainers/spec/blob/main/proposals/devcontainer-features.md). **Please note that 'features' are in preview and subject to breaking changes**.
+
+Once the [**proposed**](https://github.com/devcontainers/spec/blob/main/proposals/devcontainer-features.md) specification is accepted, implementation details will be published at [https://containers.dev](https://containers.dev/).
-<!--
-**For more information on the 'features' specification, see [https://containers.dev/implementors/features](https://containers.dev/implementors/features)**
--->
## Repo Structure
@@ -65,6 +64,7 @@ The example below installs the `go` and `docker-in-docker` declared in the [`./s
See the relevant feature's README for supported options.
```jsonc
+"name": "my-project-devcontainer",
"image": "mcr.microsoft.com/devcontainers/base:ubuntu", // Any generic, debian-based image.
features: {
"devcontainers/features/go@latest": {
@@ -86,6 +86,13 @@ features: {
},
```
+The [devcontainer CLI reference implementation](https://github.com/devcontainers/cli) (or a [supporting tool](https://containers.dev/supporting)) can be used to build a project's dev container declaring 'features'.
+
+```bash
+git clone <my-project-with-devcontainer>
+devcontainer build --workspace-folder <path-to-my-project-with-devcontainer>
+```
+
## Contributions
### Contibuting to this repository