Skip to content

Commit b867b4e

Browse files
zklausjaimergp
andcommitted
Apply review suggestions
Co-authored-by: jaimergp <[email protected]>
1 parent a45cb33 commit b867b4e

File tree

1 file changed

+5
-3
lines changed

1 file changed

+5
-3
lines changed

docs/maintainer/infrastructure.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -598,24 +598,26 @@ However, in some cases, maintainers might need to perform some actions on the pu
598598

599599
The metadata for `conda` packages is initially contained in each package archive (under `info/`).
600600
`conda index` iterates over the published `conda` packages, extracts the metadata and consolidates all the found JSON blobs into a single JSON file: `repodata.json`.
601+
This is where the hashes and file sizes are added too.
601602
This is the metadata file that the CLI clients download initially to _solve_ the environment.
602603

603604
Since the metadata is external to the package files, some details can be modified without rebuilding packages, which simplifies some maintenance tasks notably.
604605

605606
Repodata patches are created in `conda-forge/conda-forge-repodata-patches-feedstock`, which generates (and uploads) a regular `conda` package as a result:
606607
[`conda-forge-repodata-patches`](https://anaconda.org/conda-forge/conda-forge-repodata-patches/files).
607608
Each of these timestamped packages contains the patch instructions for each channel subdir on conda-forge.
608-
The Anaconda infrastructure takes the JSON files from these packages and applies them on top of the vanilla `repodata.json`.
609+
The Anaconda infrastructure takes the JSON files from these packages and applies them on top of the vanilla `repodata.json` (which remains available for download as `repodata_from_packages.json`).
609610

610-
Since this operates as a regular feedstock for package publication,
611-
there are no further infrastructural details to cover.
611+
Since `conda-forge-repodata-patches-feedstock` operates as a regular feedstock for package publication, there are no further infrastructural details to cover.
612612

613613
#### Mark a package as broken
614614

615615
Sometimes a package is faulty in ways that a repodata patch cannot amend (e.g. bad binary).
616616
In these cases, conda-forge does not remove packages from Anaconda.org.
617617
Instead, it marks them with the `broken` label, which has a special meaning:
618618
packages labeled as such will be removed from the repodata via automated patches.
619+
This action is reversible and doesn't change the direct URL of the artifact, which
620+
can always be downloaded from e.g. a lockfile.
619621

620622
The main repository handling this is `conda-forge/admin-requests`, which features different
621623
Github Actions workflows running every 15 minutes.

0 commit comments

Comments
 (0)