fix(packaging): add upgrade migration docs and podman socket retry#1507
Merged
Conversation
maxamillion
requested review from
a team,
derekwaynecarr and
mrunalp
as code owners
maxamillion
force-pushed
the
fix/packaging-follow-ups
branch
from
632bfda to
62eb7e7
Compare
TaylorMutch
previously approved these changes
May 21, 2026
Collaborator
|
/ok to test 62eb7e7 |
maxamillion
force-pushed
the
fix/packaging-follow-ups
branch
from
62eb7e7 to
632bfda
Compare
After NVIDIA#1415 ships, users upgrading from previous releases need guidance on the gateway.env deprecation, port/bind/database path changes, and the podman.socket restart requirement. - docs(rpm): add 'Migrating from gateway.env' section to TROUBLESHOOTING covering backward compatibility, env-to-TOML key mapping, and three breaking changes (default port 8080->17670, bind address 0.0.0.0->127.0.0.1, database path move). Add podman.socket restart step to upgrade procedure. - docs(rpm): add upgrade callout to CONFIGURATION.md pointing at migration section. - fix(podman): retry PodmanComputeDriver ping up to 5 times with 2s delay to tolerate transient socket unavailability after package upgrades. The systemd unit uses Wants=podman.socket (not Requires) so the gateway can start while the socket is briefly re-activating after an RPM upgrade changes its unit file on disk. - chore(rpm): update EnvironmentFile comment in RPM spec to explain backward-compatibility intent. Signed-off-by: Adam Miller <admiller@redhat.com>
maxamillion
force-pushed
the
fix/packaging-follow-ups
branch
from
4409315 to
790adb8
Compare
johntmyers
approved these changes
May 21, 2026
Collaborator
|
/ok to test 790adb8 |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Follow-up to #1415. Adds the upgrade migration guidance that was missing from the original PR, and makes the Podman driver resilient to the transient socket unavailability observed during RPM upgrade testing.
Intended to land after #1415 merges. The branch is based on `use-toml-in-install`.
Related Issue
Follow-up to #1415
Changes
Testing
Checklist