Skip to content

Document current Portal capacity verification - #102

Merged
perNyfelt merged 4 commits into
mainfrom
document-portal-capacity-check
Nov 17, 2026
Merged

perNyfelt merged 4 commits into
mainfrom
document-portal-capacity-check

Conversation

@perNyfelt

@perNyfelt perNyfelt commented Nov 16, 2026 •

Copy link
Copy Markdown
Member

The release guidance still described a universal ten-deployment quota. Current Sonatype documentation instead directs publishers to organization-specific monthly size, file-count and release-count limits in the Usage Center.

Add a dated capacity procedure with official sources, the non-secret account information to retain, and an exact local command that records the signed bundle digest, ZIP bytes, entry count and contained-file bytes. Link it from the runbook and readiness checklist, and correct the stale quota statement in AGENTS.md. Distinguish local inventory from Portal accounting; the gate remains open pending account data and the actual signed candidate. Native license findings also remain open.

Validation: executed the documented command against a synthetic compressed ZIP and checked its digest, size, count and byte totals; checked local Markdown links and git diff whitespace. Documentation-only change; no candidate build, signing or upload performed.

Review round 1 (2026-11-17, commit 51ab165)

  • File count (high). Signatures and checksums count toward the Portal file count per the
    publishing-limits FAQ, and the pinned nexus-release-plugin 2.6.0 generates them (BundleTask
    MD5/SHA-1, BundleValidator .asc/.md5/.sha1 checks; the 8.1 record shows the .module with
    signature and checksums). The sidecars are no longer described as optional: the estimate is
    now at least 180 files (about 270 if the .asc files carry checksums, as the upload page's
    example tree shows), and the operator is pointed at the measurement for the exact figure.
  • Digest assertion (medium). The script takes the preliminary record as an argument and
    asserts the bundle SHA-256 matches it before anything is measured; a stale or rebuilt
    bundle now fails with a clear message instead of producing a passing report.
  • Historical date (low). The checklist heading keeps (2026-11-14); the capacity-procedure
    reference is a dated Addendum (2026-11-16), per the no-retroactive-rewrite convention.
  • Working directory (low). The procedure now says "from the repository root of the
    candidate checkout".
  • Grace period (low). Added the limits page's 30-day grace period and its
    "after 2 consecutive months of being below limits" reset rule, so a banner is read with
    its snapshot.
  • CRC nit. The script runs testzip() before trusting the ZIP directory sizes; the
    prose notes that zipEntryBytes comes from the directory, verified by the runbook's
    bundle validation plus this check.

Re-validated the embedded script against a synthetic bundle: happy path (exit 0, correct
digest/count/bytes), stale record (exit 1 before writing the measurement), corrupted stored
entry CRC (exit 1, clear message), and wrong working directory (FileNotFoundError, as the
now-explicit repository-root requirement implies).

Review round 2 (2026-11-17, commit 9600577)

  • File count now 270, with local evidence. The 8.1 combined bundle (nexus-release-plugin
    2.5.1; coordinates on Central, composition recorded in req/phase8-1-release-notes.md) was
    re-inspected: exactly 90 files for three coordinates — 30 .md5, 30 .sha1, 15 .asc, 9 .jar,
    3 .module, 3 .pom — i.e. 30 per coordinate, with .asc files carrying checksums as well.
    The estimate is now "expect 270 files for the nine-module tuple; confirm the exact figure
    from the 2.6.0 measurement."
  • Quoted placeholder. The RECORD assignment is single-quoted. Note: the unquoted
    variable form does not actually fix the paste — tested in bash, zsh and sh, the
    redirection still fires (bash/sh truncate the value to preliminary-, zsh empties it).
    The quoted form preserves the literal placeholder in all three shells; pasted as-is it now
    fails with a clear FileNotFoundError naming the exact path the operator must set.
    Re-verified the full as-pasted block end-to-end (syntax check, happy path with a literal
    placeholder file, and the missing-file case).
  • Revision line. Header now reads "Revised 2026-11-17 (review rounds 1 and 2)." so the
    11-16 review date no longer covers the later evidence additions.

…endum

- File count: signatures and checksums count toward the Portal file count per
  the publishing-limits FAQ; the pinned plugin's .asc/.md5/.sha1 sidecars are
  not optional. Expect at least 180 files (about 270 if the .asc files carry
  checksums) for the nine-module tuple; the exact figure comes from the
  measurement, not the estimate
- The embedded script takes the preliminary record as an argument and asserts
  the bundle SHA-256 matches it before measuring, so a stale or rebuilt
  bundle fails before any evidence is written
- testzip() verifies the archive's recorded CRCs before the directory sizes
  are trusted
- The checklist keeps the historical 2026-11-14 research date; the 2026-11-16
  capacity-procedure reference is a dated addendum, not a rewritten heading
- State the grace-period rule (30 days, resets after 2 consecutive months
  below limits) so a banner can be read with its snapshot
- Name the repository root of the candidate checkout as the script's working
  directory

Verified: re-ran the embedded script against a synthetic bundle - happy path,
stale record, CRC corruption and wrong-cwd cases all behave as documented.
…, revision line

- File count: the 8.1 combined bundle (nexus-release-plugin 2.5.1) carries
  exactly 30 files per coordinate - five artifacts and five signatures, each
  with .md5 and .sha1, including checksums of the .asc files themselves - so
  the nine-module tuple is expected at 270 files; the exact figure is
  confirmed from the 2.6.0 measurement (verified against the local 8.1
  bundle inventory before stating it)
- Quote the RECORD placeholder assignment: the unquoted form is parsed as a
  redirection in bash and sh (value truncated to 'preliminary-') and in zsh
  (value emptied) before the script runs; the quoted form preserves the
  literal placeholder in all three shells, and pasting it as-is now fails
  with a clear FileNotFoundError naming the path to set
- Add the 'Revised 2026-11-17 (review rounds 1 and 2).' header line
@perNyfelt
perNyfelt merged commit 2891b1d into main Nov 17, 2026
3 checks passed
@perNyfelt
perNyfelt deleted the document-portal-capacity-check branch November 17, 2026 20:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant