backstage/plugins/azure-sites-backend

Azure Sites Backend

Simple plugin that proxies requests to the Azure Portal API through Azure SDK JavaScript libraries.

Inspired by roadie.io AWS Lambda plugin

Setup

The following sections will help you get the Azure Sites Backend plugin setup and running.

Configuration

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

azureSites:
  domain:
  tenantId:
  clientId:
  clientSecret:
  allowedSubscriptions:
    - id:

Configuration Details:

• domain can be found by visiting the Directories + Subscriptions settings page. Alternatively you can inspect the Azure home URL - https://portal.azure.com/#@<Your_Domain>/.
• tenantId can be found by visiting Azure Directory Overview page.
• (Optional) clientId and clientSecret can be the same values you used for Azure DevOps Backend or Azure Integration as long as this App Registration has permissions to read your function apps.
• (Optional) allowedSubscriptions is an array of id that will be used to iterate over and look for the specified functions' app. id can be found the Subscriptions page.

Integrating

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

1. First we need to add the @backstage/plugin-azure-sites-backend package to your backend:

   # From your Backstage root directory
   yarn add --cwd packages/backend @backstage/plugin-azure-sites-backend
   

2. Then we will create a new file named packages/backend/src/plugins/azure.ts, and add the following to it:

   import {
     createRouter,
     AzureSitesApi,
   } from '@backstage/plugin-azure-sites-backend';
   import { Router } from 'express';
   import { PluginEnvironment } from '../types';
   
   export default async function createPlugin(
     env: PluginEnvironment,
   ): Promise<Router> {
     return await createRouter({
       logger: env.logger,
       azureSitesApi: AzureSitesApi.fromConfig(env.config),
     });
   }
   

3. Next we wire this into the overall backend router, edit packages/backend/src/index.ts:

   import azure from './plugins/azure';
   
   // Removed for clarity...
   
   async function main() {
     // ...
     // Add this line under the other lines that follow the useHotMemoize pattern
     const azureSitesEnv = useHotMemoize(module, () =>
       createEnv('azure-sites'),
     );
   
     // ...
     // Insert this line under the other lines that add their routers to apiRouter in the same way
     apiRouter.use('/azure-sites', await azure(azureSitesEnv));
   }
   

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

5. Finally, open http://localhost:7007/api/azure-sites/health in a browser, it should return {"status":"ok"}.