Harmonix on AWS v0.4.2 - Final Release ⚠️ PROJECT DEPRECATED

This is the final release of Harmonix on AWS. The project is now deprecated and no longer actively maintained as of December 2025.

⚠️ Deprecation Notice

Harmonix on AWS was a reference architecture and reference implementation and should not be used as-is for production environments. The project remains available for educational and reference purposes only.

• No future releases will be published
• No bug fixes or feature updates will be provided
• Security vulnerabilities will not be addressed after this release
• Community support is discontinued

🔒 Security Updates

This release addresses critical security vulnerabilities. All users must upgrade to v0.4.2 immediately.

What's Changed

Security & Configuration:

• Remove trust policy in sample code for EKS compute environments
• Set PAT expiration from 10 to 365 days by @hervekhg in #170
• Make VPC CIDR configurable for hosting Backstage by @literalice in #173

Dependency Updates:

• build(deps): bump @node-saml/node-saml from 5.0.1 to 5.1.0 in /backstage-plugins/plugins by @dependabot[bot] in #175
• build(deps): bump form-data from 4.0.2 to 4.0.4 in /website by @dependabot[bot] in #174
• build(deps): bump @backstage/plugin-scaffolder-backend from 1.32.1 to 2.1.1 in /backstage-plugins/plugins by @dependabot[bot] in #179

New Contributors

• @hervekhg made their first contribution in #170
• @literalice made their first contribution in #173

Full Changelog: v0.4.1...v0.4.2

Harmonix on AWS v0.4.1

Minor bug fixes and other small improvements.

What's Changed

• prevent whitespace in backstage entity ID during scaffolding
• Bug Fixes
  • GitLab plugin not configured to work with AWSEnvironment entity type
  • AWS Secrets Manager secret template deployment failures

Full Changelog: v0.4.0...v0.4.1

Harmonix on AWS v0.4.0

New release with additional features, bug fixes and doc updates

What's Changed

• Upgraded Harmonix on AWS to the latest Backstage version (1.38) and new backend system.
• Upgraded the GitLab Community Edition version to 17.10.3
• Upgraded Infrastructure as Code dependency versions
• Updated Serverless application template Node runtime from 18 to 22
• Upgrade EKS Kubernetes cluster version from 1.31 to 1.32
• Upgraded PostgreSQL version for the RDS resource type and the platform installation to VER_16_6
• Installation of 3rd party plugins is now done using the new backend system for Backstage. The versions of 3rd party plugins have been updated to the lateest.
• Added mise.toml file to make it easier to build Harmonix using tested tool versions. See the mise website for installation instructions
• Running Backstage locally is easier than ever. See our documentation on running locally for more details.
• All Harmonix front end pages are now exported so that they can be referenced and extended
  • See PR
• Harmonix installation should be run using Yarn 4 since Backstage has moved to using Yarn 4
• Added configurations and Make targets for compiling and testing Harmonix plugins
• Updated scaffolding actions
  • Add support for dry runs
  • Use new createTemplateAction function format now that the old one is deprecated in the latest Backstage scaffolder plugin.
    • See backstage scaffolder changelog for details, specifically for version 0.8.0.
  • Scaffolding action names have changed, and the software templates have been updated to use the new names
    • Summary: change "opa:" to "harmonix:". For example, the opa:get-component-info scaffolder action is now called harmonix:get-component-info
• Software templates no longer utilize @roadiehq/scaffolder-backend-module-utils
• Harmonix plugin names have not changed, but the directory names under backstage-plugins/plugins that hold the source code of the plugins have changed:
  • aws-apps -> harmomix-frontend
  • aws-apps-backend -> harmonix-backend
  • aws-apps-common -> harmonix-common
  • catalog-backend-module-aws-apps-entities-processor -> catalog-backend-module-harmonix
  • scaffolder-backend-module-aws-apps -> scaffolder-backend-module-harmonix
• Front end home page customizations and theming that used to be located in the @aws/plugin-aws-apps-demo-for-backstage package have been moved into harmonix-frontend.

New Contributors

• @Shu12388y made their first contribution! 👏
• @nutrienrob made their first contribution! 👏
• @longtv2222 made their first contribution! 👏
• @rayl15 made their first contribution! 👏

Full Changelog: v0.3.4...v0.4.0

Harmonix on AWS v0.3.4

New release with additional features, bug fixes and doc updates

What's Changed

• Upgraded Harmonix on AWS to the latest Backstage version and new backend system. 1.29.0
• New custom entity processor plugin - compatible with the new backend backstage system. details here
• Updated Gitlab version 17.2.2
• Support for Github and Multi-Git provider
• New template examples - including Terraform ECS cluster
• New SecretsManager shared resource template
• New entity Schema updates - gitProvider, componentState, component spec subType details here
• General package version updates
• Bug fixes

Documentation

• New git provider documentation
• New video page

New Contributors

• @bfranzen1 made their first contribution in #93

Full Changelog: v0.3.3...v0.3.4

Harmonix on AWS v0.3.3

New release with additional features, bug fixes and doc upates

New Features

• Amazon ECS using EC2 nodes sample added to reference template
• Add check for cdk bootstrap during environment provider provisioning to avoid manual pre-req
• GenAI runtime environment provider template
• GenAI RAG application template

Bug Fixes

• Ensure Terraform state bucket name uniqueness
• Hard-coded region in EKS provider
• code hygiene

Documentation

• Security and Permissions updates
• Kubernetes runtime and template docs
• Contribution guidance
• Architecture description and diagram improvements
• General fixes to typos and clarifications
• GenAI runtime and template docs

See the prior releases for a full list of features and changes:

• v0.3.2 release
• v0.3.1 release
• v0.3.0 release

What's Changed

• general readme details alignment by @arditti in #73
• fix: add kubectl lambda zip for eks by @acwatson in #77
• fix(existing-eks-prov-cicd): Replace the hard-coded region by @stijnbrouwers in #79
• add CDK Bootstrap for initiating providers by @arditti in #75
• V0.3.3 updates by @awsjim in #80

New Contributors

• @stijnbrouwers made their first contribution in #79

Full Changelog: v0.3.2...v0.3.3

Harmonix on AWS v0.3.2

Minor update:

• fixes reference repository pipelines to correct build issues
• fixes installation doc image referencing GitLab 16.8.1 in the AWS Marketplace

See the v0.3.0 release for a full list of new features in the v0.3.x release

What's Changed

• Ref repo updates by @awsjim in #72

Full Changelog: v0.3.1...v0.3.2

Harmonix on AWS v0.3.1

Minor release to fix issues:

• fixes Backstage plugin version identifiers required for 0.3.0 release
• introduces a workaround for GitLab 16.8 error when creating new user
• introduces a workaround for an image build error due to upgraded "swagger-ui-react" module

See the v0.3.0 release for a full list of new features in the v0.3.x release

What's Changed

• Fix sync changes by @awsjim in #70
• V0.3.1 updates by @awsjim in #71

Full Changelog: v0.3.0...v0.3.1

Harmonix on AWS v0.3.0

New Features

• Support for Kubernetes:
  • Add AWS EKS provider
  • Import existing AWS EKS clusters
  • Add AWS EKS Application for K8s Kustomize pattern
  • Add AWS EKS Application for K8s Helm pattern
  • Add CI/CD patterns for K8s applications
  • New UI Page for K8s with control panel to operate the application
• S3 Bucket as a shared resource
• Reuse existing VPC when creating providers(Import existing VPC)
• AWS ECS provider with EC2 clusters for tailored workloads
• Updated Backstage platform to v1.21
• Support filter relevant environments for new apps

New Documentation

• Security documentation
• Test cases
• Add a basic provider template - example for starting your own provider templates.

Refactor

• Remove hyphenated names from entities
• Adding support for component subType for easy identification of internal AWS component classification

Bug Fixes

• Delete provider - case name issue
• Delete app - case name issue
• Delete resource - remove secret deletion + adjusted stack name mapping
• Remove provider from an environment after creation

What's Changed

• V0.3 release by @awsjim in #64
• Bump werkzeug from 2.3.7 to 2.3.8 in /backstage-reference/templates/example-python-flask/content by @dependabot in #65
• Bump jinja2 from 3.1.2 to 3.1.3 in /backstage-reference/templates/example-python-flask-eks/content by @dependabot in #67
• Bump werkzeug from 2.3.7 to 2.3.8 in /backstage-reference/templates/example-python-flask-eks/content by @dependabot in #66
• Bump follow-redirects from 1.15.3 to 1.15.5 in /website by @dependabot in #68
• Bump jinja2 from 3.1.2 to 3.1.3 in /backstage-reference/templates/example-python-flask/content by @dependabot in #69

Full Changelog: v0.2.0...v0.3.0

Harmonix on AWS v0.2.0

What's Changed

• Initial content by @z-sourcecode in #1
• Bump flask from 2.2.3 to 2.3.2 in /backstage-reference/templates/example-python-flask/skeleton by @dependabot in #2
• documentation updates by @awsjim in #3
• fix: deployment permission errors for SAM apps by @awsjim in #4
• Update npm packages by @z-sourcecode in #6
• add aws logo by @awsjim in #7
• update logo for use on dark backgrounds by @awsjim in #8
• Add YouTube playlist link to README.md by @acwatson in #9
• updating license and npm publication by @z-sourcecode in #11
• Create makefile.yml by @z-sourcecode in #10
• Linux setup updates by @awsjim in #12
• fix python issue in serverless gitlab pipeline by @acwatson in https://github.com/awslabs/v/pull/16
• pin backstage and plugin versions by @awsjim in #17
• Update Documentation for issue #18 by @gowthamshankar99 in #19
• update install script and docs for Backstage 1.15 support by @awsjim in #20
• Harmonix release by @awsjim in #37
• Install platform issues by @awsjim in #38
• fix: install errors due to prior backstage instance by @awsjim in #39
• fix: prevent blank strings in allowed ips array by @acwatson in #40
• docs: add AWS CLI as an installation prerequisite by @acwatson in #41
• fix: git-defender detection in gitlab-tools script by @acwatson in #42
• fix TF long name to shorter name by @z-sourcecode in #47
• Npm private package by @z-sourcecode in #48
• fix: update packages to aws namespace by @awsjim in #49
• Fix "git-defender" command existing checks by @arditti in #43
• sample.env - Okta and Allowed IPs further deatils by @arditti in #45
• README.MD - Okta added the required plan by @arditti in #44
• fix: error switching the current environment in UI if environment name contains capital letters by @acwatson in #51
• opa website changes by @z-sourcecode in #54
• opa website yarn.lock by @z-sourcecode in #55
• Bump werkzeug from 2.3.7 to 3.0.1 in /backstage-reference/templates/example-python-flask/content by @dependabot in #53
• Website docs by @z-sourcecode in #56
• coming soon by @z-sourcecode in #58
• Website docs by @z-sourcecode in #59
• change order by @z-sourcecode in #60
• Bump jinja2 from 3.1.2 to 3.1.3 in /backstage-reference/templates/example-python-flask/content by @dependabot in #63
• Bump follow-redirects from 1.15.3 to 1.15.4 in /website by @dependabot in #62

New Contributors

• @z-sourcecode made their first contribution in #1
• @dependabot made their first contribution in #2
• @awsjim made their first contribution in #3
• @acwatson made their first contribution in #9
• @gowthamshankar99 made their first contribution in #19
• @arditti made their first contribution in #43

Full Changelog: https://github.com/awslabs/harmonix/commits/v0.2.0