Jira Dashboard Backend

A plugin that makes requests to Atlassian REST API to get issues and project information from Jira.

The frontend plugin that displays this information is Jira Dashboard.

Setup

The following sections will help you get the Jira Dashboard Backend plugin setup and running.

Installation

Install the plugin by following the example below:

# From your Backstage root directory
yarn --cwd packages/backend add @axis-backstage/plugin-jira-dashboard-backend

Configuration

The Jira Dashboard plugin requires the following YAML to be added to your app-config.yaml:

jiraDashboard:
  token: ${JIRA_TOKEN}
  baseUrl: ${JIRA_BASE_URL}
  userEmailSuffix: ${JIRA_EMAIL_SUFFIX}
  annotationPrefix: ${JIRA_ANNOTATION_PREFIX} # Optional

Configuration Details:

• JIRA_TOKEN: The API token to authenticate towards Jira. It can be found by visiting Atlassians page at https://developer.atlassian.com/cloud/jira/platform/basic-auth-for-rest-apis/. In case you are using a Bearer or Basic token, you need to add it in the beginning of the token. For instance: Bearer your-secret-token

  Note: The JIRA_TOKEN variable from Roadie's Backstage Jira plugin can not be reused here because of the added encoding in this token.

• JIRA_BASE_URL: The base url for Jira in your company, including the API version. For instance: https://jira.se.your-company.com/rest/api/2/
• JIRA_EMAIL_SUFFIX: The email suffix used for retrieving a specific Jira user in a company. For instance: @your-company.com
• JIRA_ANNOTATION_PREFIX: Optional annotation prefix for retrieving a custom annotation. Defaut value is jira.com. If you want to configure the plugin to be compatible with Roadie's Backstage Jira Plugin, use the following annotation prefix:

jiraDashboard:
   {/* required configs... */}
  annotationPrefix: jira

Integrating

Here's how to get the backend plugin up and running:

1. Create a new file named packages/backend/src/plugins/jiraDashboard.ts, and add the following to it:

   import { createRouter } from '@axis-backstage/plugin-jira-dashboard-backend';
   import { Router } from 'express';
   import { PluginEnvironment } from '../types';
   
   export default async function createPlugin(
     env: PluginEnvironment,
   ): Promise<Router> {
     return await createRouter({
       logger: env.logger,
       config: env.config,
       discovery: env.discovery,
       identity: env.identity,
       tokenManager: env.tokenManager,
     });
   }

2. Wire this into the overall backend router by adding the following to packages/backend/src/index.ts:

   import jiraDashboard from './plugins/jiraDashboard';
   ...
   
   async function main() {
     // Add this line under the other lines that follow the useHotMemoize pattern
    const jiraDashboardEnv = useHotMemoize(module, () => createEnv('jira-dashboard'),
   
     // Add this under the lines that add their routers to apiRouter
    apiRouter.use('/jira-dashboard', await jiraDashboard(jiraDashboardEnv));
   }

3. Now run yarn start-backend from the repo root.

4. In another terminal, run the command: curl localhost:7007/api/jira-dashboard/health. The request should return {"status":"ok"}.

New Backend System

The Jira Dashboard backend plugin has support for the new backend system. Here is how you can set it up:

In your packages/backend/src/index.ts make the following changes:

+ import { jiraDashboardPlugin } from '@axis-backstage/plugin-jira-dashboard-backend';

const backend = createBackend();
+ backend.add(jiraDashboardPlugin());
// ... other feature additions

backend.start();