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/usage/configuration-options.md
+39-39Lines changed: 39 additions & 39 deletions
Original file line number
Diff line number
Diff line change
@@ -1493,45 +1493,6 @@ If you are running on any platform except `github.com`, you need to [configure a
1493
1493
We're planning improvements so that Renovate can show more changelogs.
1494
1494
Read [issue 14138 on GitHub](https://github.com/renovatebot/renovate/issues/14138) to get an overview of the planned work.
1495
1495
1496
-
## managerFilePatterns
1497
-
1498
-
`managerFilePatterns`were formerly known as `fileMatch`, and regex-only.
1499
-
`managerFilePatterns`instead supports regex or glob patterns, and any existing config containing `fileMatch` patterns will be automatically migrated.
1500
-
Do not use the below guide for `fileMatch` if you are using an older version of Renovate.
1501
-
1502
-
`managerFilePatterns`tells Renovate which repository files to parse and extract.
1503
-
`managerFilePatterns`patterns in the user config are _added_ to the default values, they do not replace the default values.
1504
-
1505
-
The default `managerFilePatterns` patterns can not be removed.
1506
-
If you need to include, or exclude, specific paths then use the `ignorePaths` or `includePaths` configuration options.
1507
-
1508
-
Some `managerFilePatterns` patterns are short, like Renovate's default Go Modules `managerFilePatterns` for example.
1509
-
Here Renovate looks for _any_ `go.mod` file.
1510
-
In this case you can probably keep using that default `managerFilePatterns`.
1511
-
1512
-
At other times, the possible files is too vague for Renovate to have any default.
1513
-
For example, Kubernetes manifests can exist in any `*.yaml` file.
1514
-
We do not want Renovate to parse every YAML file in every repository, just in case _some_ of them have a Kubernetes manifest.
1515
-
Therefore Renovate's default `managerFilePatterns` for the `kubernetes` manager is an empty array (`[]`).
1516
-
Because the array is empty, you as user must tell Renovate which directories/files to check.
1517
-
1518
-
Finally, there are cases where Renovate's default `managerFilePatterns` is good, but you may be using file patterns that a bot couldn't possibly guess about.
1519
-
For example, Renovate's default `managerFilePatterns` for `Dockerfile` is `['/(^|/|\\.)([Dd]ocker|[Cc]ontainer)file$/', '/(^|/)([Dd]ocker|[Cc]ontainer)file[^/]*$/']`.
1520
-
This will catch files like `backend/Dockerfile`, `prefix.Dockerfile` or `Dockerfile-suffix`, but it will miss files like `ACTUALLY_A_DOCKERFILE.template`.
1521
-
Because `managerFilePatterns` is "mergeable", you can add the missing file to the `filePattern` like this:
You must configure `managerFilePatterns` _inside_ a manager object.
1532
-
In the example above, the manager object is the `dockerfile`.
1533
-
For reference, here is a [list of supported managers](modules/manager/index.md#supported-managers).
1534
-
1535
1496
## filterUnavailableUsers
1536
1497
1537
1498
When this option is enabled PRs are not assigned to users that are unavailable.
@@ -2414,6 +2375,45 @@ Be careful with remapping `warn` or `error` messages to lower log levels, as it
2414
2375
2415
2376
Add to this object if you wish to define rules that apply only to major updates.
2416
2377
2378
+
## managerFilePatterns
2379
+
2380
+
`managerFilePatterns` were formerly known as `fileMatch`, and regex-only.
2381
+
`managerFilePatterns` instead supports regex or glob patterns, and any existing config containing `fileMatch` patterns will be automatically migrated.
2382
+
Do not use the below guide for `fileMatch` if you are using an older version of Renovate.
2383
+
2384
+
`managerFilePatterns` tells Renovate which repository files to parse and extract.
2385
+
`managerFilePatterns` patterns in the user config are _added_ to the default values, they do not replace the default values.
2386
+
2387
+
The default `managerFilePatterns` patterns can not be removed.
2388
+
If you need to include, or exclude, specific paths then use the `ignorePaths` or `includePaths` configuration options.
2389
+
2390
+
Some `managerFilePatterns` patterns are short, like Renovate's default Go Modules `managerFilePatterns` for example.
2391
+
Here Renovate looks for _any_`go.mod` file.
2392
+
In this case you can probably keep using that default `managerFilePatterns`.
2393
+
2394
+
At other times, the possible files is too vague for Renovate to have any default.
2395
+
For example, Kubernetes manifests can exist in any `*.yaml` file.
2396
+
We do not want Renovate to parse every YAML file in every repository, just in case _some_ of them have a Kubernetes manifest.
2397
+
Therefore Renovate's default `managerFilePatterns` for the `kubernetes` manager is an empty array (`[]`).
2398
+
Because the array is empty, you as user must tell Renovate which directories/files to check.
2399
+
2400
+
Finally, there are cases where Renovate's default `managerFilePatterns` is good, but you may be using file patterns that a bot couldn't possibly guess about.
2401
+
For example, Renovate's default `managerFilePatterns` for `Dockerfile` is `['/(^|/|\\.)([Dd]ocker|[Cc]ontainer)file$/', '/(^|/)([Dd]ocker|[Cc]ontainer)file[^/]*$/']`.
2402
+
This will catch files like `backend/Dockerfile`, `prefix.Dockerfile` or `Dockerfile-suffix`, but it will miss files like `ACTUALLY_A_DOCKERFILE.template`.
2403
+
Because `managerFilePatterns` is "mergeable", you can add the missing file to the `filePattern` like this:
You must configure `managerFilePatterns`_inside_ a manager object.
2414
+
In the example above, the manager object is the `dockerfile`.
2415
+
For reference, here is a [list of supported managers](modules/manager/index.md#supported-managers).
2416
+
2417
2417
## milestone
2418
2418
2419
2419
If set to the number of an existing [GitHub milestone](https://docs.github.com/en/issues/using-labels-and-milestones-to-track-work/about-milestones), Renovate will add that milestone to its PR.
0 commit comments