diff --git a/.vscode/settings.json b/.vscode/settings.json index 2aa54dc..f2d5584 100644 --- a/.vscode/settings.json +++ b/.vscode/settings.json @@ -211,6 +211,7 @@ "ondemand", "openmediavault", "openpgp", + "opentofu", "opkg", "pacman", "pamac", diff --git a/containers/techradar/aoe/.gitignore b/containers/techradar/aoe/.gitignore new file mode 100644 index 0000000..df85691 --- /dev/null +++ b/containers/techradar/aoe/.gitignore @@ -0,0 +1,4 @@ +/.techradar +/build +/node_modules +/package-lock.json diff --git a/containers/techradar/aoe/Makefile b/containers/techradar/aoe/Makefile new file mode 100644 index 0000000..3cb15c6 --- /dev/null +++ b/containers/techradar/aoe/Makefile @@ -0,0 +1,21 @@ +#!/usr/bin/env make + +bootstrap: + @npm install + @${MAKE} staticsite-build + + +staticsite-build: + @npm run build + +local-serve: staticsite-build + @npm run serve + + +composition-go-brrr: staticsite-build + @docker compose up -d + +composition-stop: + @docker compose down + +composition-refresh: composition-stop composition-go-brrr diff --git a/containers/techradar/aoe/README.md b/containers/techradar/aoe/README.md new file mode 100644 index 0000000..2d6a81a --- /dev/null +++ b/containers/techradar/aoe/README.md @@ -0,0 +1,21 @@ +# Tech radar + +Based upon [AOE's technology radar](https://github.com/AOEpeople/aoe_technology_radar). + +Bootstrap: + +1. Run `npm install`. +1. Run `npm run build` to create the initial radar.
+ This will also create a basic bootstrap of all required files, including `config.json` and `about.md` if they do not + exist yet. + +Customization: + +1. Change the `about.md`, `config.json`, `custom.css` files accordingly. +1. Create a folder named as a date in the `radar` folder to create a new revision. +1. Add markdown files in there for each change. Follow the instructions of the base. + +Serve: + +1. Execute `docker compose up -d`. +1. Open your browser at . diff --git a/containers/techradar/aoe/about.md b/containers/techradar/aoe/about.md new file mode 100644 index 0000000..1477513 --- /dev/null +++ b/containers/techradar/aoe/about.md @@ -0,0 +1,11 @@ +# How to use the Technology Radar + +## Introduction + +Edit this file to your needs to provide an introduction to the technology radar. Explain the purpose +of the radar and how it is created. This is a good place to explain the quadrants and rings, too. + +## Contributing to the AOE Technology Radar + +Contributions and source code of the AOE Tech Radar are on +GitHub: [AOE Tech Radar on GitHub](https://github.com/AOEpeople/aoe_technology_radar) diff --git a/containers/techradar/aoe/config.json b/containers/techradar/aoe/config.json new file mode 100644 index 0000000..dfc73cb --- /dev/null +++ b/containers/techradar/aoe/config.json @@ -0,0 +1,134 @@ +{ + "basePath": "/techradar", + "baseUrl": "", + "logoFile": "logo.svg", + "toggles": { + "showChart": true, + "showTagFilter": true, + "showQuadrantList": true, + "showEmptyRings": false + }, + "sections": [ + "radar", + "tags", + "list" + ], + "colors": { + "foreground": "#fcf2e6", + "background": "#113521", + "highlight": "#d4a373", + "content": "#fff", + "text": "#575757", + "link": "#bc6c25", + "border": "rgba(255, 255, 255, 0.1)", + "tag": "rgba(255, 255, 255, 0.1)" + }, + "quadrants": [ + { + "id": "languages-and-frameworks", + "title": "Languages & Frameworks", + "description": "A selection of programming languages, alongside essential frameworks for building a variety of custom software.", + "color": "#a3b18a" + }, + { + "id": "methods-and-patterns", + "title": "Methods & Patterns", + "description": "Key software development methods and design patterns, covering everything from continuous integration and testing to architecture.", + "color": "#588157" + }, + { + "id": "platforms-and-operations", + "title": "Platforms & Operations", + "description": "Technologies and tools for software and infrastructure operations, including platforms and services for managing and scaling applications.", + "color": "#3f633e" + }, + { + "id": "tools", + "title": "Tools", + "description": "A range of software tools, from simple productivity enhancers to comprehensive project solutions, catering to various project needs.", + "color": "#40713f" + } + ], + "rings": [ + { + "id": "adopt", + "title": "Adopt", + "description": "", + "color": "#588157", + "radius": 0.5, + "strokeWidth": 5 + }, + { + "id": "trial", + "title": "Trial", + "description": "", + "color": "#457b9d", + "radius": 0.69, + "strokeWidth": 3 + }, + { + "id": "assess", + "title": "Assess", + "description": "", + "color": "#bc6c25", + "radius": 0.85, + "strokeWidth": 2 + }, + { + "id": "hold", + "title": "Hold", + "description": "", + "color": "#d62828", + "radius": 1, + "strokeWidth": 0.75 + } + ], + "flags": { + "new": { + "color": "#f1235a", + "title": "New", + "titleShort": "N", + "description": "New in this version" + }, + "changed": { + "color": "#40a7d1", + "title": "Changed", + "titleShort": "C", + "description": "Recently changed" + }, + "default": { + "description": "Unchanged" + } + }, + "chart": { + "size": 800, + "blipSize": 12 + }, + "social": [ + { + "href": "https://github.com/mcereda", + "icon": "github" + }, + { + "href": "https://gitlab.com/mckie", + "icon": "gitlab" + } + ], + "imprint": "", + "labels": { + "title": "Technology Radar", + "imprint": "Legal Information", + "quadrant": "Quadrant", + "quadrantOverview": "Quadrant Overview", + "zoomIn": "Zoom in", + "filterByTag": "Filter by Tag", + "footer": "The technology radar is using a project by AOE GmbH. Feel free to build your own radar based on their open source project.", + "notUpdated": "This item was not updated in last three versions of the Radar. Should it have appeared in one of the more recent editions, there is a good chance it remains pertinent. However, if the item dates back further, its relevance may have diminished and our current evaluation could vary. Regrettably, my capacity to consistently revisit items from past Radar editions is limited.", + "notFound": "404 - Page not found", + "pageAbout": "About", + "pageOverview": "Technologies Overview", + "pageSearch": "Search", + "searchPlaceholder": "What are you looking for?", + "metaDescription": "" + } +} \ No newline at end of file diff --git a/containers/techradar/aoe/custom.css b/containers/techradar/aoe/custom.css new file mode 100644 index 0000000..78e53d3 --- /dev/null +++ b/containers/techradar/aoe/custom.css @@ -0,0 +1,6 @@ +/* Use this file to optionally override global css styles and use with caution. */ +/* See README.md for hints and examples: https://github.com/AOEpeople/aoe_technology_radar/ */ + +[class^="Layout_content"] span { + font-size: small; +} \ No newline at end of file diff --git a/containers/techradar/aoe/docker-compose.yml b/containers/techradar/aoe/docker-compose.yml new file mode 100644 index 0000000..df3e4e5 --- /dev/null +++ b/containers/techradar/aoe/docker-compose.yml @@ -0,0 +1,13 @@ +--- +version: '3' +services: + radar: + container_name: radar + image: nginxinc/nginx-unprivileged:1.25.5-bookworm-perl + volumes: + - ${PWD}/build:/usr/share/nginx/html/techradar:ro + ports: + - 8080:8080 + environment: + NGINX_HOST: localhost + NGINX_PORT: '8080' diff --git a/containers/techradar/aoe/package.json b/containers/techradar/aoe/package.json new file mode 100644 index 0000000..4075d43 --- /dev/null +++ b/containers/techradar/aoe/package.json @@ -0,0 +1,12 @@ +{ + "name": "techradar", + "version": "1.0.0", + "license": "MIT", + "scripts": { + "build": "techradar build", + "serve": "techradar serve" + }, + "dependencies": { + "aoe_technology_radar": "^4" + } +} \ No newline at end of file diff --git a/containers/techradar/aoe/public/favicon.ico b/containers/techradar/aoe/public/favicon.ico new file mode 100644 index 0000000..6e989b2 Binary files /dev/null and b/containers/techradar/aoe/public/favicon.ico differ diff --git a/containers/techradar/aoe/public/logo.svg b/containers/techradar/aoe/public/logo.svg new file mode 100644 index 0000000..8c6d831 --- /dev/null +++ b/containers/techradar/aoe/public/logo.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/containers/techradar/aoe/radar/2024-05-24/git.md b/containers/techradar/aoe/radar/2024-05-24/git.md new file mode 100644 index 0000000..e8cfb9d --- /dev/null +++ b/containers/techradar/aoe/radar/2024-05-24/git.md @@ -0,0 +1,6 @@ +--- +title: "git" +quadrant: tools +ring: adopt +tags: [] +--- diff --git a/containers/techradar/aoe/radar/2024-05-25/gitea.md b/containers/techradar/aoe/radar/2024-05-25/gitea.md new file mode 100644 index 0000000..484fb79 --- /dev/null +++ b/containers/techradar/aoe/radar/2024-05-25/gitea.md @@ -0,0 +1,6 @@ +--- +title: "gitea" +quadrant: tools +ring: assess +tags: [] +--- diff --git a/containers/techradar/aoe/radar/2024-05-25/nodejs.md b/containers/techradar/aoe/radar/2024-05-25/nodejs.md new file mode 100644 index 0000000..9e483ff --- /dev/null +++ b/containers/techradar/aoe/radar/2024-05-25/nodejs.md @@ -0,0 +1,6 @@ +--- +title: "node.js" +quadrant: languages-and-frameworks +ring: hold +tags: [iac] +--- diff --git a/containers/techradar/aoe/radar/2024-05-25/opentofu.md b/containers/techradar/aoe/radar/2024-05-25/opentofu.md new file mode 100644 index 0000000..cc0a05e --- /dev/null +++ b/containers/techradar/aoe/radar/2024-05-25/opentofu.md @@ -0,0 +1,6 @@ +--- +title: "opentofu" +quadrant: platforms-and-operations +ring: trial +tags: [iac] +--- diff --git a/containers/techradar/aoe/radar/2024-05-25/pulumi.md b/containers/techradar/aoe/radar/2024-05-25/pulumi.md new file mode 100644 index 0000000..c986fa8 --- /dev/null +++ b/containers/techradar/aoe/radar/2024-05-25/pulumi.md @@ -0,0 +1,6 @@ +--- +title: "pulumi" +quadrant: platforms-and-operations +ring: adopt +tags: [iac] +--- diff --git a/containers/techradar/aoe/radar/2024-05-25/terraform.md b/containers/techradar/aoe/radar/2024-05-25/terraform.md new file mode 100644 index 0000000..94aa349 --- /dev/null +++ b/containers/techradar/aoe/radar/2024-05-25/terraform.md @@ -0,0 +1,6 @@ +--- +title: "terraform" +quadrant: platforms-and-operations +ring: adopt +tags: [iac] +--- diff --git a/knowledge base/technology radar.md b/knowledge base/technology radar.md index bff37c7..815efa6 100644 --- a/knowledge base/technology radar.md +++ b/knowledge base/technology radar.md @@ -60,6 +60,7 @@ Blips can (and in time, should) move between rings as one's recommendation chang ## Further readings - [Zalando's tech-radar tool] +- [AOE's technology radar] ### Sources @@ -75,5 +76,6 @@ Blips can (and in time, should) move between rings as one's recommendation chang +[aoe's technology radar]: https://github.com/AOEpeople/aoe_technology_radar [thoughtworks' technology radar]: https://www.thoughtworks.com/radar [zalando's tech-radar tool]: https://github.com/zalando/tech-radar