ONAP on Vagrant for ONAPers Victor Morales https://about.me/electrocucaracha

Agenda Problem statement ONAP on Vagrant Why Vagrant? Install prerequisites How to generate HTML documentation? Key features Synced Folders Plugins Shell Provisioning Architecture Usage

Problem Statement Allow new ONAP developers to ramp up on to active development quickly Reduce the cost to the community in responding to simple environment setup

ONAP on Vagrant It is a project that sets up a development environment for building artifacts required for every ONAP service. Its goal is to unify different development practices in an automated provisioning mechanism. Moved from : https://github.com/electrocucaracha/vagrant-onap To https://git.onap.org/integration/tree/bootstrap/vagrant-onap

Why Vagrant? It’s a tool for building and managing virtual machine environments in a single workflow. With an easy-to-use workflow and focus on automation, Vagrant lowers development environment setup time, increases production parity, and makes the "works on my machine" excuse a relic of the past.

Install prerequisites Vagrant v1.8.6+ (https://www.vagrantup.com/downloads.html) VirtualBox v4.3.36+ (https://www.virtualbox.org/wiki/Downloads) https://git.onap.org/integration/tree/bootstrap/vagrant-onap/doc/source/install/index.rst

How to generate HTML documentation? 2. Run tox using “docs” as an environment 1. Install tox How to generate HTML documentation?

Key features

Synced Folders Enables Vagrant to sync a folder on the host machine to the guest machine, allowing you to continue working on your project's files on your host machine, but use the resources in the guest machine to compile or run your project.

Shell Provisioning Provisioners in Vagrant allow you to automatically install software, alter configurations, and more on the machine as part of the vagrant up process. Shell provisioning is ideal for users new to Vagrant who want to get up and running quickly and provides a strong alternative for users who are not comfortable with a full configuration management system such as Chef or Puppet.

Key Features Synced Folders Shell Provisioning

Plugins They are powerful, first-class citizens that extend Vagrant using a well-documented, stable API that can withstand major version upgrades.

Architecture Folders: doc – Contains documentation about Advanced Features. It’s goal is to provide information about the usage of the tool lib – Contains scripts to clone repositories, configure services, build images, compile source code, etc. for ONAP services. opt – Shared folder that stores ONAP source code tests – Contains Unit Tests that ensure the correct functionality of the scripts located into lib folder. tools – Contains scripts to facilitate some daily tasks.

Usage - Demo $ ./tools/run.sh <app_name>