Version Packages

plugins/techdocs-backend/CHANGELOG.md

@@ -1,5 +1,82 @@
 # @backstage/plugin-techdocs-backend
 
+## 1.1.2
+
+### Patch Changes
+
+- 8f7b1835df: Updated dependency `msw` to `^0.41.0`.
+- 61fba6e50b: In order to ensure a good, stable TechDocs user experience when running TechDocs with `techdocs.builder` set to `local`, the number of concurrent builds has been limited to 10. Any additional builds requested concurrently will be queued and handled as prior builds complete. In the unlikely event that you need to handle more concurrent builds, consider scaling out your TechDocs backend deployment or using the `external` option for `techdocs.builder`.
+- 5d66d4ff67: Output logs from a TechDocs build to a logging transport in addition to existing
+  frontend event stream, for capturing these logs to other sources.
+
+  This allows users to capture debugging information around why tech docs fail to build
+  without needing to rely on end users capturing information from their web browser.
+
+  The most common use case is to log to the same place as the rest of the backend
+  application logs.
+
+  Sample usage:
+
+  ```
+  import { DockerContainerRunner } from '@backstage/backend-common';
+  import {
+    createRouter,
+    Generators,
+    Preparers,
+    Publisher,
+  } from '@backstage/plugin-techdocs-backend';
+  import Docker from 'dockerode';
+  import { Router } from 'express';
+  import { PluginEnvironment } from '../types';
+
+  export default async function createPlugin(
+    env: PluginEnvironment,
+  ): Promise<Router> {
+    const preparers = await Preparers.fromConfig(env.config, {
+      logger: env.logger,
+      reader: env.reader,
+    });
+
+    const dockerClient = new Docker();
+    const containerRunner = new DockerContainerRunner({ dockerClient });
+
+    const generators = await Generators.fromConfig(env.config, {
+      logger: env.logger,
+      containerRunner,
+    });
+
+    const publisher = await Publisher.fromConfig(env.config, {
+      logger: env.logger,
+      discovery: env.discovery,
+    });
+
+    await publisher.getReadiness();
+
+    return await createRouter({
+      preparers,
+      generators,
+      publisher,
+      logger: env.logger,
+      // Passing a buildLogTransport as a parameter in createRouter will enable
+      // capturing build logs to a backend log stream
+      buildLogTransport: env.logger,
+      config: env.config,
+      discovery: env.discovery,
+      cache: env.cache,
+    });
+  }
+  ```
+
+- Updated dependencies
+  - @backstage/plugin-search-common@0.3.5
+  - @backstage/plugin-catalog-common@1.0.3
+  - @backstage/backend-common@0.14.0
+  - @backstage/integration@1.2.1
+  - @backstage/plugin-techdocs-node@1.1.2
+  - @backstage/catalog-client@1.0.3
+  - @backstage/plugin-permission-common@0.6.2
+  - @backstage/catalog-model@1.0.3
+
 ## 1.1.2-next.2
 
 ### Patch Changes

plugins/techdocs-backend/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@backstage/plugin-techdocs-backend",
   "description": "The Backstage backend plugin that renders technical documentation for your components",
-  "version": "1.1.2-next.2",
+  "version": "1.1.2",
   "main": "src/index.ts",
   "types": "src/index.ts",
   "license": "Apache-2.0",
@@ -34,16 +34,16 @@
     "clean": "backstage-cli package clean"
   },
   "dependencies": {
-    "@backstage/backend-common": "^0.14.0-next.2",
-    "@backstage/catalog-client": "^1.0.3-next.0",
-    "@backstage/catalog-model": "^1.0.3-next.0",
+    "@backstage/backend-common": "^0.14.0",
+    "@backstage/catalog-client": "^1.0.3",
+    "@backstage/catalog-model": "^1.0.3",
     "@backstage/config": "^1.0.1",
     "@backstage/errors": "^1.0.0",
-    "@backstage/integration": "^1.2.1-next.2",
-    "@backstage/plugin-catalog-common": "^1.0.3-next.1",
-    "@backstage/plugin-permission-common": "^0.6.2-next.0",
-    "@backstage/plugin-search-common": "^0.3.5-next.1",
-    "@backstage/plugin-techdocs-node": "^1.1.2-next.2",
+    "@backstage/integration": "^1.2.1",
+    "@backstage/plugin-catalog-common": "^1.0.3",
+    "@backstage/plugin-permission-common": "^0.6.2",
+    "@backstage/plugin-search-common": "^0.3.5",
+    "@backstage/plugin-techdocs-node": "^1.1.2",
     "@types/express": "^4.17.6",
     "dockerode": "^3.3.1",
     "express": "^4.17.1",
@@ -56,9 +56,9 @@
     "winston": "^3.2.1"
   },
   "devDependencies": {
-    "@backstage/backend-test-utils": "^0.1.25-next.2",
-    "@backstage/cli": "^0.17.2-next.2",
-    "@backstage/plugin-search-backend-node": "0.6.2-next.2",
+    "@backstage/backend-test-utils": "^0.1.25",
+    "@backstage/cli": "^0.17.2",
+    "@backstage/plugin-search-backend-node": "0.6.2",
     "@types/dockerode": "^3.3.0",
     "msw": "^0.42.0",
     "supertest": "^6.1.3"