kayobe/ansible/roles/dell-switch-bmp/README.md

70 lines
2.2 KiB
Markdown

Dell Switch BMP
===============
This role configures a network boot environment for Dell switches with Bare
Metal Provisioning (BMP) functionality.
Requirements
------------
The use of an OpenStack Bifrost container deployed using OpenStack
Kolla-ansible is assumed, with the dnsmasq service providing DHCP and nginx
serving the switch OS images.
Role Variables
--------------
`dell_switch_bmp_images` is a list of images to provide a BMP configuration
for, and defaults to an empty list. Each item should be a dict with the
following keys:
`url`
URL of the image to download.
`dest`
Name of the file to download the image to.
`match`
dnsmasq match rule to match hosts against.
`tag`
dnsmasq tag to apply to matching hosts.
`checksum`
optional checksum of image, in format required for Ansible's `get_url`
module.
`dell_switch_bmp_http_base_url` is the base URL of HTTP server.
`dell_switch_bmp_httpboot_path` is the path to the HTTP server base directory,
and defaults to `/httpboot`.
Dependencies
------------
None
Example Playbook
----------------
The following playbook configures a network boot environment in the Bifrost
container for s6010-ON switches with the `ONIE-FTOS-9.10.0.1P25.bin` image.
---
# This playbook will configure a Bare Metal Provisioning (BMP) environment for
# Dell switches on the Bifrost node so that they can be network booted.
- name: Ensure that a Bare Metal Provisioning (BMP) environment is configured for Dell switches
hosts: bifrost
roles:
- role: dell-switch-bmp
dell_switch_bmp_images:
# ONIE installer image for S6010-ON.
- url: "ftp://ftp.force10networks.com/releases/FTOS_Release/E9.10.0.1P25/S6010/ONIE-FTOS-S6010-9.10.0.1P25.bin"
checksum: "md5:f94fdfa50dc23f87bf2871ae96b6cff3"
dest: "onie-installer-x86_64-dell_s6010_c2538-r0"
match: "option:vendor-class,onie_vendor:x86_64-dell_s6010_c2538-r0"
tag: "onie"
# This is the base URL of the Nginx web server on the Bifrost node.
dell_switch_bmp_http_base_url: "http://10.0.0.1:8080"
Author Information
------------------
- Mark Goddard (<mark@stackhpc.com>)