Skip to content

Commit 6e5a303

Browse files
authored
Merge pull request #2290 from conda-forge/outputs-no-reg
feat: add announcement of new output registration process
2 parents cdaee68 + 73b1f50 commit 6e5a303

File tree

2 files changed

+30
-13
lines changed

2 files changed

+30
-13
lines changed

docs/maintainer/infrastructure.md

Lines changed: 19 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -635,19 +635,25 @@ works as follows.
635635
channel.
636636

637637
We attempt to report errors in this process to users via comments on commits/issues in the feedstocks.
638-
Note however that sometimes these fail. If you think you are having trouble with uploads, make
639-
sure `conda_forge_output_validation: true` is set in your `conda-forge.yml` and rerender
640-
your feedstock with the latest version of `conda-smithy`. Finally, new packages that are added to
641-
feedstocks are registered automatically and once uploaded successfully, no other feedstock
642-
will be able to upload packages with the same name.
643-
644-
Sometimes, however, it might make better sense to generate a package from a different
645-
feedstock, say, due to package renaming or re-structuring. In this case, you may need
646-
to add the new feedstock to the [feedstock-outputs](https://github.com/conda-forge/feedstock-outputs) map.
647-
If this is not done, then the output validation process will block the package from being
648-
uploaded from the new feedstock, by design.
649-
Once this is done correctly and the package is uploaded,
650-
you can then request the conda-forge core devs to archive the old feedstock.
638+
Sometimes these reports fail. If you think you are having trouble with uploads, make sure to check/try
639+
the following things:
640+
641+
- Ensure that `conda_forge_output_validation: true` is set in your `conda-forge.yml`.
642+
- Retry the package build and upload by pushing an empty commit to the feedstock.
643+
- Rerender the feedstock in a PR from a fork of the feedstock and merge.
644+
- Request a feedstock token reset via our [admin-requests repo](https://github.com/conda-forge/admin-requests?tab=readme-ov-file#reset-your-feedstock-token).
645+
- Request that any new packages be added to the allowed outputs for the feedstock
646+
via our [admin-requests-repo](https://github.com/conda-forge/admin-requests?tab=readme-ov-file#add-a-package-output-to-a-feedstock).
647+
648+
New packages that are added to existing feedstocks are not registered automatically in order to prevent
649+
typo squatting and other malicious activities. Package outputs are added during feedstock creation.
650+
If you move a package from one feedstock to another, add an output, or change the name of package name,
651+
you will need to request that the new package name be added to your feedstock via the
652+
[admin-requests repo](https://github.com/conda-forge/admin-requests?tab=readme-ov-file#add-a-package-output-to-a-feedstock).
653+
654+
In rare cases, the package name may change regularly in a well-defined way (e.g., `libllvm18`, `libllvm19`, etc.).
655+
In this case, please submit a PR updating our [list of feedstocks with allowed glob patterns](https://github.com/conda-forge/admin-requests/blob/main/.feedstock_outputs_autoreg_allowlist.yml). Output packages that match
656+
these patterns will be automatically registered for your feedstock.
651657

652658
## Stages of package building and involved infrastructure
653659

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
# Changes Feedstock Output Validation Procedure
2+
3+
We have changed our feedstock output validation procedure. Instead of automatically
4+
adding new packages to existing feedstocks (e.g., when a new output is added), we will now
5+
require that maintainers submit a PR to add the new output via our
6+
[admin-requests repository](https://github.com/conda-forge/admin-requests?tab=readme-ov-file#add-a-package-output-to-a-feedstock).
7+
New feedstocks created via `staged-recipes` will have their outputs added automatically. If you maintain a feedstock
8+
that regularly adds new outputs (e.g., `llvmdev` has `libllvm18`, `libllvm19`, etc.), we have created a
9+
[list of feedstocks with allowed glob patterns](https://github.com/conda-forge/admin-requests/blob/main/.feedstock_outputs_autoreg_allowlist.yml). These feedstocks will have any outputs matching their glob patterns
10+
added automatically. If you would like to add your feedstock to this list, please submit a PR. Further
11+
details on package output validation cna be found in our [documentation](https://conda-forge.org/docs/maintainer/infrastructure/#output-validation-and-feedstock-tokens).

0 commit comments

Comments
 (0)