Skip to content

Commit cff35f0

Browse files
authored
add documentation about BuildTargetingString to eng_sys_checks.md (Azure#19018)
1 parent 567b1ac commit cff35f0

File tree

1 file changed

+12
-2
lines changed

1 file changed

+12
-2
lines changed

doc/eng_sys_checks.md

Lines changed: 12 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -15,13 +15,23 @@ Example PR build:
1515
- `Analyze` tox envs run during the `Analyze job.
1616
- `Test <platform>_<pyversion>` runs PR/Nightly tox envs, depending on context.
1717

18+
19+
## Targeting a specific package at build time
20+
21+
In both `public` and `internal` projects, all builds allow a filter to be introduced at build time to narrow the set of packages build/tested.
22+
23+
1. Click `Run New` on your target build.
24+
2. Before clicking `run` against `master` or your target commit, click `Variables` and add a variable. Add variable `BuildTargetingString` with value of a valid glob string.
25+
1. For example, setting filter string `azure-mgmt-*` will filter a build to only management packages. A value of `azure-keyvault-secrets` will result in only building THAT specific package.
26+
3. Once it's set, run the build!
27+
1828
## Skipping a tox test environment at queue time
1929

2030
All build definitions allow choice at queue time as to which `tox` environments actually run during the test phase.
2131

2232
1. Find your target service `internal` build.
23-
2. Click `Run New`
24-
3. Before clicking `run` against `master` or your target commit, click `Variables` and add a variable. The value should be a comma separated list of tox environments that you want to run in the test phase.
33+
2. Click `Run New`.
34+
3. Before clicking `run` against `master` or your target commit, click `Variables` and add a variable of name `Run.ToxCustomEnvs`. The value should be a comma separated list of tox environments that you want to run in the test phase.
2535
4. Once it's set, run the build!
2636

2737
This is an example setting of that narrows the default set from `whl, sdist, depends, latestdependency, minimumdependency`.

0 commit comments

Comments
 (0)