refactor(oci): remove the shell entry point nothing runs

`oci/proxmenux-oci.sh` was installed on every Proxmox host and used on
none of them. The menu entry goes straight to the orchestrator:
scripts/oci/oci_manager_apps.sh runs `python3 -m proxmenux_oci` with
PYTHONPATH pointing at the engine.

Its only remaining caller was a message telling the reader to open it on
the Proxmox host — which is not how anyone gets in, and is what sent one
there to run it. That message now names the menu entry.

It could not be fetched and run either: it needs requirements.txt and
src/ beside it, so `wget | bash` resolved its own directory to the
working directory and failed on a path nobody chose. Making that work
would mean writing a second installer next to the one that already
ships the engine.

What it did offer was a virtualenv for a contributor generating the
catalog. The README now gives the direct invocation and names the two
distribution packages it needs.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
MacRimi
2026-09-22 23:22:51 +02:00
co-authored by Claude Opus 5
parent 3bda7851a1
commit f3bda28338
11 changed files with 12 additions and 79 deletions
+10 -12
View File
@@ -58,26 +58,24 @@ compatible merely because conversion succeeded.
## Catalog maintenance
The catalog is generated rather than written by hand. `proxmenux-oci.sh` is the
tool that produces and inspects it, and it is what a contributor adding an
application runs:
The catalog is generated rather than written by hand. A contributor adding an
application runs the orchestrator directly from this directory:
```bash
./proxmenux-oci.sh sync
./proxmenux-oci.sh list --filter sonarr
./proxmenux-oci.sh generate sonarr
./proxmenux-oci.sh show sonarr
GITHUB_TOKEN=github_pat_xxx ./proxmenux-oci.sh generate-all
export PYTHONPATH=src
python3 -m proxmenux_oci sync
python3 -m proxmenux_oci list --filter sonarr
python3 -m proxmenux_oci generate sonarr
python3 -m proxmenux_oci show sonarr
GITHUB_TOKEN=github_pat_xxx python3 -m proxmenux_oci generate-all
```
`generate` writes one application's template from its published recipe; `show`
prints what the installation would create, which is the fastest way to see
whether a translation came out right before installing anything.
On Debian and Proxmox the launcher reuses the distribution packages
`python3-yaml` and `python3-jsonschema` when they are present, so nothing is
installed into the system Python. Where they are absent, install them with APT
before generating the catalog.
It needs `python3-yaml` and `python3-jsonschema`. On Debian and Proxmox both
are distribution packages; install them with APT before generating the catalog.
`GITHUB_TOKEN` is optional and only raises the public API rate limit, which the
full `generate-all` pass reaches. Never commit a token; `.env` files are