@@ -0,0 +1,6 @@
|
||||
---
|
||||
'@backstage/plugin-cicd-statistics': patch
|
||||
'@backstage/plugin-cicd-statistics-module-gitlab': patch
|
||||
---
|
||||
|
||||
These packages have been migrated to the [backstage/community-plugins](https://github.com/backstage/community-plugins) repository.
|
||||
@@ -1,39 +1,3 @@
|
||||
# cicd-statistics-module-gitlab
|
||||
# Deprecated
|
||||
|
||||
This is an extension module to the `cicd-statistics` plugin, providing a `CicdStatisticsApiGitlab` that you can use to extract the CI/CD statistics from your Gitlab repository.
|
||||
|
||||
## Getting started
|
||||
|
||||
1. Install the `cicd-statistics` and `cicd-statistics-module-gitlab` plugins in the `app` package.
|
||||
|
||||
2. Configure your ApiFactory:
|
||||
- You can optionally pass in a second argument to `CicdStatisticsApiGitlab` of type [CicdDefaults](https://github.com/backstage/backstage/blob/2881c53cb383bf127c150f837f37fe535d8cf97b/plugins/cicd-statistics/src/apis/types.ts#L179) to alter the default CICD UI configuration
|
||||
|
||||
```tsx
|
||||
// packages/app/src/apis.ts
|
||||
import { gitlabAuthApiRef } from '@backstage/core-plugin-api';
|
||||
|
||||
import { cicdStatisticsApiRef } from '@backstage/plugin-cicd-statistics';
|
||||
import { CicdStatisticsApiGitlab } from '@backstage/plugin-cicd-statistics-module-gitlab';
|
||||
|
||||
export const apis: AnyApiFactory[] = [
|
||||
createApiFactory({
|
||||
api: cicdStatisticsApiRef,
|
||||
deps: { gitlabAuthApi: gitlabAuthApiRef },
|
||||
factory({ gitlabAuthApi }) {
|
||||
return new CicdStatisticsApiGitlab(gitlabAuthApi);
|
||||
},
|
||||
}),
|
||||
];
|
||||
```
|
||||
|
||||
3. Add the component to your EntityPage:
|
||||
|
||||
```tsx
|
||||
// packages/app/src/components/catalog/EntityPage.tsx
|
||||
import { EntityCicdStatisticsContent } from '@backstage/plugin-cicd-statistics';
|
||||
|
||||
<EntityLayout.Route path="/ci-cd-statistics" title="CI/CD Statistics">
|
||||
<EntityCicdStatisticsContent />
|
||||
</EntityLayout.Route>;
|
||||
```
|
||||
This package has been moved to the [backstage-community/plugins](https://github.com/backstage/community-plugins) repository. Migrate to using `@backstage-community/plugin-cicd-statistics-module-gitlab` instead.
|
||||
|
||||
@@ -3,7 +3,8 @@
|
||||
"version": "0.1.30",
|
||||
"description": "CI/CD Statistics plugin module; Gitlab CICD",
|
||||
"backstage": {
|
||||
"role": "frontend-plugin-module"
|
||||
"role": "frontend-plugin-module",
|
||||
"moved": "@backstage-community/plugin-cicd-statistics-module-gitlab"
|
||||
},
|
||||
"publishConfig": {
|
||||
"access": "public",
|
||||
@@ -53,5 +54,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-cicd-statistics-module-gitlab instead."
|
||||
}
|
||||
|
||||
@@ -1,13 +1,3 @@
|
||||
# CI/CD Statistics Plugin
|
||||
# Deprecated
|
||||
|
||||
This plugin shows charts of CI/CD pipeline durations over time. It expects to be used on the Software Catalog entity page, as it uses `useEntity` to figure out what component to get the build information for.
|
||||
|
||||
## Usage
|
||||
|
||||
> This plugin cannot be used as-is; it requires a custom implementation to fetch build information
|
||||
|
||||
To use this plugin, you need to implement an API `CicdStatisticsApi` and bind it to the `cicdStatisticsApiRef`. This API is defined in `src/apis/types.ts` and is an interface with two functions, `getConfiguration(options)` and `fetchBuilds(options)`. This plugin will call `getConfiguration` to allow the implementation to specify defaults and settings for the UI.
|
||||
|
||||
First time the UI shows, and each time the user changes filters and clicks `Update` to refresh the data, `fetchBuilds` is invoked with the filter options. The API implementation is the expected to fetch build information from somewhere, format it into a generic and rather simple type `Build` (also defined in `types.ts`). The API can optionally signal completion for a progress bar in the UI.
|
||||
|
||||
When this plugin has fetched the builds, it will transpose the list of builds (and build stages) into a tree of build stages. As build pipelines sometimes change, certain stages might end or begin within the date range of the view (when _Normalize time range_ is enabled, which is the default).
|
||||
This package has been moved to the [backstage-community/plugins](https://github.com/backstage/community-plugins) repository. Migrate to using `@backstage-community/plugin-cicd-statistics` instead.
|
||||
|
||||
@@ -3,7 +3,8 @@
|
||||
"version": "0.1.36",
|
||||
"description": "A frontend plugin visualizing CI/CD pipeline statistics (build time)",
|
||||
"backstage": {
|
||||
"role": "frontend-plugin"
|
||||
"role": "frontend-plugin",
|
||||
"moved": "@backstage-community/plugin-cicd-statistics"
|
||||
},
|
||||
"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-cicd-statistics instead."
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user