You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/environment-variables.md
+54-17Lines changed: 54 additions & 17 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,39 +4,76 @@ Environment variables are sometimes used to control experimental features or adv
4
4
5
5
## `DisableGoCliScan`
6
6
7
-
If the environment variable `DisableGoCliScan` is set to "true", we fall back to parsing `go.mod` and `go.sum` ourselves.
7
+
If the environment variable `DisableGoCliScan` is set to "true", we fall back to parsing `go.mod` and `go.sum` ourselves.
8
8
Otherwise, the Go detector uses go-cli command: `go list -m all` to discover Go dependencies.
9
9
10
+
## `DisableRustCliScan`
11
+
12
+
When set to "true", the Rust detector skips all Cargo CLI execution, including metadata queries.
13
+
In SBOM mode, dependencies will be mapped directly to `*.cargo-sbom.json` files.
14
+
In fallback mode, the detector processes `Cargo.lock` and `Cargo.toml` files to infer dependencies and relationships.
15
+
Disabling the CLI may reduce the precision of component-to-location mapping and can lead to over-reporting.
16
+
10
17
## `PyPiMaxCacheEntries`
11
18
12
19
The environment variable `PyPiMaxCacheEntries` is used to control the size of the in-memory LRU cache that caches responses from PyPi.
13
20
The default value is 4096.
14
21
22
+
## `PIP_INDEX_URL`
23
+
24
+
Determines what package feed should be used for `pip install --report` detection.
25
+
The default value will use the PyPi index unless pip defaults have been configured globally.
26
+
27
+
## `PipReportOverrideBehavior`
28
+
29
+
Overrides pip report with one of the following detection strategies:
30
+
-`Skip`: Will not run pip detection
31
+
-`SourceCodeScan`: Scan `setup.py` and `requirements.txt` files, and record components explicitly from the package files without hitting a remote feed. Does not compile a dependency graph.
32
+
33
+
## `PipReportSkipFallbackOnFailure`
34
+
35
+
When set to "true", skips the default fallback behavior if pip report fails.
36
+
Default behavior scans `setup.py` and `requirements.txt` files, and records components explicitly from the package files without hitting a remote feed.
37
+
Does not compile a dependency graph.
38
+
39
+
## `PipReportFileLevelTimeoutSeconds`
40
+
41
+
Controls the timeout limit (in seconds) for generating the PipReport for individual files.
42
+
This defaults to the overall timeout.
43
+
44
+
## `PipReportDisableFastDeps`
45
+
46
+
When set to "true", disables the fast deps feature in PipReport.
47
+
48
+
## `PipReportIgnoreFileLevelIndexUrl`
49
+
50
+
When set to "true", ignores the `--index-url` argument that can be provided in the requirements.txt file.
51
+
See [pip install documentation](https://pip.pypa.io/en/stable/cli/pip_install/#install-index-url) for more details.
52
+
53
+
## `PipReportPersistReports`
54
+
55
+
When set to "true", allows the PipReport detector to persist the reports that it generates, rather than cleaning them up after constructing the dependency graph.
56
+
15
57
## `CD_DETECTOR_EXPERIMENTS`
16
58
17
-
When set to any value, enables detector experiments, a feature to compare the results of different detectors for the
18
-
same ecosystem. The available experiments are found in the [`Experiments\Config`](../src/Microsoft.ComponentDetection.Orchestrator/Experiments/Configs)
19
-
folder.
59
+
When set to any value, enables detector experiments, a feature to compare the results of different detectors for the same ecosystem.
60
+
The available experiments are found in the [`Experiments\Config`](../src/Microsoft.ComponentDetection.Orchestrator/Experiments/Configs) folder.
20
61
21
62
## `CD_GRADLE_DEV_LOCKFILES`
22
63
23
-
Enables dev-dependency categorization for the Gradle
24
-
detector. Comma-separated list of Gradle lockfiles which contain only
25
-
development dependencies. Dependencies connected to Gradle
26
-
configurations matching the given regex are considered development
27
-
dependencies. If a lockfile will contain a mix of development and
28
-
production dependencies, see `CD_GRADLE_DEV_CONFIGURATIONS` below.
64
+
Enables dev-dependency categorization for the Gradle detector.
65
+
Comma-separated list of Gradle lockfiles which contain only development dependencies.
66
+
Dependencies connected to Gradle configurations matching the given regex are considered development dependencies.
67
+
If a lockfile will contain a mix of development and production dependencies, see `CD_GRADLE_DEV_CONFIGURATIONS` below.
29
68
30
69
## `CD_GRADLE_DEV_CONFIGURATIONS`
31
70
32
-
Enables dev-dependency categorization for the Gradle
33
-
detector. Comma-separated list of Gradle configurations which refer to development dependencies.
34
-
Dependencies connected to Gradle configurations matching
35
-
the given configurations are considered development dependencies.
71
+
Enables dev-dependency categorization for the Gradle detector.
72
+
Comma-separated list of Gradle configurations which refer to development dependencies.
73
+
Dependencies connected to Gradle configurations matching the given configurations are considered development dependencies.
36
74
If an entire lockfile will contain only dev dependencies, see `CD_GRADLE_DEV_LOCKFILES` above.
37
75
38
-
[1]: https://go.dev/ref/mod#go-mod-graph
39
-
40
76
## `MvnCLIFileLevelTimeoutSeconds`
41
77
42
-
When set to any positive integer value, it controls the max execution time Mvn CLI is allowed to take per each `pom.xml` file. Default behavior is unbounded.
78
+
When set to any positive integer value, it controls the max execution time Mvn CLI is allowed to take per each `pom.xml` file.
0 commit comments