Add Node.js feature

Author: jgarber623-cargosense

.github/workflows/test.yml

@@ -14,6 +14,7 @@ jobs:
         features:
           - actionlint
           - google-cloud-cli
+          - node
           - postgresql-client
           - shellcheck
         baseImage:
@@ -33,6 +34,7 @@ jobs:
         features:
           - actionlint
           - google-cloud-cli
+          - node
           - postgresql-client
           - shellcheck
     continue-on-error: true

src/node/README.md

@@ -0,0 +1,21 @@
+# node
+
+Install [Node.js](https://nodejs.org) from [Nodesource's DEB repository](https://deb.nodesource.com).
+
+## Usage
+
+```json
+"features": {
+  "ghcr.io/CargoSense/devcontainer-features/node:1": {}
+}
+```
+
+## Options
+
+| Option ID | Description                     | Type   | Default Value |
+|:----------|:--------------------------------|:-------|:--------------|
+| `version` | The Node.js version to install. | string | `22` |
+
+## OS Support
+
+This Feature should work on recent versions of Debian/Ubuntu and Linux distributions using the [apt](https://wiki.debian.org/AptCLI) management tool.

src/node/devcontainer-feature.json

@@ -0,0 +1,23 @@
+{
+  "name": "Node.js",
+  "id": "node",
+  "version": "1.0.0",
+  "description": "Install Node.js from Nodesource's DEB repository.",
+  "options": {
+    "version": {
+      "type": "string",
+      "enum": [
+        "18",
+        "20",
+        "21",
+        "22",
+        "23"
+      ],
+      "default": "22",
+      "description": "Select or enter a Node.js version."
+    }
+  },
+  "installsAfter": [
+    "ghcr.io/devcontainers/features/common-utils"
+  ]
+}

src/node/install.sh

@@ -0,0 +1,23 @@
+#!/usr/bin/env sh
+
+set -e
+
+NODE_VERSION="${VERSION:-"22"}"
+
+curl_installed=""
+
+if ! type curl >/dev/null 2>&1; then
+  apt update --yes
+  apt install --no-install-recommends --yes curl ca-certificates
+
+  curl_installed="true"
+fi
+
+curl -fsSL https://deb.nodesource.com/setup_"${NODE_VERSION}".x | bash -
+
+apt update --yes
+apt install --no-install-recommends --yes nodejs
+
+if [ -n "${curl_installed}" ]; then
+  apt purge curl --autoremove --yes
+fi

test/node/node-20.sh

@@ -0,0 +1,46 @@
+#!/usr/bin/env bash
+
+# This test file will be executed against an auto-generated devcontainer.json that
+# includes the 'node' Feature with no options.
+#
+# For more information, see: https://github.com/devcontainers/cli/blob/main/docs/features/test.md
+#
+# Eg:
+# {
+#    "image": "<..some-base-image...>",
+#    "features": {
+#      "node": {}
+#    },
+#    "remoteUser": "root"
+# }
+#
+# Thus, the value of all options will fall back to the default value in the
+# Feature's 'devcontainer-feature.json'.
+#
+# These scripts are run as 'root' by default. Although that can be changed
+# with the '--remote-user' flag.
+#
+# This test can be run with the following command:
+#
+#    devcontainer features test    \
+#               --features node   \
+#               --remote-user root \
+#               --skip-scenarios   \
+#               --base-image mcr.microsoft.com/devcontainers/base:ubuntu \
+#               /path/to/this/repo
+
+set -e
+
+# Optional: Import test library bundled with the devcontainer CLI
+# See https://github.com/devcontainers/cli/blob/HEAD/docs/features/test.md#dev-container-features-test-lib
+# Provides the 'check' and 'reportResults' commands.
+source dev-container-features-test-lib
+
+# Feature-specific tests
+# The 'check' command comes from the dev-container-features-test-lib. Syntax is...
+# check <LABEL> <cmd> [args...]
+check "version" bash -c "node --version | grep -E 'v20\..+'"
+
+# Report result
+# If any of the checks above exited with a non-zero exit code, the test will fail.
+reportResults

test/node/scenarios.json

@@ -0,0 +1,10 @@
+{
+  "node-20": {
+    "image": "debian:latest",
+    "features": {
+      "node": {
+        "version": "20"
+      }
+    }
+  }
+}

test/node/test.sh

@@ -0,0 +1,47 @@
+#!/usr/bin/env bash
+
+# This test file will be executed against an auto-generated devcontainer.json that
+# includes the 'node' Feature with no options.
+#
+# For more information, see: https://github.com/devcontainers/cli/blob/main/docs/features/test.md
+#
+# Eg:
+# {
+#    "image": "<..some-base-image...>",
+#    "features": {
+#      "node": {}
+#    },
+#    "remoteUser": "root"
+# }
+#
+# Thus, the value of all options will fall back to the default value in the
+# Feature's 'devcontainer-feature.json'.
+#
+# These scripts are run as 'root' by default. Although that can be changed
+# with the '--remote-user' flag.
+#
+# This test can be run with the following command:
+#
+#    devcontainer features test    \
+#               --features node   \
+#               --remote-user root \
+#               --skip-scenarios   \
+#               --base-image mcr.microsoft.com/devcontainers/base:ubuntu \
+#               /path/to/this/repo
+
+set -e
+
+# Optional: Import test library bundled with the devcontainer CLI
+# See https://github.com/devcontainers/cli/blob/HEAD/docs/features/test.md#dev-container-features-test-lib
+# Provides the 'check' and 'reportResults' commands.
+source dev-container-features-test-lib
+
+# Feature-specific tests
+# The 'check' command comes from the dev-container-features-test-lib. Syntax is...
+# check <LABEL> <cmd> [args...]
+check "version" node --version
+check "which node" bash -c "which node | grep /usr/bin/node"
+
+# Report result
+# If any of the checks above exited with a non-zero exit code, the test will fail.
+reportResults