{"id":16288447,"url":"https://github.com/daks/usersandgroups-formula","last_synced_at":"2026-01-11T05:49:54.934Z","repository":{"id":10356524,"uuid":"65475691","full_name":"daks/usersandgroups-formula","owner":"daks","description":"Saltstack formula to manage users and groups","archived":false,"fork":false,"pushed_at":"2023-03-17T02:01:30.000Z","size":88,"stargazers_count":0,"open_issues_count":4,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-02-08T05:18:53.378Z","etag":null,"topics":["formula","salt","salt-formula","saltstack"],"latest_commit_sha":null,"homepage":null,"language":"SaltStack","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/daks.png","metadata":{"files":{"readme":"docs/README.rst","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-08-11T14:23:39.000Z","updated_at":"2021-08-17T12:40:32.000Z","dependencies_parsed_at":"2024-10-27T21:44:09.258Z","dependency_job_id":"874a97b5-6289-4891-a091-604c79800b55","html_url":"https://github.com/daks/usersandgroups-formula","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daks%2Fusersandgroups-formula","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daks%2Fusersandgroups-formula/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daks%2Fusersandgroups-formula/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daks%2Fusersandgroups-formula/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/daks","download_url":"https://codeload.github.com/daks/usersandgroups-formula/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246828503,"owners_count":20840474,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["formula","salt","salt-formula","saltstack"],"created_at":"2024-10-10T19:48:20.312Z","updated_at":"2026-01-11T05:49:54.928Z","avatar_url":"https://github.com/daks.png","language":"SaltStack","funding_links":[],"categories":[],"sub_categories":[],"readme":".. _readme:\n\nusersandgroups-formula\n======================\n\n|img_travis| |img_sr|\n\n.. |img_travis| image:: https://travis-ci.com/daks/usersandgroups-formula.svg?branch=master\n   :alt: Travis CI Build Status\n   :scale: 100%\n   :target: https://travis-ci.com/daks/usersandgroups-formula\n.. |img_sr| image:: https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg\n   :alt: Semantic Release\n   :scale: 100%\n   :target: https://github.com/semantic-release/semantic-release\n\nA SaltStack formula to manage system users and groups.\n\n.. contents:: **Table of Contents**\n\nGeneral notes\n-------------\n\nSee the full `SaltStack Formulas installation and usage instructions\n\u003chttps://docs.saltstack.com/en/latest/topics/development/conventions/formulas.html\u003e`_.\n\nIf you are interested in writing or contributing to formulas, please pay attention to the `Writing Formula Section\n\u003chttps://docs.saltstack.com/en/latest/topics/development/conventions/formulas.html#writing-formulas\u003e`_.\n\nAvailable states\n----------------\n\n.. contents::\n    :local:\n\n``usersandgroups``\n^^^^^^^^^^^^^^^^^^\n\nConfigures users' home directory, group, shell, the user itself, secondary groups.\n\nIt also manages per-user SSH authorized_keys files. Two possibilities:\n\n* indicate a ssh_pubkey.source pillar for a user\n* indicate a global config.ssh_pubkeys_dir value\n\nThe formula will first look for a per-user value and, if it doesn't exist, \nsearch for a {{ user }}.pub file in the config.ssh_pubkeys_dir if it exists.\nYou can also indicate that a user have no ssh pubkey.\n\nYou can also manage user files. Files management can be enabled or disabled\nglobally or per-user.\nThe source files can be defined globally, each user will take the directory\nwith its username. Source can also be defined per-user.\nA default source can be defined and be used if no per-user source is found.\n\nAll configuration is made using pillar data, read pillar.example to see how.\n\n\nTesting\n-------\n\nLinux testing is done with ``kitchen-salt``.\n\n``kitchen converge``\n^^^^^^^^^^^^^^^^^^^^\n\nCreates the docker instance and runs the ``usersandgroups`` main state, ready for testing.\n\n``kitchen verify``\n^^^^^^^^^^^^^^^^^^\n\nRuns the ``inspec`` tests on the actual instance.\n\n``kitchen destroy``\n^^^^^^^^^^^^^^^^^^^\n\nRemoves the docker instance.\n\n``kitchen test``\n^^^^^^^^^^^^^^^^\n\nRuns all of the stages above in one go: i.e. ``destroy`` + ``converge`` + ``verify`` + ``destroy``.\n\n``kitchen login``\n^^^^^^^^^^^^^^^^^\n\nGives you SSH access to the instance for manual testing.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdaks%2Fusersandgroups-formula","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdaks%2Fusersandgroups-formula","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdaks%2Fusersandgroups-formula/lists"}