@backstage/plugin-techdocs-backend 0.0.0-nightly-20220524024614 → 0.0.0-nightly-20220525024352
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +74 -3
- package/package.json +7 -7
package/CHANGELOG.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# @backstage/plugin-techdocs-backend
|
|
2
2
|
|
|
3
|
-
## 0.0.0-nightly-
|
|
3
|
+
## 0.0.0-nightly-20220525024352
|
|
4
4
|
|
|
5
5
|
### Patch Changes
|
|
6
6
|
|
|
@@ -66,8 +66,79 @@
|
|
|
66
66
|
```
|
|
67
67
|
|
|
68
68
|
- Updated dependencies
|
|
69
|
-
- @backstage/backend-common@0.0.0-nightly-
|
|
70
|
-
- @backstage/integration@0.0.0-nightly-
|
|
69
|
+
- @backstage/backend-common@0.0.0-nightly-20220525024352
|
|
70
|
+
- @backstage/integration@0.0.0-nightly-20220525024352
|
|
71
|
+
- @backstage/plugin-techdocs-node@0.0.0-nightly-20220525024352
|
|
72
|
+
|
|
73
|
+
## 1.1.2-next.0
|
|
74
|
+
|
|
75
|
+
### Patch Changes
|
|
76
|
+
|
|
77
|
+
- 5d66d4ff67: Output logs from a TechDocs build to a logging transport in addition to existing
|
|
78
|
+
frontend event stream, for capturing these logs to other sources.
|
|
79
|
+
|
|
80
|
+
This allows users to capture debugging information around why tech docs fail to build
|
|
81
|
+
without needing to rely on end users capturing information from their web browser.
|
|
82
|
+
|
|
83
|
+
The most common use case is to log to the same place as the rest of the backend
|
|
84
|
+
application logs.
|
|
85
|
+
|
|
86
|
+
Sample usage:
|
|
87
|
+
|
|
88
|
+
```
|
|
89
|
+
import { DockerContainerRunner } from '@backstage/backend-common';
|
|
90
|
+
import {
|
|
91
|
+
createRouter,
|
|
92
|
+
Generators,
|
|
93
|
+
Preparers,
|
|
94
|
+
Publisher,
|
|
95
|
+
} from '@backstage/plugin-techdocs-backend';
|
|
96
|
+
import Docker from 'dockerode';
|
|
97
|
+
import { Router } from 'express';
|
|
98
|
+
import { PluginEnvironment } from '../types';
|
|
99
|
+
|
|
100
|
+
export default async function createPlugin(
|
|
101
|
+
env: PluginEnvironment,
|
|
102
|
+
): Promise<Router> {
|
|
103
|
+
const preparers = await Preparers.fromConfig(env.config, {
|
|
104
|
+
logger: env.logger,
|
|
105
|
+
reader: env.reader,
|
|
106
|
+
});
|
|
107
|
+
|
|
108
|
+
const dockerClient = new Docker();
|
|
109
|
+
const containerRunner = new DockerContainerRunner({ dockerClient });
|
|
110
|
+
|
|
111
|
+
const generators = await Generators.fromConfig(env.config, {
|
|
112
|
+
logger: env.logger,
|
|
113
|
+
containerRunner,
|
|
114
|
+
});
|
|
115
|
+
|
|
116
|
+
const publisher = await Publisher.fromConfig(env.config, {
|
|
117
|
+
logger: env.logger,
|
|
118
|
+
discovery: env.discovery,
|
|
119
|
+
});
|
|
120
|
+
|
|
121
|
+
await publisher.getReadiness();
|
|
122
|
+
|
|
123
|
+
return await createRouter({
|
|
124
|
+
preparers,
|
|
125
|
+
generators,
|
|
126
|
+
publisher,
|
|
127
|
+
logger: env.logger,
|
|
128
|
+
// Passing a buildLogTransport as a parameter in createRouter will enable
|
|
129
|
+
// capturing build logs to a backend log stream
|
|
130
|
+
buildLogTransport: env.logger,
|
|
131
|
+
config: env.config,
|
|
132
|
+
discovery: env.discovery,
|
|
133
|
+
cache: env.cache,
|
|
134
|
+
});
|
|
135
|
+
}
|
|
136
|
+
```
|
|
137
|
+
|
|
138
|
+
- Updated dependencies
|
|
139
|
+
- @backstage/backend-common@0.13.6-next.0
|
|
140
|
+
- @backstage/integration@1.2.1-next.0
|
|
141
|
+
- @backstage/plugin-techdocs-node@1.1.2-next.0
|
|
71
142
|
|
|
72
143
|
## 1.1.1
|
|
73
144
|
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@backstage/plugin-techdocs-backend",
|
|
3
3
|
"description": "The Backstage backend plugin that renders technical documentation for your components",
|
|
4
|
-
"version": "0.0.0-nightly-
|
|
4
|
+
"version": "0.0.0-nightly-20220525024352",
|
|
5
5
|
"main": "dist/index.cjs.js",
|
|
6
6
|
"types": "dist/index.d.ts",
|
|
7
7
|
"license": "Apache-2.0",
|
|
@@ -34,16 +34,16 @@
|
|
|
34
34
|
"clean": "backstage-cli package clean"
|
|
35
35
|
},
|
|
36
36
|
"dependencies": {
|
|
37
|
-
"@backstage/backend-common": "^0.0.0-nightly-
|
|
37
|
+
"@backstage/backend-common": "^0.0.0-nightly-20220525024352",
|
|
38
38
|
"@backstage/catalog-client": "^1.0.2",
|
|
39
39
|
"@backstage/catalog-model": "^1.0.2",
|
|
40
40
|
"@backstage/config": "^1.0.1",
|
|
41
41
|
"@backstage/errors": "^1.0.0",
|
|
42
|
-
"@backstage/integration": "^0.0.0-nightly-
|
|
42
|
+
"@backstage/integration": "^0.0.0-nightly-20220525024352",
|
|
43
43
|
"@backstage/plugin-catalog-common": "^1.0.2",
|
|
44
44
|
"@backstage/plugin-permission-common": "^0.6.1",
|
|
45
45
|
"@backstage/plugin-search-common": "^0.3.4",
|
|
46
|
-
"@backstage/plugin-techdocs-node": "^
|
|
46
|
+
"@backstage/plugin-techdocs-node": "^0.0.0-nightly-20220525024352",
|
|
47
47
|
"@types/express": "^4.17.6",
|
|
48
48
|
"dockerode": "^3.3.1",
|
|
49
49
|
"express": "^4.17.1",
|
|
@@ -56,9 +56,9 @@
|
|
|
56
56
|
"winston": "^3.2.1"
|
|
57
57
|
},
|
|
58
58
|
"devDependencies": {
|
|
59
|
-
"@backstage/backend-test-utils": "^0.
|
|
60
|
-
"@backstage/cli": "^0.0.0-nightly-
|
|
61
|
-
"@backstage/plugin-search-backend-node": "0.0.0-nightly-
|
|
59
|
+
"@backstage/backend-test-utils": "^0.0.0-nightly-20220525024352",
|
|
60
|
+
"@backstage/cli": "^0.0.0-nightly-20220525024352",
|
|
61
|
+
"@backstage/plugin-search-backend-node": "0.0.0-nightly-20220525024352",
|
|
62
62
|
"@types/dockerode": "^3.3.0",
|
|
63
63
|
"msw": "^0.35.0",
|
|
64
64
|
"supertest": "^6.1.3"
|