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)