First commit.

This commit is contained in:
Andrea Dell'Amico 2021-12-23 15:40:45 +01:00
parent d56b63a4a7
commit 813a7feabb
Signed by: adellam
GPG Key ID: 147ABE6CEB9E20FF
6 changed files with 95 additions and 68 deletions

View File

@ -1,31 +1,32 @@
Role Name
=========
A brief description of the role goes here.
Requirements
------------
Any pre-requisites that may not be covered by Ansible itself or the role should be mentioned here. For instance, if the role uses the EC2 module, it may be a good idea to mention in this section that the boto package is required.
A role that installs a tftp server. Currently tftp only, no pxe/ipxe.
Role Variables
--------------
A description of the settable variables for this role should go here, including any variables that are in defaults/main.yml, vars/main.yml, and any variables that can/should be set via parameters to the role. Any variables that are read from other roles and/or the global scope (ie. hostvars, group vars, etc.) should be mentioned here as well.
The most important variables are listed below:
``` yaml
tftpd_port: 69
tftpd_deb_package: tftpd-hpa
tftpd_user: tftp
tftpd_group: '{{ tftpd_user }}'
tftpd_alternative_data_dir: True
tftpd_data_dir: /srv/tftp
tftpd_default_file: tftpd-hpa
tftpd_listen: ":{{ tftpd_port }}"
tftpd_options: '--secure'
```
Dependencies
------------
A list of other roles hosted on Galaxy should go here, plus any details in regards to parameters that may need to be set for other roles, or variables that are used from other roles.
Example Playbook
----------------
Including an example of how to use your role (for instance, with variables passed in as parameters) is always nice for users too:
- hosts: servers
roles:
- { role: username.rolename, x: 42 }
None
License
-------
@ -35,4 +36,4 @@ EUPL-1.2
Author Information
------------------
An optional section for the role authors to include contact information, or a website (HTML is not allowed).
Andrea Dell'Amico, <andrea.dellamico@isti.cnr.it>

View File

@ -1,2 +1,13 @@
---
# defaults file for ansible-role-template
tftpd_port: 69
tftpd_deb_package: tftpd-hpa
tftpd_user: tftp
tftpd_group: '{{ tftpd_user }}'
tftpd_alternative_data_dir: True
tftpd_data_dir: /srv/tftp
tftpd_default_file: tftpd-hpa
tftpd_listen: ":{{ tftpd_port }}"
tftpd_options: '--secure'

View File

@ -1,2 +1,5 @@
---
# handlers file for ansible-role-template
- name: Restart tftpd
ansible.builtin.service:
name: tftpd-hpa
state: restarted

View File

@ -1,61 +1,23 @@
galaxy_info:
author: your name
description: your description
author: Andrea Dell'Amico
description: Systems Architect
company: ISTI-CNR
# If the issue tracker for your role is not on github, uncomment the
# next line and provide a value
issue_tracker_url: https://redmine-s2i2s.isti.cnr.it/projects/provisioning
# Some suggested licenses:
# - BSD (default)
# - MIT
# - GPLv2
# - GPLv3
# - Apache
# - CC-BY
license: EUPL-1.2
license: EUPL 1.2+
min_ansible_version: 2.8
# If this a Container Enabled role, provide the minimum Ansible Container version.
# min_ansible_container_version:
# Optionally specify the branch Galaxy will use when accessing the GitHub
# repo for this role. During role install, if no tags are available,
# Galaxy will use this branch. During import Galaxy will access files on
# this branch. If Travis integration is configured, only notifications for this
# branch will be accepted. Otherwise, in all cases, the repo's default branch
# (usually master) will be used.
#github_branch:
#
# Provide a list of supported platforms, and for each platform a list of versions.
# If you don't wish to enumerate all versions for a particular platform, use 'all'.
# To view available platforms and versions (or releases), visit:
# https://galaxy.ansible.com/api/v1/platforms/
#
# platforms:
# - name: Fedora
# versions:
# - all
# - 25
# - name: SomePlatform
# versions:
# - all
# - 1.0
# - 7
# - 99.99
platforms:
- name: Ubuntu
versions:
- bionic
galaxy_tags: []
# List tags for your role here, one per line. A tag is a keyword that describes
# and categorizes the role. Users find roles by searching for tags. Be sure to
# remove the '[]' above, if you add tags to this list.
#
# NOTE: A tag is limited to a single word comprised of alphanumeric characters.
# Maximum 20 tags per role.
galaxy_tags:
- tftp
dependencies: []
# List your role dependencies here, one per line. Be sure to remove the '[]' above,
# if you add dependencies to this list.

View File

@ -1,2 +1,44 @@
---
# tasks file for ansible-role-template
- name: Install and configure the tftpd server
block:
- name: Install the tftpd package on deb systems
ansible.builtin.apt:
pkg: '{{ tftpd_deb_package }}'
state: present
cache_valid_time: 1800
- name: Overwrite the /etc/default file, deb systems
ansible.builtin.template:
src: '{{ tftpd_default_file }}.j2'
dest: '/etc/default/{{ tftpd_default_file }}'
notify: Restart tftpd
when: ansible_os_family == "Debian"
tags: ['tfptd', 'tftp']
- name: Configure the tftpd server
block:
- name: Create the data directory, different from the default
ansible.builtin.file:
dest: '{{ tftpd_data_dir }}'
state: directory
owner: '{{ tftpd_user }}'
group: '{{ tftpd_group }}'
mode: 0750
when: tftpd_alternative_data_dir
tags: ['tfptd', 'tftp']
- name: Manage the tftpd service
block:
- name: Ensure that the tftpd service is running and enabled
ansible.builtin.service:
name: tftpd-hpa
state: started
enabled: True
when: ansible_os_family == "Debian"
tags: ['tfptd', 'tftp']
- meta: flush_handlers
tags: ['tfptd', 'tftp']

8
templates/tftpd-hpa.j2 Normal file
View File

@ -0,0 +1,8 @@
TFTP_USERNAME="{{ tftpd_user }}"
{% if tftpd_alternative_data_dir %}
TFTP_DIRECTORY="{{ tftpd_data_dir }}"
{% else %}
TFTP_DIRECTORY="/var/lib/tftpboot"
{% endif %}
TFTP_ADDRESS="{{ tftpd_listen }}"
TFTP_OPTIONS="{{ tftpd_options }}"