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
update libraries.cgr.dev/java browsing docs following r2 migration (#3450)
## What
Updates the **Java overview** doc to accurately describe how to access
the Chainguard Libraries for Java repository at
`https://libraries.cgr.dev/java/`.
- The repository root is not browsable. The doc now leads with how to
access artifacts directly by their Maven-format path.
- **Find available versions** via the library's `maven-metadata.xml`
file.
- **List the files for a version** at that version's directory (the
version-leaf directory is browsable).
- Download individual files by full path (with `-L` to follow redirects
to object storage).
## Why
Following the R2 migration, the repository no longer renders directory
listings above the version level, so the previous docs (which described
general Maven-style directory browsing and pointed readers at the
`groupId`/`artifactId` directory to find versions) were inaccurate. This
caused customer confusion (see [internal
thread](https://chainguard-dev.slack.com/archives/C085187D8RE/p1782165183164049)).
The doc now reflects the supported access pattern.
## Also
- Refreshed example versions to artifacts that actually exist in the
repository: `commons-lang3` 3.18.0 → **3.13.0**, `commons-io` 2.17.0 →
**2.13.0**, `commons-compress` 1.28.0 → **1.23.0** (the prior versions
404'd).
- Fixed a missing backtick in the SBOM file-extension list.
## Testing
Verified against `libraries.cgr.dev/java` with an entitlement token:
- `…/commons-lang3/maven-metadata.xml` → 200
- `…/commons-lang3/3.13.0/` → 200 (browsable file listing)
- `…/commons-io/commons-io/2.13.0/commons-io-2.13.0.pom` → 200 (via
`-L`)
- `…/commons-compress/1.23.0/` and its `.pom` / `.jar` /
`.slsa-attestation.json` / `.spdx.json` → 200
- Repository root and intermediate directories → 404 (consistent with
the doc)
## Scope
`content/chainguard/libraries/java/overview.md` only.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
Copy file name to clipboardExpand all lines: content/chainguard/libraries/java/overview.md
+46-35Lines changed: 46 additions & 35 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -70,7 +70,7 @@ The URL for the repository is:
70
70
https://libraries.cgr.dev/java/
71
71
```
72
72
73
-
This site provides a directory browsing and file listing capability similar to the Maven Central repository, allowing you to find available libraries, library versions, and available files. Learn more under [Manual access](#manual).
73
+
The repository root at `https://libraries.cgr.dev/java/` is not browsable, but you can access artifacts directly by their [Maven repository format](https://maven.apache.org/repository/layout.html) path: list the available versions of a library through its `maven-metadata.xml` file, view the files for a specific version in that version's directory, and download individual files by their full path. Learn more under [Manual access](#manual).
74
74
75
75
This Chainguard Libraries for Java repository uses the Maven repository format
76
76
and only includes release artifacts of the libraries built by Chainguard from
@@ -133,40 +133,51 @@ To manually access artifacts in the Chainguard Libraries for Java repository, us
133
133
with your [username and password retrieved with
134
134
chainctl](/chainguard/libraries/access/).
135
135
136
-
This site provides a directory browsing and file listing capability similar to
137
-
the Maven Central repository at
138
-
[`https://repo1.maven.org/maven2/`](https://repo1.maven.org/maven2/). The
139
-
structure follows the [Maven repository
140
-
format](https://maven.apache.org/repository/layout.html). The `groupId` and
141
-
`artifactId` of a library is used to create a nested directory structure,
142
-
similar to the package structure within Java projects.
136
+
The repository follows the [Maven repository
137
+
format](https://maven.apache.org/repository/layout.html), where the `groupId` and
138
+
`artifactId` of a library form a nested directory structure, similar to the
139
+
package structure within Java projects. The repository root at
140
+
[`https://libraries.cgr.dev/java/`](https://libraries.cgr.dev/java/) is not
141
+
browsable, but you can discover and retrieve artifacts directly as described
142
+
below.
143
143
144
144
For example, the Maven coordinates for [Apache Commons
145
-
Lang](https://commons.apache.org/proper/commons-lang/)3.18.0 are the following:
145
+
Lang](https://commons.apache.org/proper/commons-lang/) are the following:
0 commit comments