Website: https://gitlab.com/
# From your Backstage root directory
cd packages/app
yarn add @loblaw/backstage-plugin-gitlab
// packages/app/src/components/catalog/EntityPage.tsx
import { isGitlabAvailable, EntityGitlabContent } from '@loblaw/backstage-plugin-gitlab';
// Farther down at the serviceEntityPage declaration
const serviceEntityPage = (
<EntityLayout>
{/* Place the following section where you want the tab to appear */}
<EntityLayout.Route if={isGitlabAvailable} path="/gitlab" title="Gitlab">
<EntityGitlabContent />
</EntityLayout.Route>
</EntityLayout>
);
// packages/app/src/components/catalog/EntityPage.tsx
import {
isGitlabAvailable,
EntityGitlabContent,
EntityGitlabLanguageCard,
EntityGitlabContributorsCard,
EntityGitlabMergeRequestsTable,
EntityGitlabMergeRequestStatsCard,
EntityGitlabPipelinesTable
} from '@loblaw/backstage-plugin-gitlab';
//Farther down at the overviewContent declaration
//You can add only selected widgets or all of them.
const overviewContent = (
<Grid container spacing={3} alignItems="stretch">
<EntitySwitch>
<EntitySwitch.Case if={isGitlabAvailable}>
<Grid item md={6}>
<EntityGitlabContributorsCard />
<EntityGitlabLanguageCard />
<EntityGitlabMergeRequestStatsCard />
<EntityGitlabPipelinesTable />
<EntityGitlabMergeRequestsTable />
</Grid>
</EntitySwitch.Case>
</EntitySwitch>
</Grid>
);
Add integration:
In app-config.yaml
add the integration for gitlab:
integrations:
gitlab:
- host: gitlab.com
token: ${GITLAB_TOKEN}
Add proxy config:
'/gitlabci':
target: '${GITLAB_URL}/api/v4'
allowedMethods: ['GET']
headers:
PRIVATE-TOKEN: '${GITLAB_TOKEN}'
https://gitlab.com
read_api
and can be generated from this URLgitlab.com/project-id
annotation to your respective catalog-info.yaml
files, on the format# Example catalog-info.yaml entity definition file
apiVersion: backstage.io/v1alpha1
kind: Component
metadata:
# ...
annotations:
gitlab.com/project-id: 'project-id' #1234. This must be in quotes and can be found under Settings --> General
or
gitlab.com/project-slug: 'project-slug' # group_name/project_name
spec:
type: service
# ...
Note: spec.type
can take values in ['website','library','service'] but to render GitLab Entity, Catalog must be of type service