https://github.com/stackhpc/ansible-role-mlnx-neo

Ansible role to deploy Mellanox NEO SDN controller in a Docker container
https://github.com/stackhpc/ansible-role-mlnx-neo

Last synced: 2 months ago
JSON representation

Ansible role to deploy Mellanox NEO SDN controller in a Docker container

• Host: GitHub
• URL: https://github.com/stackhpc/ansible-role-mlnx-neo
• Owner: stackhpc
• License: apache-2.0
• Created: 2018-04-12T10:59:59.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2022-08-03T08:03:19.000Z (almost 4 years ago)
• Last Synced: 2024-04-14T22:50:17.010Z (over 2 years ago)
• Homepage:
• Size: 13.7 KB
• Stars: 0
• Watchers: 8
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

          
Mellanox NEO SDN Controller

===========================

This role can be used to configure a Mellanox NEO SDN controller running in a

Docker container.

Tooling to build a compatible container image is provided on `Github

`.

Requirements

------------

The host executing the role has the following requirements:

* Docker engine

* Python ``docker >= 2.0.0``

Role Variables

--------------

* ``mlnx_neo_action``: Action to perform. One of ``build``, ``deploy``,

``destroy``, ``pull``, ``reconfigure``, ``upgrade``. Defaults to ``deploy``.

* ``mlnx_neo_enabled``: Whether NEO is enabled. Defaults to ``true``.

* ``mlnx_neo_image``: Docker image name. Required.

* ``mlnx_neo_tag``: Docker image tag. Defaults to ``latest``.

* ``mlnx_neo_image_full``: Full docker image specification.

* ``mlnx_neo_restart_policy``: Docker restart policy for the NEO container.

  Defaults to ``unless-stopped``.

* ``mlnx_neo_restart_retries``: Number of Docker restarts. Defaults to 10.

* ``mlnx_neo_startup_config_path``: Path to a script template on localhost

  containing startup configuration. Default is

  ``/etc/mlnx-neo/mlnx-neo-configure``.

* ``mlnx_neo_config_path``: Path to a directory on the remote host to store

  configuration.  Default is ``/etc/mlnx-neo``.

The following variables are relevant only when ``mlnx_neo_action`` is

``build``:

* ``mlnx_neo_repo_url``: URL of the git repo containing the image. Default is

  ``https://github.com/stackhpc/docker-mlnx-neo``.

* ``mlnx_neo_repo_version``: Version to check out for the git repo containing

  the image. Default is ``master``.

* ``mlnx_neo_repo_checkout_path``: Path to a directory in which to check out

  the git repo. Default is ``/tmp``.

* ``mlnx_neo_tarball_url``: URL of the NEO software tarball. This must be set

  to build the image.

* ``mlnx_neo_push``: Whether to push images after they have been built. Default

  is ``false``.

* ``mlnx_neo_force_rebuild``: Whether to build the image even if an image of

  the same name and tag exists. Default is ``false``.

Dependencies

------------

None

Example Playbook

----------------

The following playbook configures Mellanox NEO.

    ---

    - hosts: mlnx-neo

      roles:

        - role: mlnx-neo

Author Information

------------------

- Mark Goddard ()