From 2d008f35bc64934d99fe00dbce3c8921edf9f53f Mon Sep 17 00:00:00 2001 From: blam Date: Thu, 18 Apr 2024 20:47:04 +0200 Subject: [PATCH] Deprecate packages Signed-off-by: blam --- .changeset/migrate-1713466022480.md | 5 ++ plugins/git-release-manager/README.md | 60 +----------------------- plugins/git-release-manager/package.json | 6 ++- 3 files changed, 11 insertions(+), 60 deletions(-) create mode 100644 .changeset/migrate-1713466022480.md diff --git a/.changeset/migrate-1713466022480.md b/.changeset/migrate-1713466022480.md new file mode 100644 index 0000000000..da0c9b0240 --- /dev/null +++ b/.changeset/migrate-1713466022480.md @@ -0,0 +1,5 @@ +--- +'@backstage/plugin-git-release-manager': patch +--- + +These packages have been migrated to the [backstage/community-plugins](https://github.com/backstage/community-plugins) repository. diff --git a/plugins/git-release-manager/README.md b/plugins/git-release-manager/README.md index d9e1703781..444e6f9fc0 100644 --- a/plugins/git-release-manager/README.md +++ b/plugins/git-release-manager/README.md @@ -1,59 +1,3 @@ -# Git Release Manager (GRM) +# Deprecated -## Overview - -`GRM` enables developers to manage their releases without having to juggle git commands. - -Does it build and ship your code? **No**. - -What `GRM` does is manage your Git **[releases](https://docs.github.com/en/github/administering-a-repository/managing-releases-in-a-repository)**, building and shipping is entirely up to you as a developer to handle in your CI. - -`GRM` is built with industry standards in mind and the flow is as follows: - -![](./src/features/Info/flow.png) - -> **Git**: The source control system where releases reside in a practical sense. Read more about [Git releases](https://docs.github.com/en/github/administering-a-repository/managing-releases-in-a-repository). (Note that this plugin works just as well with any system implementing `Git`.) -> -> **Release Candidate (RC)**: A Git pre-release intended primarily for internal testing -> -> **Release Version**: A Git release intended for end users - -Looking at the flow above, a common release lifecycle could be: - -- User presses **Create Release Candidate** - - `GRM` - 1. Creates a release branch `rc/` - 1. Creates Release Candidate tag `rc-` - 1. Creates a Git prerelease with Release Candidate tag - - Your CI - 1. Detects the new tag by matching the git reference `refs/tags/rc-.*` - 1. Builds and deploys to staging environment for testing -- User presses **Patch** - - `GRM` - 1. The selected commit is cherry-picked to the release branch - 1. The release tag is bumped - 1. Updates Git release's tag and description with the patch's details - - Your CI - 1. Detects the new tag by matching the git reference `refs/tags/(rc|version)-.*` (Release Versions are patchable as well) - 1. Builds and deploys to staging (or production if Release Version) for testing -- User presses **Promote Release Candidate to Release Version** - - `GRM` - 1. Creates Release Version tag `version-` - 1. Promotes the Git release by removing the prerelease flag - - Your CI - 1. Detects the new tag by matching the git reference `refs/tags/version-.*` - 1. Builds and deploys to production for testing - -## Usage - -### Importing - -The plugin exports a single full-page extension `GitReleaseManagerPage`, which one can add to an app like a usual top-level tool on a dedicated route. - -### Configuration - -The plugin is configurable either via props or the select elements on the page. - -If project configuration is provided via props, the select elements are disabled. It is also possible to omit features from the page via props, as well as attaching callbacks for successful executions. - -See the plugin's dev folder (`dev/index.tsx`) to see some examples. +This package has been moved to the [backstage-community/plugins](https://github.com/backstage/community-plugins) repository. Migrate to using `@backstage-community/plugin-git-release-manager` instead. diff --git a/plugins/git-release-manager/package.json b/plugins/git-release-manager/package.json index 2f9f226371..6739e3114f 100644 --- a/plugins/git-release-manager/package.json +++ b/plugins/git-release-manager/package.json @@ -3,7 +3,8 @@ "version": "0.3.46", "description": "A Backstage plugin that helps you manage releases in git", "backstage": { - "role": "frontend-plugin" + "role": "frontend-plugin", + "moved": "@backstage-community/plugin-git-release-manager" }, "publishConfig": { "access": "public", @@ -60,5 +61,6 @@ "react": "^16.13.1 || ^17.0.0 || ^18.0.0", "react-dom": "^16.13.1 || ^17.0.0 || ^18.0.0", "react-router-dom": "6.0.0-beta.0 || ^6.3.0" - } + }, + "deprecated": "This package has been moved to the backstage/community-plugins repository. You should migrate to using @backstage-community/plugin-git-release-manager instead." }