Skip to main content

Module ppa

Module ppa 

Source
Expand description

PPA (Personal Package Archive) management actions (Ubuntu).

Both actions call add-apt-repository from the software-properties-common package. If that package is absent the daemon process will fail with ENOENT; the executor surfaces that as an ExecutionFailure with the binary name in the error message, giving the operator a clear hint.

§PPA name validation

A PPA identifier must follow the <user>/<ppa> format where both components consist of alphanumeric characters, hyphens, underscores, or dots. The validator rejects names containing shell-special characters and names that do not contain exactly one /.

§Rollback availability

rollback_available means the daemon automatically reverts the action on failure (executor::rollback_spec_for returns Some and the dispatcher runs it as part of the same job — see docs/automatic-rollback.md). That mechanism exists only for rpm-ostree deployment actions today, so both AddPpa and RemovePpa are rollback_available = false: apt/PPA state is mutated directly on the live filesystem and the daemon does not stage or auto-revert it. AddPpa and RemovePpa remain each other’s manual inverse — an operator (or agent) can undo one by explicitly running the other — but that is a distinct fact from automatic rollback and is not what this flag communicates.

Functions§

add_ppa
Add a PPA repository (sudo add-apt-repository -y --ppa ppa:<user>/<ppa>).
remove_ppa
Remove a PPA repository (sudo add-apt-repository -y --remove --ppa ppa:<user>/<ppa>).
specs
Return one representative ActionSpec per PPA action name.