An Ansible role for installing a TFTP (Trivial File Transfer Protocol) server on RHEL/CentOS 7. Specifically, the responsibilities of this role are to:

• install the necessary packages
• manage the configuration
• manage SELinux settings

For more relevant documentation on TFTP, see:

• tftpd(8) man page
• tftp_selinux(8) man page

none.

The following variables can be set by the administrator:

No dependencies.

See the test playbook

Tests for this role are provided in the form of a Vagrant environment that is kept in a separate branch, tests. I use git-worktree(1) to include the test code into the working directory. Instructions for running the tests:

1. Fetch the tests branch: git fetch origin tests
2. Create a Git worktree for the test code: git worktree add tests tests (remark: this requires at least Git v2.5.0). This will create a directory tests/.
3. cd tests/
4. vagrant up will then create a VM and apply the second of the two available testing playbooks enumerated below.

The test playbooks:

• test-minimal.yml applies the role to a VM, with default settings (no role variables are set).

• test.yml applies the role to a VM, changing some default values. The playbook also puts a file named README into the TFTP root directory. After applying this playbook, you should be able to fetch that file from your host system (assuming the tftp client is installed):

  $ tftp 127.0.0.1 6969 -c get README

The TFTP port (69) on the VM is forwarded through the NAT interface to port 6969 on your host system, hence the 127.0.0.1 and port number in the command line.

Issues, feature requests, ideas are appreciated and can be posted in the Issues section. Pull requests are also very welcome. Preferably, create a topic branch and when submitting, squash your commits into one (with a descriptive message).

BSD

Bert Van Vreckem ([email protected])

Contributions by:

• @kostyrevaa : Foreman support (v1.2.0)