Tell upaas operators to set the cache size limit (closes #251) #270

Open
clawbot wants to merge 1 commits from issue-251-upaas-cache-limit into next
Collaborator

"Running under upaas" in README.md listed PIXA_CACHE_MAX_BYTES as optional. Under upaas the volume is a directory on the host's filesystem. The default limit is 75% of the sum of that filesystem's free space and what the cache holds, and at least 500 MiB, so one pixa can grow its cache to three quarters or more of the space the host and every other app have left, and to all of it when that is 500 MiB or less. The section now tells the operator to set the variable and says what the default does there.

The default is unchanged, as the plan on #251 decided. The Deployment section already says to set cache_max_bytes for a lasting deployment and is left as it was.

  • No test: the change is to documentation only, so no test could fail before it and pass after it.

Model: opus-5-5

"Running under upaas" in `README.md` listed `PIXA_CACHE_MAX_BYTES` as optional. Under upaas the volume is a directory on the host's filesystem. The default limit is 75% of the sum of that filesystem's free space and what the cache holds, and at least 500 MiB, so one pixa can grow its cache to three quarters or more of the space the host and every other app have left, and to all of it when that is 500 MiB or less. The section now tells the operator to set the variable and says what the default does there. The default is unchanged, as the plan on https://git.eeqj.de/sneak/pixa/issues/251 decided. The Deployment section already says to set `cache_max_bytes` for a lasting deployment and is left as it was. - No test: the change is to documentation only, so no test could fail before it and pass after it. Model: opus-5-5
clawbot added the needs-review label 2026-10-15 08:08:23 +02:00
clawbot self-assigned this 2026-10-15 08:08:23 +02:00
Author
Collaborator

Review failed: needs-rework.

  1. README.md lines 126-130 ("Running under upaas", PIXA_CACHE_MAX_BYTES): the default is given as 75% of the free space plus what the cache holds, with the claim that it lets the cache grow to three quarters of the space left. The default is never below 500 MiB (the Configuration section says so), so on a shared filesystem with less than about 667 MiB free and cached together the cache can take all of the space left, which is the case this warning is for. The TODO.md entry (lines 33-38), the PR body and the commit message say the same, and their wording "75% of that filesystem's free space plus what the cache holds" also reads as 75% of the free space with the cache's bytes added on top. Acceptable: state the default as the Configuration section does (75% of the sum of the free space and what the cache holds, at least 500 MiB) and make the "three quarters" claim hold when the minimum applies, in all four places.

Model: opus-5-5

Review failed: `needs-rework`. 1. `README.md` lines 126-130 ("Running under upaas", `PIXA_CACHE_MAX_BYTES`): the default is given as 75% of the free space plus what the cache holds, with the claim that it lets the cache grow to three quarters of the space left. The default is never below 500 MiB (the Configuration section says so), so on a shared filesystem with less than about 667 MiB free and cached together the cache can take all of the space left, which is the case this warning is for. The `TODO.md` entry (lines 33-38), the PR body and the commit message say the same, and their wording "75% of that filesystem's free space plus what the cache holds" also reads as 75% of the free space with the cache's bytes added on top. Acceptable: state the default as the Configuration section does (75% of the sum of the free space and what the cache holds, at least 500 MiB) and make the "three quarters" claim hold when the minimum applies, in all four places. Model: opus-5-5
clawbot added needs-rework and removed needs-review labels 2026-10-15 09:43:57 +02:00
clawbot added 1 commit 2026-10-15 10:10:44 +02:00
"Running under upaas" listed PIXA_CACHE_MAX_BYTES as optional. Under
upaas the volume is a directory on the host's filesystem. The default,
75% of the sum of that filesystem's free space and what the cache
holds, and at least 500 MiB, lets one pixa take three quarters or more
of the space the host and every other app have left, and all of it
when that is 500 MiB or less. The section now says to set it and why.
The default is unchanged.

Model: opus-5-5
clawbot force-pushed issue-251-upaas-cache-limit from 8f5abb0b3e to 4350b1657c 2026-10-15 10:10:44 +02:00 Compare
clawbot added needs-review and removed needs-rework labels 2026-10-15 10:38:04 +02:00
Author
Collaborator
  1. Fixed: README, TODO.md, PR body and commit message now give the default as 75% of the sum of the free space and what the cache holds, and at least 500 MiB, and say the cache can take three quarters or more of the space left, and all of it when that is 500 MiB or less.

Model: opus-5-5

1. Fixed: README, `TODO.md`, PR body and commit message now give the default as 75% of the sum of the free space and what the cache holds, and at least 500 MiB, and say the cache can take three quarters or more of the space left, and all of it when that is 500 MiB or less. Model: opus-5-5
Some checks are pending
check / check (push) Waiting to run
You are not authorized to merge this pull request.
This pull request can be merged automatically.
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u origin issue-251-upaas-cache-limit:issue-251-upaas-cache-limit
git checkout issue-251-upaas-cache-limit
Sign in to join this conversation.
No Reviewers
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: sneak/pixa#270