diff --git a/.changeset/migrate-1713465993760.md b/.changeset/migrate-1713465993760.md new file mode 100644 index 0000000000..1b308ecbbd --- /dev/null +++ b/.changeset/migrate-1713465993760.md @@ -0,0 +1,5 @@ +--- +'@backstage/plugin-firehydrant': patch +--- + +These packages have been migrated to the [backstage/community-plugins](https://github.com/backstage/community-plugins) repository. diff --git a/plugins/firehydrant/README.md b/plugins/firehydrant/README.md index aa56bd066a..d11327445e 100644 --- a/plugins/firehydrant/README.md +++ b/plugins/firehydrant/README.md @@ -1,66 +1,3 @@ -# FireHydrant Plugin +# Deprecated -## Overview - -The [FireHydrant](https://firehydrant.io) plugin brings incident management to Backstage, and it displays service incidents information such as active incidents and incident analytics. There are also quick action links that let you create and view incidents in FireHydrant. - -FireHydrant plugin screenshot - -## Features - -- View total active incidents for a service declared in FireHydrant -- Quick links to the top 5 most recent active incidents in FireHydrant -- View incident metrics for a given service within the last 30 days, including: healthiness, total time impacted, total number of incidents, and MTT* (Mean Time To *) data such as MTTD (detect), MTTA (acknowledge), MTTM (mitigate) and MTTR (resolve). - -## Setup - -1. Install the plugin: - -```bash -# From your Backstage root directory -yarn --cwd packages/app add @backstage/plugin-firehydrant -``` - -2. Add the plugin to `EntityPage.tsx`, inside the `const overviewContent`'s parent `` component: - -```ts -// In packages/app/src/components/catalog/EntityPage.tsx -import { FirehydrantCard } from '@backstage/plugin-firehydrant'; - -// Add to code as a grid item - - -; -``` - -3. Add proxy configuration to `app-config.yaml`: - -```yaml -proxy: - '/firehydrant/api': - target: 'https://api.firehydrant.io/v1/' - changeOrigin: true - headers: - # Supply the token you generated from https://app.firehydrant.io/organizations/bots - Authorization: Bearer ${FIREHYDRANT_BOT_TOKEN} -``` - -Note: if you are not using environment variables, you can directly type the API Bot Token into `app-config.yaml`: - -```yaml -proxy: -'/firehydrant/api': - target: 'https://api.firehydrant.io/v1/' - changeOrigin: true - headers: - # Supply the token you generated from https://app.firehydrant.io/organizations/bots - Authorization: Bearer fhb-e4911b22bcd788c4a4afeb0c111ffbfa -``` - -4. Optionally add an annotation to the yaml config file of a component - -```yaml -metadata: - annotations: - firehydrant.com/service-name: -``` +This package has been moved to the [backstage-community/plugins](https://github.com/backstage/community-plugins) repository. Migrate to using `@backstage-community/plugin-firehydrant` instead. diff --git a/plugins/firehydrant/package.json b/plugins/firehydrant/package.json index 327cac5c55..46411bfed1 100644 --- a/plugins/firehydrant/package.json +++ b/plugins/firehydrant/package.json @@ -3,7 +3,8 @@ "version": "0.2.18", "description": "A Backstage plugin that integrates towards FireHydrant", "backstage": { - "role": "frontend-plugin" + "role": "frontend-plugin", + "moved": "@backstage-community/plugin-firehydrant" }, "publishConfig": { "access": "public", @@ -72,5 +73,6 @@ } } } - } + }, + "deprecated": "This package has been moved to the backstage/community-plugins repository. You should migrate to using @backstage-community/plugin-firehydrant instead." }