User Tools

Site Tools


compass4nfv-plugin-integration-api

This is an old revision of the document!


Compass4nfv Plug-in Integration API

Introduction

Compass4nfv is based on Ansible Script supporting provision both Ubuntu and Centos operating system, and OpenStack and SDN including OpenDayLight and ONOS framework installation and configuration.

How to Integrate 3rd party project into Compass4nfv

1. Create a role: every component in Compass4nfv is a role, it's in the directory "compass4nfv/deploy/adapters/ansible/roles", you can create a role named your project in this directory. (1.png)

(2.png) 2. Create a "files" folder in your role directory: store some files that need to be used during the installation and provision in the directory "compass4nfv/deploy/adapters/ansible/roles/{your component}/files".

3. Create a "handlers" folder in your role directory: store some .yml scripts to handle with some events from your component in the directory "compass4nfv/deploy/adapters/ansible/roles/{your component}/handlers"

4. Create a "tasks" folder in your role directory: store the main thread .yml scripts for installation and provision in the directory "compass4nfv/deploy/adapters/ansible/roles/{your component}/tasks"

5. Create a "template" folder in your role directory: store some templates that need to be used during the installation and provision in the directory "compass4nfv/deploy/adapters/ansible/roles/{your component}/template"

6. Create a "vars" folder in your role directory: store some .yml scripts with variables that need to be used during installation and provision in the directory "compass4nfv/deploy/adapters/ansible/roles/{your component}/vars"

All the installation provision and configuration scripts should be in the role.

7. Add the component role to the deploy scripts, in the "compass4nfv/deploy/adapters/ansible/openstack" directory, there are "single-controller.yml" and "HA-ansible-multinodes.yml" available, "single-controller.yml" is for one controller and 4 compute, "HA-ansible-multinodes.yml" is for 3 controller in HA mode and 2 compute. (4.png)

item "hosts" means which hosts will be deployed. item "roles" include all the components will be deployed on the "hosts" above. you can insert your component role into the existing role list also could create a new block to include your component role like odl and onos.

compass4nfv-plugin-integration-api.1448610632.txt.gz · Last modified: 2015/11/27 07:50 by shuai chen