Ansible role `pxeserver`

An Ansible role for setting up a PXE boot server.

Install necessary packages
Configure and start necessary services (TFTP, DHCP, NFS)
Make installation images available to clients

This role will download the kernel(s) and initrd(s) that you want to boot, but the filesystem (that will be shared over NFS) is not set up automatically.

Requirements

No specific requirements

Role Variables

TODO

Variable	Default	Comment
`pxeserver_directory`	`pxelinux`	Subdirectory under TFTP root for PXE specific files
`pxeserver_images`	[]	List of dicts specifying PXEboot images to be served. See below.
`pxeserver_ip`	`ansible_default_ipv4.address`	IP address of the PXE server

You can specify the boot images to be served with the variable pxeserver_images, a dict containing the keys listed below. Keys are mandatory unless specified.

Key	Value
`name`	A unique identifier for the image
`default`	When `true`, this image is chosen as the default. May be omitted.
`kernel_url`	URL where to download the kernel image.
`initrd_url`	URL where to download the initrd image.
`kickstart_url`	URL where to download the kickstart file. May be omitted
`kickstart_path`	Location where to copy the kickstart file from. May be omitted
`label`	Label for the PXE boot menu entry of this image.

Dependencies

This role depends on:

msaf1980.tftp
msaf1980.dhcp
[msaf1980.nfsserver] (https://github.com/msaf1980/ansible-role-nfsserver) Non-mandatory, if not needed to export rootfs by NFS, but you can do it over FTP or HTTP

Example Playbook

See the test playbook

Testing

The tests directory contains tests for this role in the form of a Vagrant environment. You should install the dependent roles

$ 
cd tests/
git clone ssh://[email protected]/msaf1980/ansible-role-tftp roles/msaf1980.tftp
git clone ssh://[email protected]/msaf1980/ansible-role-dhcp roles/msaf1980.dhcp
git clone ssh://[email protected]/msaf1980/ansible-role-nfsserver roles/msaf1980.nfsserver
$ vagrant up

The last command creates a new CentOS 7 VM and applies the playbook test.yml. This should result in a working PXE server.

Contributing

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).

License

BSD

Author Information

Bert Van Vreckem ([email protected])

msaf1980 / ansible-role-pxeserver Goto Github PK