ckaserer.tftp

Maintenance

Rola Ansible do instalacji serwera TFTP (Trivial File Transfer Protocol) na RHEL/CentOS 7. Do głównych zadań tej roli należy:

instalacja niezbędnych pakietów
zarządzanie konfiguracją
zarządzanie ustawieniami SELinux

Aby uzyskać więcej informacji na temat TFTP, zobacz:

Wymagania

Brak.

Zmienne roli

Następujące zmienne mogą być ustawione przez administratora:

Zmienna	Domyślna wartość	Uwagi (typ)
`tftp_anon_write`	false	Zmienna logiczna określająca, czy SELinux pozwala na modyfikację plików.
`tftp_config`	/usr/lib/systemd/system/tftp.service	Ścieżka do pliku jednostki systemd dla tftp
`tftp_group`	root	Grupa dla `tftp_root_directory`
`tftp_home_dir`	false	Zmienna logiczna określająca, czy SELinux
`tftp_mode`	0755	Uprawnienia dla `tftp_root_directory`
`tftp_root_directory`	/var/lib/tftpboot	Ścieżka do katalogu głównego serwowanego przez tftp.
`tftp_server_args`	--secure	Argumenty wiersza poleceń przekazywane do wykonywalnego serwera
`tftp_server_foreman_support`	false	Włącz wsparcie Foreman, tworząc odpowiedni tftpd.map
`tftp_setype`	tftpdir_rw_t	Kontekst SELinux dla katalogu głównego tftp
`tftp_user`	root	Właściciel `tftp_root_directory`

Zależności

Brak zależności.

Przykładowy playbook

Zobacz playbook testowy

Testowanie

Testy dla tej roli są dostępne w formie środowiska Vagrant, które znajduje się w osobnej gałęzi, tests. Używam git-worktree(1) do włączenia kodu testowego do katalogu roboczego. Instrukcje uruchomienia testów:

Pobierz gałąź testów: git fetch origin tests
Stwórz obszar roboczy Git dla kodu testowego: git worktree add tests tests (uwaga: wymaga to co najmniej Git v2.5.0). To stworzy katalog tests/.
cd tests/
vagrant up stworzy VM i zastosuje drugi z dwóch dostępnych playbooków testowych wymienionych poniżej.

Playbooki testowe:

test-minimal.yml stosuje rolę do VM, z domyślnymi ustawieniami (brak ustawionych zmiennych roli).
test.yml stosuje rolę do VM, zmieniając niektóre domyślne wartości. Playbook umieszcza również plik o nazwie README w katalogu głównym TFTP. Po zastosowaniu tego playbooka powinieneś być w stanie pobrać ten plik z systemu gospodarza (zakładając, że klient tftp jest zainstalowany):
```
$ tftp 127.0.0.1 6969 -c get README
```

Port TFTP (69) na VM jest przekierowywany przez interfejs NAT do portu 6969 w systemie gospodarza, stąd 127.0.0.1 i numer portu w wierszu poleceń.

Współpraca

Problemy, prośby o funkcje, pomysły są mile widziane i można je zamieszczać w sekcji Issues. Prośby o dodanie kodu również są bardzo mile widziane. Preferowane jest stworzenie gałęzi tematycznej i przy przesyłaniu zsumowanie swoich commitów w jeden (z opisowym komunikatem).