Mellanox NEO SDN Controller

This role is used to set up a Mellanox NEO SDN controller that runs in a Docker container.

You can find the tools to create a compatible container image on GitHub <https://github.com/stackhpc/docker-mlnx-neo>.

Requirements

To execute this role, the host needs:

• Docker engine
• Python docker >= 2.0.0

Role Variables

• mlnx_neo_action: Action to perform. Choose from build, deploy, destroy, pull, reconfigure, upgrade. The default is deploy.
• mlnx_neo_enabled: Indicates if NEO is enabled. The default is true.
• mlnx_neo_image: Name of the Docker image. This is required.
• mlnx_neo_tag: Tag for the Docker image. The default is latest.
• mlnx_neo_image_full: Complete specification for the Docker image.
• mlnx_neo_restart_policy: Policy for restarting the NEO container in Docker. The default is unless-stopped.
• mlnx_neo_restart_retries: Number of times to attempt to restart Docker. The default is 10.
• mlnx_neo_startup_config_path: Location of a script template on your local machine that contains the startup configuration. The default is /etc/mlnx-neo/mlnx-neo-configure.
• mlnx_neo_config_path: Directory on the remote host to store the configuration. The default is /etc/mlnx-neo.

The following variables are only needed when mlnx_neo_action is set to build:

• mlnx_neo_repo_url: URL of the git repository that has the image. The default is https://github.com/stackhpc/docker-mlnx-neo.
• mlnx_neo_repo_version: Version to use from the git repository. The default is master.
• mlnx_neo_repo_checkout_path: Directory where the git repository will be downloaded. The default is /tmp.
• mlnx_neo_tarball_url: URL for the NEO software tarball. This needs to be set to build the image.
• mlnx_neo_push: Indicates whether to push images after they are built. The default is false.
• mlnx_neo_force_rebuild: Indicates if the image should be rebuilt even if an image with the same name and tag already exists. The default is false.

Dependencies

None

Example Playbook

Here is an example playbook that configures Mellanox NEO.

---
- hosts: mlnx-neo
  roles:
    - role: mlnx-neo

Author Information

• Mark Goddard (mark@stackhpc.com)