This page is a consolidation of links that should help any developers, users, architects and owners get up to speed on the ONAP project.

Developer Best Practices

Quickstart Setup

Running the root pom on almost all the projects under - for example - RHEL 7.3 - you should be able to build the entire ONAP system and also import/build them in IntelliJ

Import the root pom.xml of the project or the entire onap as a maven project


Try to be outside your company firewall and proxy - otherwise open your firewall for the following ports as required

ssh:22, git:29418


Verify you have access to GitGerrit (port), Nexus, JIRA and Jenkins, Sonarbiterg for your Linux Foundation ID see http://onap.readthedocs.io/en/latest/index.html

Familiarize with existing and future proposed architecture components of ONAP and additional repositories on github (evel-library, cdp-pal)

Get Rackspace Cloud or Openstack Ocata LAB access and deploy the demo VMs and verify URLs (portal, policy, vid, sdc) and VM deployments (TBD: 33 docker compose orchestrated containers on 12 VMS)

Setup git, maven (~.m2/settings.xml), java, python, (npm, bower), docker and one or both Eclipse and IntelliJ IDEs and optionally Sourcetree

Git checkout all ONAP repos via sh script at Building Entire ONAP#Clone/pullallreposshscript

Maven build all or part of ONAP

Subscribe to ONAP Newsgroups.  Note: as of 20170603 there are 3 groups Onap-arc, onap-discuss (this one has a lot of good dev/build/deploy/demo technical discussion even though the description lists non-technical), ONAP-TSC

Watch all ONAP or specific Confluence pages and questions, review TSC meeting minutes

Run the updated ONAP 1.0.0 demo

Specifications

White Paper http://about.att.com/content/dam/snrdocs/ecomp.pdf

http://www.etsi.org/technologies-clusters/technologies/nfv | https://portal.etsi.org/tb.aspx?tbid=789&SubTB=789,795,796,801,800,798,799,797,802#50610-contributions

https://www.open-o.org/

Tech

Get the "Network Function Virtualization" 2016 book by Ken Gray and Thomas D. Nadeau - their successor to their "SDN: Software Defined Networks" book of 2013

Karaf | Kubernetes (ONAP Operations Manager / ONAP on Containers)  - ONAP on Kubernetes


Known Issues

Confluence links from JIRA work but don't display -  DOC-4 - Getting issue details... STATUS

Please follow upstream first approach (better to submit code as-is incrementally) - https://lists.onap.org/pipermail/onap-tsc/2017-August/001449.html

Root POM

Building Entire ONAP#Rootpom.xml

  • No labels

8 Comments

  1. Is Karaf used outside of Opendaylight / SDN Controller?

  2. What is the swaggerhub account needed for?

  3. Are ONAP projects really using github & dockerhub or are projects outside of ONAP using those? ONAP projects put source code into a gerrit deployment that is specific to ONAP as far as I am aware. I'm not sure about dockerhub.

    1. Based on what I found docker images are uploaded to nexus3.onap.org

      1. I had similar concerns about dockerhub in  TSC-80 - Getting issue details... STATUS

        1. So to build the images someone needs a dockerhub account? To download an already created image this is not needed?

          1. Well, for example, the CIA team wanted to make an ARM64 version of AAI containers, which meant rebuilding the aaionap/aai-common base image. That base image is only available on dockerhub and was built separately.

            Anyone can download the base image to build the AAI containers without having a dockerhub account, but you would need the dockerhub account to update/rebuild the base image.

            The resulting AAI microservices (Resources, Traversal, etc) containers are hosted in nexus3 and again anyone can download those images without having an account.