README

This template includes a task yml for caching downloads to the Ludus host (download_file.yml) as well as GitHub action to push the role to Ansible Galaxy when a tag is created in git. You'll need to get a Galaxy token and set it as GALAXY_API_KEY in Github Secrets for the Ansible Galaxy deployment to work correctly.

Remove this section, and replace all {{ variable }} strings. Write your tasks in ./tasks/main.yml

Ansible Role: {{ Thing }} (Ludus)

An Ansible Role that installs {{ Something }} on {{ type of host }} and optionally configures {{ Another Thing }}.

Warning

This is a warning about something in this role

Requirements

None.

Role Variables

Available variables are listed below, along with default values (see defaults/main.yml):

# This is a comment explaining the variable below
ludus_thing_variable1: true

Dependencies

None.

Example Playbook

- hosts: {{ thing }}_hosts
  roles:
    - {{ your github username }}.{{ this repo name }}
  vars:
    {{ role vars here }}

Example Ludus Range Config

ludus:
  - vm_name: "{{ range_id }}-ad-dc-win2022-server-x64-1"
    hostname: "{{ range_id }}-DC01-2022"
    template: win2022-server-x64-template
    vlan: 10
    ip_last_octet: 11
    ram_gb: 6
    cpus: 4
    windows:
      sysprep: true
    domain:
      fqdn: ludus.domain
      role: primary-dc
    roles:
      - {{ your github username }}.{{ this repo name }}
    role_vars:
      {{ example role var usage }}

License

GPLv3

Author Information

This role was created by [{{Your Github Username}}](https://github.com/{{ your github username }}), for Ludus.