Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Docs: Note groups default behavior in user module #76096

Merged
merged 1 commit into from Oct 29, 2021
Merged

Docs: Note groups default behavior in user module #76096

merged 1 commit into from Oct 29, 2021

Conversation

ariordan-redhat
Copy link
Contributor

@ariordan-redhat ariordan-redhat commented Oct 20, 2021 •
edited

SUMMARY

When you use the groups parameter in the Ansible builtin user module to add users to a list of groups,
the users are removed from all other groups by default. You can modify this behaviour by using append.

The current documentation doesn't mention the default removal of the users from all other groups.

Fixes #75889

ISSUE TYPE
  • Docs Pull Request
COMPONENT NAME

https://github.com/ansible/ansible/blob/devel/lib/ansible/modules/user.py

ADDITIONAL INFORMATION

Definition of groups parameter in user module

  • Before:
List of groups user will be added to.
  • After:
List of groups user will be added to.
By default, the user is removed from all other groups. Configure append to modify this.

@ansibot ansibot added WIP This issue/PR is a work in progress. Nevertheless it was shared for getting input from peers. affects_2.13 docs This issue/PR relates to or includes documentation. docs_only All changes are to files within the docs/docsite/ directory module This issue/PR relates to a module. needs_triage Needs a first human triage before being processed. small_patch support:core This issue/PR relates to code supported by the Ansible Engineering Team. labels Oct 20, 2021
@ariordan-redhat ariordan-redhat removed the needs_triage Needs a first human triage before being processed. label Oct 20, 2021
@rpluem-vf rpluem-vf mentioned this pull request Oct 20, 2021
Closed
@ansibot ansibot added docs_only All changes are to files within the docs/docsite/ directory and removed docs_only All changes are to files within the docs/docsite/ directory labels Oct 21, 2021
@ariordan-redhat ariordan-redhat marked this pull request as ready for review October 26, 2021 17:10
@ansibot ansibot added core_review In order to be merged, this PR must follow the core review workflow. and removed WIP This issue/PR is a work in progress. Nevertheless it was shared for getting input from peers. labels Oct 26, 2021
@samccann samccann merged commit 765924a into ansible:devel Oct 29, 2021
ariordan-redhat added a commit to ariordan-redhat/ansible that referenced this pull request Nov 2, 2021
@ariordan-redhat
Add reminder about groups default behavior in user module (ansible#76096
8dc8659 
)
@ariordan-redhat ariordan-redhat mentioned this pull request Nov 2, 2021
Closed
@ansible ansible locked and limited conversation to collaborators Nov 19, 2021
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Reviewers

@samccann samccann samccann approved these changes

Assignees
No one assigned
Labels
affects_2.13 core_review In order to be merged, this PR must follow the core review workflow. docs_only All changes are to files within the docs/docsite/ directory docs This issue/PR relates to or includes documentation. module This issue/PR relates to a module. small_patch support:core This issue/PR relates to code supported by the Ansible Engineering Team.
Projects
None yet
Milestone
No milestone
Development

Successfully merging this pull request may close these issues.

'groups' feature of user builtin doesn't mention deleting groups
3 participants
@ariordan-redhat @samccann @ansibot