Skip to content

Clarify configuration when using podman machine#2402

Merged
openshift-merge-bot[bot] merged 1 commit into
containers:mainfrom
chrw:update_containersconf_doc
Apr 22, 2025
Merged

Clarify configuration when using podman machine#2402
openshift-merge-bot[bot] merged 1 commit into
containers:mainfrom
chrw:update_containersconf_doc

Conversation

@chrw

@chrw chrw commented Apr 2, 2025

Copy link
Copy Markdown
Contributor

Fixes: podman-container-tools/podman#25763

Avoid confusion with the network configuration using podman machine.

Comment thread docs/containers.conf.5.md Outdated
Comment on lines +408 to +410
Note: If Podman is running in a virtual machine using `podman machine` (this
includes Mac and Windows hosts), ensure that you add the configuration in the
virtual machine by using `podman machine ssh`.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Note this does not only effect network settings, almost all option from this file must be set server side (in the machine). Notable exceptions are [machine], [farms], [engine.service_destinations], compose_providers, compose_warning_logs, and the remote option and likely more we don't even know about.

So I think this should likely be reworded and put as part of the main description. (Overall we as a team are currently trying to figure out how this whole situation can be improved)

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not sure how to rephrase this to ensure that the information isn't overlooked. My thought was that including such a note directly within the configuration type would make sense.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

How should we move forward with this change?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is there any update on this topic? What is preventing us from moving forward with merging this change?

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't have a good answer, IMO putting it just under network might also be confusing for others because it affects most options.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I attempted to relocate the information to a different location within the documentation. What are your thoughts on this approach?

@chrw chrw changed the title Clarify network configuration when using podman machine Clarify configuration when using podman machine Apr 14, 2025
Comment thread docs/containers.conf.5.md Outdated
Comment thread docs/containers.conf.5.md Outdated
* `policy.conf` for controlling which images can be pulled to the system.

Note: If Podman is running in a virtual machine using `podman machine` (this
includes Mac and Windows hosts), ensure that you edit the configuration files in the

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nit: avoid using "you" in man pages. In this case the you brings no value.
ensure that the configuration files are edited in the

@chrw chrw requested review from Luap99 and baude April 15, 2025 06:20
@Luap99

Luap99 commented Apr 22, 2025

Copy link
Copy Markdown
Member

Thanks, can you please squash your commits into one.

Signed-off-by: Christian Wolff <christian.wolff@breuninger.de>

@Luap99 Luap99 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@Luap99

Luap99 commented Apr 22, 2025

Copy link
Copy Markdown
Member

@baude @rhatdan PTAL again

@baude

baude commented Apr 22, 2025

Copy link
Copy Markdown
Member

LGTM as well.

@rhatdan

rhatdan commented Apr 22, 2025

Copy link
Copy Markdown
Member

/lgtm

@baude baude left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

/lgtm

@openshift-ci

openshift-ci Bot commented Apr 22, 2025

Copy link
Copy Markdown
Contributor

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: baude, chrw, Luap99

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@openshift-merge-bot openshift-merge-bot Bot merged commit ffbac5e into containers:main Apr 22, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Podman ignores default_network settings on macOS

4 participants