ansible/roles/ubuntu/README.md

73 lines
1.3 KiB
Markdown
Raw Normal View History

2024-12-20 03:17:03 +00:00
Ubuntu
=========
Sets up an Ubuntu server
- Installs Updates
- Disables Services
- Installs Packages
- Installs Users and Groups
Role Variables
--------------
Inputs (defaults):
- `ubuntu_disable_services`
- Type: `list[str]`
- Default: `[]`
- Description: SystemD service names to disable (including .service/.socket/etc)
- `ubuntu_install_packages`
- Type: `list[str]`
- Default: `[]`
- Description: Packages to install through APT
- `ubuntu_groups`
- Type: `list[str]`
- Default: `[]`
- Description: List of groups to create
- `ubuntu_users`
- Type: `list[dict]`
- Default: `[]`
- Description: List of user dictionaries
Vars:
- `ubuntu_passwordless_sudo_group`
- Type: `str`
- Default: `wheel`
- Description: The user group that will have passwordless sudo
Example Playbook
----------------
```yaml
- name: Setup Ubuntu
hosts: ubuntu
become: true
vars:
ubuntu_disable_services:
- unattended-upgrades.service
ubuntu_install_packages:
- build-essential
ubuntu_groups:
- sudo
ubuntu_users:
- name: ansible
ssh_key: ssh-rsa AAAAB...
groups:
- sudo
- wheel
roles:
- role: ubuntu
```
License
-------
BSD-3-Clause
Author Information
------------------
- [Code Fox](https://c0de.dev)