File tree Expand file tree Collapse file tree 3 files changed +12
-8
lines changed Expand file tree Collapse file tree 3 files changed +12
-8
lines changed Original file line number Diff line number Diff line change 2
2
$schema : https://json-schema.org/draft/2020-12/schema
3
3
$id : <HOST>/<PREFIX>/<VERSION>/extension/manifest.discover.yaml
4
4
5
- title : Get Method
5
+ title : Discover operation command
6
6
description : >-
7
7
Defines how DSC must call the DSC extension to discover the paths to resource manifests.
8
8
markdownDescription : | # VS Code only
@@ -18,8 +18,7 @@ markdownDescription: | # VS Code only
18
18
manifests instead.
19
19
20
20
If initial discovery finds any extension manifests that have the `discover` capability, DSC uses
21
- those extensions to recursively discover resources that aren't available in `PATH` or
22
- `DSC_RESOURCE_PATH`.
21
+ those extensions to discover resources that aren't available in `PATH` or `DSC_RESOURCE_PATH`.
23
22
24
23
For more information about the output DSC expects the extension to emit for this command, see
25
24
[Discover extension operation stdout][01].
Original file line number Diff line number Diff line change 2
2
$schema : https://json-schema.org/draft/2020-12/schema
3
3
$id : <HOST>/<PREFIX>/<VERSION>/extension/manifest.yaml
4
4
5
- title : DSC resource manifest
5
+ title : DSC extension manifest
6
6
description : >-
7
7
Defines the information DSC requires to process and surface a DSC extension.
8
8
markdownDescription : | # VS Code only
Original file line number Diff line number Diff line change @@ -10,11 +10,16 @@ markdownDescription: | # VS Code only
10
10
[_Online Documentation_][00]
11
11
***
12
12
13
- Represents the full path a DSC resource manifest. DSC expects every JSON Line
14
- emitted to stdout for the **Discover** operation to adhere to this schema. An extension indicates
15
- that it supports the **Discover** operation by defining the [discover][01] field in its manifest.
13
+ Represents the full path a DSC resource manifest. DSC expects every JSON Line emitted to stdout
14
+ for the **Discover** operation to adhere to this schema. An extension indicates that it supports
15
+ the **Discover** operation by defining the [discover][01] field in its manifest.
16
16
17
- The output must be a JSON object.
17
+ The output must be a JSON object that defines the `manifestPath` property.
18
+
19
+ If the extension doesn't discover any resources, it shouldn't emit any data to stdout.
20
+
21
+ Unless the extension raises an error, it should exit with code `0`, even when no resources are
22
+ discovered.
18
23
19
24
[00]: <DOCS_BASE_URL>/reference/schemas/extension/stdout/discover?<DOCS_VERSION_PIN>
20
25
[01]: <DOCS_BASE_URL>/reference/schemas/extension/manifest/discover?<DOCS_VERSION_PIN>
You can’t perform that action at this time.
0 commit comments