0.1.0 • Published 2 months ago
backstage-plugin-blackduck-backend v0.1.0
backstage-plugin-blackduck-backend
Welcome to the backstage-plugin-blackduck-backend backend plugin!
Getting started
Installation
This plugin needs to be added to an existing backstage instance.
# From your Backstage root directory
yarn add --cwd packages/backend backstage-plugin-blackduck-backend
New Backend System
This backend plugin has support for the new backend system, here's how you can set that up:
In your packages/backend/src/index.ts
make the following changes:
import { createBackend } from '@backstage/backend-defaults';
const backend = createBackend();
// ... other feature additions
+ backend.add(import('backstage-plugin-blackduck-backend'));
// ...
backend.start();
Legacy Backend System
Create a file called blackduck.ts inside packages/backend/src/plugins/
and add the following:
blackduck.ts
import { createRouter } from 'backstage-plugin-blackduck-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,
});
}
And import the plugin to packages/backend/src/index.ts
.
src/index.ts
diff --git a/packages/backend/src/index.ts b/packages/backend/src/index.ts
index c4736a5..5822302 100644
--- a/packages/backend/src/index.ts
+++ b/packages/backend/src/index.ts
@@ -28,6 +28,7 @@ import scaffolder from './plugins/scaffolder';
import proxy from './plugins/proxy';
import techdocs from './plugins/techdocs';
import search from './plugins/search';
+import blackduck from './plugins/blackduck';
import { PluginEnvironment } from './types';
import { ServerPermissionClient } from '@backstage/plugin-permission-node';
import { DefaultIdentityClient } from '@backstage/plugin-auth-node';
@@ -85,6 +86,7 @@ async function main() {
const techdocsEnv = useHotMemoize(module, () => createEnv('techdocs'));
const searchEnv = useHotMemoize(module, () => createEnv('search'));
const appEnv = useHotMemoize(module, () => createEnv('app'));
+ const blackduckEnv = useHotMemoize(module, () => createEnv('blackduck'));
const apiRouter = Router();
apiRouter.use('/catalog', await catalog(catalogEnv));
@@ -93,6 +95,7 @@ async function main() {
apiRouter.use('/techdocs', await techdocs(techdocsEnv));
apiRouter.use('/proxy', await proxy(proxyEnv));
apiRouter.use('/search', await search(searchEnv));
+ apiRouter.use('/blackduck', await blackduck(blackduckEnv));
// Add backends ABOVE this line; this 404 handler is the catch-all fallback
apiRouter.use(notFoundHandler());
Continue with Frontend Plugin
Follow the Docs from README.md
Configuration
Add the following into your app-config.yaml
Config
blackduck:
host: https://blackduck.yourcompany.com/api
token: YOUR_API_TOKEN
Add the following into your catalog
Catalog
apiVersion: backstage.io/v1alpha1
kind: Component
metadata:
name: backstage
annotations:
blackduck/project: YOUR_PROJECT_NAME/YOUR_PROJECT_VERSION