Merge pull request #10528 from LvffY/master

Update documentation
This commit is contained in:
Ben Lambert
2022-04-01 10:55:41 +02:00
committed by GitHub
48 changed files with 75 additions and 113 deletions
+1 -1
View File
@@ -34,7 +34,7 @@ _If you're using Backstage in your organization, please try to add your company
| [Netflix](https://www.netflix.com/) | [bleathem](https://github.com/bleathem) | Our Backstage implementation will be the front door to a unified experience connecting our internal platform products across important workflows with integrated knowledge and support. |
| [b.well](https://www.icanbwell.com/) | [Jacob Rosales](https://github.com/jrosales) | Foundation for our engineering portal and cloud insights. |
| [PagerDuty](https://www.pagerduty.com/) | [Mark Shaw](https://github.com/markshawtoronto) | Developer portal, initially focused on software templates and tech-docs. |
| [MoonShiner](https://moonshiner.at) | [Fabian Hippmann](https://github.com/FabianHippmann) | Developer portal - helps us keep track of our customer projects, onboard new developers & improve our development process 🌕🚀🧑‍🚀 |
| [MoonShiner](https://moonshiner.at) | [Fabian Hippmann](https://github.com/FabianHippmann) | Developer portal - helps us keep track of our customer projects, onboard new developers & improve our development process 🌕🚀🧑‍🚀 |
| [FundApps](https://www.fundapps.co/) | [Elliot Greenwood](https://github.com/egnwd) | Developer Portal - A place for us to keep track of our projects and documentation for all services and processes |
| [DAZN](https://dazn.com/) | [Lou Bichard](https://twitter.com/loujaybee), [Marco Crivellaro](https://github.com/crivetechie), [Alex Hollerith](mailto:alex.hollerith@dazn.com) | Ingesting all of DAZN's repos for the catalog, migrating our internal platform apps (pull request boards, release information, inner source marketplace etc) to Backstage plugins (where applicable). |
| [HelloFresh](https://www.hellofresh.de/) | [@iammuho](https://github.com/iammuho), [@ElenaForester](https://github.com/ElenaForester), [@diegomarangoni](https://github.com/diegomarangoni) | Our developer portal at HelloFresh - Spread across an organisation of 500+ engineers globally. |
+7 -1
View File
@@ -73,4 +73,10 @@ When using a custom pattern, the target is composed of five parts:
_Note:_ the path parameter follows the same rules as the search on Azure DevOps
web interface. For more details visit the
[official search documentation](https://docs.microsoft.com/en-us/azure/devops/project/search/get-started-search?view=azure-devops)
[official search documentation](https://docs.microsoft.com/en-us/azure/devops/project/search/get-started-search?view=azure-devops).
Azure discovery is driven by the Code Search feature in Azure DevOps, this may not be enabled by default. For Azure
DevOps Services you can confirm this by looking at the installed extensions in your Organization Settings. For Azure
DevOps Server you'll find this information in your Collection Settings.
If the Code Search extension is not listed then you can install it from the [Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=ms.vss-code-search&targetId=f9352dac-ba6e-434e-9241-a848a510ce3f&utm_source=vstsproduct&utm_medium=SearchExtStatus).
@@ -102,8 +102,7 @@ Install in your apps package folder (`<root>/packages/app`) with:
```bash
# From your Backstage root directory
cd packages/app
yarn add @backstage/plugin-<plugin-name>
yarn add --cwd packages/app @backstage/plugin-<plugin-name>
```
After that, you inject the plugin into the application where you want it to be exposed. Please read the documentation for the specific plugin you are installing for more information.
+3 -3
View File
@@ -6,9 +6,9 @@ This package provides a default wiring of a Backstage app that avoids boilerplat
Install the package via Yarn:
```sh
cd packages/app
yarn add @backstage/app-defaults
```bash
# From your Backstage root directory
yarn add --cwd packages/app @backstage/app-defaults
```
## Documentation
+2 -3
View File
@@ -7,10 +7,9 @@ error handling and similar.
Add the library to your backend package:
```sh
```bash
# From your Backstage root directory
cd packages/backend
yarn add @backstage/backend-common
yarn add --cwd packages/backend @backstage/backend-common
```
then make use of the handlers and logger as necessary:
+2 -3
View File
@@ -6,10 +6,9 @@ Common distributed task management for Backstage backends.
Add the library to your backend package:
```sh
```bash
# From your Backstage root directory
cd packages/backend
yarn add @backstage/backend-tasks
yarn add --cwd packages/backend @backstage/backend-tasks
```
then make use of its facilities as necessary:
+2 -3
View File
@@ -6,9 +6,8 @@ This package provides the core API used by Backstage apps.
Install the package via Yarn:
```sh
cd packages/app
yarn add @backstage/core-app-api
```bash
yarn add --cwd packages/app @backstage/core-app-api
```
## Documentation
@@ -21,8 +21,9 @@ import {
import React, { ReactNode, useContext } from 'react';
import { AnalyticsContextValue } from './types';
const AnalyticsReactContext =
createVersionedContext<{ 1: AnalyticsContextValue }>('analytics-context');
const AnalyticsReactContext = createVersionedContext<{
1: AnalyticsContextValue;
}>('analytics-context');
/**
* A "private" (to this package) hook that enables context inheritance and a
+2 -4
View File
@@ -8,16 +8,14 @@ The Airbrake plugin provides connectivity between Backstage and Airbrake (https:
```bash
# From your Backstage root directory
cd packages/app
yarn add @backstage/plugin-airbrake
yarn add --cwd packages/app @backstage/plugin-airbrake
```
2. Install the Backend plugin:
```bash
# From your Backstage root directory
cd packages/backend
yarn add @backstage/plugin-airbrake-backend
yarn add --cwd packages/backend @backstage/plugin-airbrake-backend
```
3. Add the `EntityAirbrakeContent` to `packages/app/src/components/catalog/EntityPage.tsx` for all the entity pages you want Airbrake to be in:
+1 -2
View File
@@ -29,8 +29,7 @@ To link that a component provides or consumes an API, see the [`providesApis`](h
```bash
# From your Backstage root directory
cd packages/app
yarn add @backstage/plugin-api-docs
yarn add --cwd packages/app @backstage/plugin-api-docs
```
2. Add the `ApiExplorerPage` extension to the app:
+1 -2
View File
@@ -8,8 +8,7 @@ Add both this package and your local frontend app package as dependencies to you
```bash
# From your Backstage root directory
cd packages/backend
yarn add @backstage/plugin-app-backend app
yarn add --cwd packages/backend @backstage/plugin-app-backend app
```
By adding the app package as a dependency we ensure that it is built as part of the backend, and that it can be resolved at runtime.
+2 -4
View File
@@ -68,8 +68,7 @@ To get the Azure Pipelines component working you'll need to do the following two
```bash
# From your Backstage root directory
cd packages/app
yarn add @backstage/plugin-azure-devops
yarn add --cwd packages/app @backstage/plugin-azure-devops
```
2. Second we need to add the `EntityAzurePipelinesContent` extension to the entity page in your app. How to do this will depend on which annotation you are using in your entities:
@@ -127,8 +126,7 @@ To get the Azure Repos component working you'll need to do the following two ste
```bash
# From your Backstage root directory
cd packages/app
yarn add @backstage/plugin-azure-devops
yarn add --cwd packages/app @backstage/plugin-azure-devops
```
2. Second we need to add the `EntityAzurePullRequestsContent` extension to the entity page in your app:
+1 -2
View File
@@ -8,8 +8,7 @@ Welcome to the Bazaar backend plugin!
```bash
# From your Backstage root directory
cd packages/backend
yarn add @backstage/plugin-bazaar-backend
yarn add --cwd packages/backend @backstage/plugin-bazaar-backend
```
## Adding the plugin to your `packages/backend`
+2 -3
View File
@@ -16,10 +16,9 @@ The Bazaar allows engineers and teams to open up and announce their new and exci
First install the plugin into your app:
```sh
```bash
# From your Backstage root directory
cd packages/app
yarn add @backstage/plugin-bazaar
yarn add --cwd packages/app @backstage/plugin-bazaar
```
Modify your app routes in `packages/app/src/App.tsx` to include the `Bazaar` component exported from the plugin, for example:
+2 -3
View File
@@ -7,10 +7,9 @@ Welcome to the Bitrise plugin!
## Installation
```sh
```bash
# From your Backstage root directory
cd packages/app
yarn add @backstage/plugin-bitrise
yarn add --cwd packages/app @backstage/plugin-bitrise
```
Bitrise Plugin exposes an entity tab component named `EntityBitriseContent`. You can include it in the
@@ -84,8 +84,7 @@ By default, all users are loaded. If you want to filter users based on their att
```bash
# From your Backstage root directory
cd packages/backend
yarn add @backstage/plugin-catalog-backend-module-msgraph
yarn add --cwd packages/backend @backstage/plugin-catalog-backend-module-msgraph
```
### Using the Entity Provider
+1 -2
View File
@@ -27,8 +27,7 @@ restoring the plugin, if you previously removed it.
```bash
# From your Backstage root directory
cd packages/backend
yarn add @backstage/plugin-catalog-backend
yarn add --cwd packages/backend @backstage/plugin-catalog-backend
```
### Adding the plugin to your `packages/backend`
+1 -2
View File
@@ -19,8 +19,7 @@ Some features are not yet available for all supported Git providers.
```bash
# From your Backstage root directory
cd packages/app
yarn add @backstage/plugin-catalog-import
yarn add --cwd packages/app @backstage/plugin-catalog-import
```
2. Add the `CatalogImportPage` extension to the app:
+1 -2
View File
@@ -20,8 +20,7 @@ plugin, if you previously removed it.
```bash
# From your Backstage root directory
cd packages/app
yarn add @backstage/plugin-catalog
yarn add --cwd packages/app @backstage/plugin-catalog
```
### Add the plugin to your `packages/app`
+1 -2
View File
@@ -11,8 +11,7 @@ Website: [https://circleci.com/](https://circleci.com/)
```bash
# From your Backstage root directory
cd packages/app
yarn add @backstage/plugin-circleci
yarn add --cwd packages/app @backstage/plugin-circleci
```
2. Add the `EntityCircleCIContent` extension to the entity page in your app:
+1 -2
View File
@@ -10,8 +10,7 @@ The Code Climate Plugin displays a few stats from the quality section from [Code
```bash
# From your Backstage root directory
cd packages/app
yarn add @backstage/plugin-code-climate
yarn add --cwd packages/app @backstage/plugin-code-climate
```
2. Add the `EntityCodeClimateCard` to the EntityPage:
+1 -2
View File
@@ -17,8 +17,7 @@ Learn more with the Backstage blog post [New Cost Insights plugin: The engineer'
```bash
# From your Backstage root directory
cd packages/app
yarn add @backstage/plugin-cost-insights
yarn add --cwd packages/app @backstage/plugin-cost-insights
```
## Setup
@@ -34,8 +34,7 @@ Install the AWS Cost Explorer SDK. The AWS docs recommend using the SDK over mak
```bash
# From your Backstage root directory
cd packages/app
yarn add @aws-sdk/client-cost-explorer
yarn add --cwd packages/app @aws-sdk/client-cost-explorer
```
## Usage of the SDK
+1 -2
View File
@@ -18,8 +18,7 @@ The [FireHydrant](https://firehydrant.io) plugin brings incident management to B
```bash
# From your Backstage root directory
cd packages/app
yarn add @backstage/plugin-firehydrant
yarn add --cwd packages/app @backstage/plugin-firehydrant
```
2. Add the plugin to `EntityPage.tsx`, inside the `const overviewContent`'s parent `<Grid>` component:
+1 -2
View File
@@ -10,8 +10,7 @@ The FOSSA Plugin displays code statistics from [FOSSA](https://fossa.com/).
```bash
# From your Backstage root directory
cd packages/app
yarn add @backstage/plugin-fossa
yarn add --cwd packages/app @backstage/plugin-fossa
```
2. Add the `EntityFossaCard` to the EntityPage:
+1 -2
View File
@@ -39,8 +39,7 @@ TBD
```bash
# From your Backstage root directory
cd packages/app
yarn add @backstage/plugin-github-actions
yarn add --cwd packages/app @backstage/plugin-github-actions
```
2. Add to the app `EntityPage` component:
+1 -2
View File
@@ -14,8 +14,7 @@ The GitHub Deployments Plugin displays recent deployments from GitHub.
```bash
# From your Backstage root directory
cd packages/app
yarn add @backstage/plugin-github-deployments
yarn add --cwd packages/app @backstage/plugin-github-deployments
```
2. Add the `EntityGithubDeploymentsCard` to the EntityPage:
+1 -2
View File
@@ -13,8 +13,7 @@ Start out by installing the plugin in your Backstage app:
```bash
# From your Backstage root directory
cd packages/app
yarn add @backstage/plugin-graphiql
yarn add --cwd packages/app @backstage/plugin-graphiql
```
```diff
+1 -2
View File
@@ -10,8 +10,7 @@ If you have a standalone app (you didn't clone this repo), then do
```bash
# From the Backstage repository root
cd packages/app
yarn add @backstage/plugin-home
yarn add --cwd packages/app @backstage/plugin-home
```
### Setting up the Home Page
+1 -2
View File
@@ -27,8 +27,7 @@ Install the plugin:
```bash
# From the Backstage repository root
cd packages/app
yarn add @backstage/plugin-ilert
yarn add --cwd packages/app @backstage/plugin-ilert
```
Add it to the `EntityPage.tsx`:
+1 -2
View File
@@ -14,8 +14,7 @@ This plugin needs to be added to an existing backstage instance.
```bash
# From your Backstage root directory
cd packages/backend
yarn add @backstage/plugin-jenkins-backend
yarn add --cwd packages/backend @backstage/plugin-jenkins-backend
```
Typically, this means creating a `src/plugins/jenkins.ts` file and adding a reference to it to `src/index.ts`
+1 -2
View File
@@ -12,8 +12,7 @@ Website: [https://jenkins.io/](https://jenkins.io/)
```bash
# From your Backstage root directory
cd packages/app
yarn add @backstage/plugin-jenkins
yarn add --cwd packages/app @backstage/plugin-jenkins
```
2. Add and configure the [jenkins-backend](../jenkins-backend) plugin according to it's instructions
+2 -3
View File
@@ -27,10 +27,9 @@ _It's likely you will need to [enable CORS](https://developer.mozilla.org/en-US/
When you have an instance running that Backstage can hook into, first install the plugin into your app:
```sh
```bash
# From your Backstage root directory
cd packages/app
yarn add @backstage/plugin-lighthouse
yarn add --cwd packages/app @backstage/plugin-lighthouse
```
Modify your app routes in `App.tsx` to include the `LighthousePage` component exported from the plugin, for example:
+2 -4
View File
@@ -42,8 +42,7 @@ First, install the PagerDuty plugin via a CLI:
```bash
# From your Backstage app root directory
cd packages/app
yarn add @backstage/plugin-pagerduty
yarn add --cwd packages/app @backstage/plugin-pagerduty
```
Next, add the plugin to `EntityPage.tsx` in `packages/app/src/components/catalog` by adding the following code snippets.
@@ -133,8 +132,7 @@ pagerduty:
```bash
# From your Backstage root directory
cd packages/app
yarn remove @backstage/plugin-pagerduty
yarn remove --cwd packages/app @backstage/plugin-pagerduty
```
4. [Delete the integration](https://support.pagerduty.com/docs/services-and-integrations#delete-an-integration-from-a-service) from the service in PagerDuty
+1 -2
View File
@@ -19,8 +19,7 @@ Each of the entries in the table will direct you to the error details in your de
```bash
# From your Backstage root directory
cd packages/app
yarn add @backstage/plugin-periskop
yarn add --cwd packages/app @backstage/plugin-periskop
```
3. Add to the app `EntityPage` component:
+1 -2
View File
@@ -10,8 +10,7 @@ Website: [https://rollbar.com/](https://rollbar.com/)
```bash
# From your Backstage root directory
cd packages/app
yarn add @backstage/plugin-rollbar
yarn add --cwd packages/app @backstage/plugin-rollbar
```
3. Add to the app `EntityPage` component:
@@ -8,9 +8,9 @@ You need to configure the action in your backend:
## From your Backstage root directory
```
cd packages/backend
yarn add @backstage/plugin-scaffolder-backend-module-cookiecutter
```bash
# From your Backstage root directory
yarn add --cwd packages/backend @backstage/plugin-scaffolder-backend-module-cookiecutter
```
Configure the action:
@@ -13,9 +13,9 @@ You need to configure the action in your backend:
## From your Backstage root directory
```
cd packages/backend
yarn add @backstage/plugin-scaffolder-backend-module-rails
```bash
# From your Backstage root directory
yarn add --cwd packages/backend @backstage/plugin-scaffolder-backend-module-rails
```
Configure the action (you can check
@@ -8,9 +8,9 @@ You need to configure the action in your backend:
## From your Backstage root directory
```
cd packages/backend
yarn add @backstage/plugin-scaffolder-backend-module-yeoman
```bash
# From your Backstage root directory
yarn add --cwd packages/backend @backstage/plugin-scaffolder-backend-module-yeoman
```
Configure the action:
+1 -2
View File
@@ -21,8 +21,7 @@ restoring the plugin, if you previously removed it.
```bash
# From your Backstage root directory
cd packages/backend
yarn add @backstage/plugin-scaffolder-backend
yarn add --cwd packages/backend @backstage/plugin-scaffolder-backend
```
### Adding the plugin to your `packages/backend`
+1 -2
View File
@@ -20,8 +20,7 @@ the plugin, if you previously removed it.
```bash
# From your Backstage root directory
cd packages/app
yarn add @backstage/plugin-scaffolder
yarn add --cwd packages/app @backstage/plugin-scaffolder
```
### Add the plugin to your `packages/app`
+1 -2
View File
@@ -10,8 +10,7 @@ The Sentry Plugin displays issues from [Sentry](https://sentry.io).
```bash
# From your Backstage root directory
cd packages/app
yarn add @backstage/plugin-sentry
yarn add --cwd packages/app @backstage/plugin-sentry
```
2. Add the `EntitySentryCard` to the EntityPage:
+1 -2
View File
@@ -10,8 +10,7 @@ The SonarQube Plugin displays code statistics from [SonarCloud](https://sonarclo
```bash
# From your Backstage root directory
cd packages/app
yarn add @backstage/plugin-sonarqube
yarn add --cwd packages/app @backstage/plugin-sonarqube
```
2. Add the `EntitySonarQubeCard` to the EntityPage:
+1 -2
View File
@@ -21,8 +21,7 @@ Install the plugin:
```bash
# From your Backstage root directory
cd packages/app
yarn add @backstage/plugin-splunk-on-call
yarn add --cwd packages/app @backstage/plugin-splunk-on-call
```
Add it to your `EntityPage`:
@@ -10,8 +10,7 @@ To add this FactChecker into your Tech Insights you need to install the module i
```bash
# From your Backstage root directory
cd packages/backend
yarn add @backstage/plugin-tech-insights-backend-module-jsonfc
yarn add --cwd packages/backend @backstage/plugin-tech-insights-backend-module-jsonfc
```
and modify the `techInsights.ts` file to contain a reference to the FactCheckers implementation.
+2 -4
View File
@@ -10,8 +10,7 @@ as well as a framework to run fact retrievers and store fact values in to a data
```bash
# From your Backstage root directory
cd packages/backend
yarn add @backstage/plugin-tech-insights-backend
yarn add --cwd packages/backend @backstage/plugin-tech-insights-backend
```
### Adding the plugin to your `packages/backend`
@@ -197,8 +196,7 @@ To add the default FactChecker into your Tech Insights you need to install the m
```bash
# From your Backstage root directory
cd packages/backend
yarn add @backstage/plugin-tech-insights-backend-module-jsonfc
yarn add --cwd packages/backend @backstage/plugin-tech-insights-backend-module-jsonfc
```
and modify the `techInsights.ts` file to contain a reference to the FactChecker implementation.
+1 -2
View File
@@ -14,8 +14,7 @@ Main areas covered by this plugin currently are:
```bash
# From your Backstage root directory
cd packages/app
yarn add @backstage/plugin-tech-insights
yarn add --cwd packages/app @backstage/plugin-tech-insights
```
### Add boolean checks overview (Scorecards) page to the EntityPage:
+2 -3
View File
@@ -25,10 +25,9 @@ The Tech Radar can be used in two ways:
For either simple or advanced installations, you'll need to add the dependency using Yarn:
```sh
```bash
# From your Backstage root directory
cd packages/app
yarn add @backstage/plugin-tech-radar
yarn add --cwd packages/app @backstage/plugin-tech-radar
```
### Configuration