Version Packages (next)

plugins/techdocs-backend/CHANGELOG.md

@@ -1,5 +1,75 @@
 # @backstage/plugin-techdocs-backend
 
+## 1.1.2-next.0
+
+### Patch Changes
+
+- 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/backend-common@0.13.6-next.0
+  - @backstage/integration@1.2.1-next.0
+  - @backstage/plugin-techdocs-node@1.1.2-next.0
+
 ## 1.1.1
 
 ### 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.1",
+  "version": "1.1.2-next.0",
   "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.13.3",
+    "@backstage/backend-common": "^0.13.6-next.0",
     "@backstage/catalog-client": "^1.0.2",
     "@backstage/catalog-model": "^1.0.2",
     "@backstage/config": "^1.0.1",
     "@backstage/errors": "^1.0.0",
-    "@backstage/integration": "^1.2.0",
+    "@backstage/integration": "^1.2.1-next.0",
     "@backstage/plugin-catalog-common": "^1.0.2",
     "@backstage/plugin-permission-common": "^0.6.1",
     "@backstage/plugin-search-common": "^0.3.4",
-    "@backstage/plugin-techdocs-node": "^1.1.1",
+    "@backstage/plugin-techdocs-node": "^1.1.2-next.0",
     "@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.24",
-    "@backstage/cli": "^0.17.1",
-    "@backstage/plugin-search-backend-node": "0.6.1",
+    "@backstage/backend-test-utils": "^0.1.25-next.0",
+    "@backstage/cli": "^0.17.2-next.0",
+    "@backstage/plugin-search-backend-node": "0.6.2-next.0",
     "@types/dockerode": "^3.3.0",
     "msw": "^0.35.0",
     "supertest": "^6.1.3"