feat(browsers): add browsers feature

.github/workflows/ci.yml

@@ -15,6 +15,7 @@ jobs:
     strategy:
       matrix:
         feature: [
+          "browsers",
           "docker-out",
           "git-lfs",
           "go",

README.md

@@ -15,6 +15,7 @@ Below is a list with included features, click on the link for more details.
 
 | Name | Description |
 | --- | --- |
+| [browsers](./features/src/browsers/README.md) | A package which installs various browsers. |
 | [docker-out](./features/src/docker-out/README.md) | A feature which installs the Docker client and re-uses the host socket. |
 | [git-lfs](./features/src/git-lfs/README.md) | A feature which installs Git LFS. |
 | [go](./features/src/go/README.md) | A feature which installs Go. |

build/build.go

@@ -20,6 +20,7 @@ import (
 ////////////////////////////////////////////////////////////
 
 var featureList = []string{
+	"browsers",
 	"docker-out",
 	"git-lfs",
 	"go",
@@ -50,6 +51,17 @@ func init() {
 		return nil
 	})
 
+	////////// browsers
+	gotaskr.Task("Feature:browsers:Package", func() error {
+		return packageFeature("browsers")
+	})
+	gotaskr.Task("Feature:browsers:Test", func() error {
+		return testFeature("browsers")
+	})
+	gotaskr.Task("Feature:browsers:Publish", func() error {
+		return publishFeature("browsers")
+	})
+
 	////////// docker-out
 	gotaskr.Task("Feature:docker-out:Package", func() error {
 		return packageFeature("docker-out")

features/src/browsers/NOTES.md

@@ -0,0 +1,14 @@
+## Notes
+
+### System Compatibility
+
+Debian, Ubuntu
+
+### Accessed Urls
+
+Needs access to the following URL for downloading and resolving:
+* https://dl.google.com
+* https://versionhistory.googleapis.com
+* https://googlechromelabs.github.io
+* https://download-installer.cdn.mozilla.net
+* https://product-details.mozilla.org

features/src/browsers/README.md

@@ -0,0 +1,50 @@
+# Browsers (browsers)
+
+A package which installs various browsers.
+
+## Example Usage
+
+```json
+"features": {
+    "ghcr.io/postfinance/devcontainer-features/browsers:0.1.0": {
+        "chromeVersion": "none",
+        "useChromeForTesting": true,
+        "chromeDownloadUrl": "",
+        "chromeVersionsUrl": "",
+        "chromeTestingVersionsUrl": "",
+        "firefoxVersion": "none",
+        "firefoxDownloadUrl": "",
+        "firefoxVersionsUrl": "",
+        "firefoxVersionResolve": false
+    }
+}
+```
+
+## Options
+
+| Option | Description | Type | Default Value | Proposals |
+|-----|-----|-----|-----|-----|
+| chromeVersion | The version of the Chrome to install. | string | none | none, latest, 126 |
+| useChromeForTesting | A flag to indicate if the Chrome for Testing or the default chrome should be used. | boolean | true | true, false |
+| chromeDownloadUrl | Override Chrome download base URL. | string | <empty> |  |
+| chromeVersionsUrl | Override Chrome versions URL. | string | <empty> |  |
+| chromeTestingVersionsUrl | Override Chrome for Testing versions URL. | string | <empty> |  |
+| firefoxVersion | The version of the Firefox to install. | string | none | none, latest, 128 |
+| firefoxDownloadUrl | Override Firefox download base URL. | string | <empty> |  |
+| firefoxVersionsUrl | Override Firefox versions URL. | string | <empty> |  |
+| firefoxVersionResolve | If true, resolves partial Firefox versions (e.g. 142.0) to the highest available patch version (e.g. 142.0.3). | boolean | false | true, false |
+
+## Notes
+
+### System Compatibility
+
+Debian, Ubuntu
+
+### Accessed Urls
+
+Needs access to the following URL for downloading and resolving:
+* https://dl.google.com
+* https://versionhistory.googleapis.com
+* https://googlechromelabs.github.io
+* https://download-installer.cdn.mozilla.net
+* https://product-details.mozilla.org

features/src/browsers/devcontainer-feature.json

@@ -0,0 +1,63 @@
+{
+  "id": "browsers",
+  "version": "0.1.0",
+  "name": "Browsers",
+  "description": "A package which installs various browsers.",
+  "options": {
+    "chromeVersion": {
+      "type": "string",
+      "description": "The version of the Chrome to install.",
+      "default": "none",
+      "proposals": [
+        "none",
+        "latest",
+        "126"
+      ]
+    },
+    "useChromeForTesting": {
+      "type": "boolean",
+      "description": "A flag to indicate if the Chrome for Testing or the default chrome should be used.",
+      "default": true
+    },
+    "chromeDownloadUrl": {
+      "type": "string",
+      "default": "",
+      "description": "Override Chrome download base URL."
+    },
+    "chromeVersionsUrl": {
+      "type": "string",
+      "default": "",
+      "description": "Override Chrome versions URL."
+    },
+    "chromeTestingVersionsUrl": {
+      "type": "string",
+      "default": "",
+      "description": "Override Chrome for Testing versions URL."
+    },
+    "firefoxVersion": {
+      "type": "string",
+      "description": "The version of the Firefox to install.",
+      "default": "none",
+      "proposals": [
+        "none",
+        "latest",
+        "128"
+      ]
+    },
+    "firefoxDownloadUrl": {
+      "type": "string",
+      "default": "",
+      "description": "Override Firefox download base URL."
+    },
+    "firefoxVersionsUrl": {
+      "type": "string",
+      "default": "",
+      "description": "Override Firefox versions URL."
+    },
+    "firefoxVersionResolve": {
+      "type": "boolean",
+      "default": false,
+      "description": "If true, resolves partial Firefox versions (e.g. 142.0) to the highest available patch version (e.g. 142.0.3)."
+    }
+  }
+}

features/src/browsers/install.sh

@@ -0,0 +1,12 @@
+. ./functions.sh
+
+"./installer_$(detect_arch)" \
+    -chromeVersion="${CHROMEVERSION:-"none"}" \
+    -useChromeForTesting="${USECHROMEFORTESTING:-"true"}" \
+    -firefoxVersion="${FIREFOXVERSION:-"none"}" \
+    -chromeDownloadUrl="${CHROMEDOWNLOADURL:-""}" \
+    -chromeVersionsUrl="${CHROMEVERSIONSURL:-""}" \
+    -chromeTestingVersionsUrl="${CHROMETESTINGVERSIONSURL:-""}" \
+    -firefoxDownloadUrl="${FIREFOXDOWNLOADURL:-""}" \
+    -firefoxVersionsUrl="${FIREFOXVERSIONSURL:-""}" \
+    -firefoxVersionResolve="${FIREFOXVERSIONRESOLVE:-""}"