Setting up APPC build environment

Here we will show you how to setup APPC build environment on Ubuntu 16.04

• Reference links
  • Building and Running APPC Docker Images

1. Install and setup Docker

   sudo apt update -y

   sudo apt install -y apt-transport-https ca-certificates curl software-properties-common wget zip

   sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

   sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"

   sudo apt update -y

   sudo apt install -y docker-ce

   sudo apt-get install -y docker-compose

   sudo usermod -aG docker $USER

   Note: You should logout and login back to execute docker commands

2. Install Java & Maven 

   sudo apt update

   sudo apt install openjdk-8-jdk openjdk-8-jre -y

   sudo apt install maven -y

   bash -c 'echo  export JAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64 >> ~/.bashrc'

3. Setup local maven repository

   mkdir -p $HOME/.m2

   Download and copy settings.xml settings.xml to $HOME/.m2 folder
4. Clone APPC git repository

   mkdir -p $HOME/ONAP-APPC

   cd $HOME/ONAP-APPC

   
   

   # APPC Core projects

   
   

   # TODO : For now we are using the Casablanca maintenance release tag  3.0.1-ONAP 

   git clone -b 3.0.1-ONAP https://github.com/onap/appc-parent

   git clone -b 3.0.1-ONAP https://gerrit.onap.org/r/appc

   # This for building APPC docker images

   git clone -b 3.0.1-ONAP https://gerrit.onap.org/r/appc/deployment

5. Build appc-parent
   

   cd $HOME/ONAP-APPC/appc-parent

   # We need to increment minor version in the following POM files

   # Execute the following command to increment the minor version from 1.4.1-SNAPSHOT to 1.4.2-SNAPSHOT

            find . -name "*pom.xml" | xargs sed -i 's|1.4.1-SNAPSHOT|1.4.2-SNAPSHOT|g'

            # Use the following command verify the list of files updated

            find . -name "*pom.xml" | xargs grep -w '1.4.2-SNAPSHOT'      

            # Replace '1.1.3' with 1.2.2 using the below command, otherwise we can use vi or other text editor to the same

           find . -name pom.xml | xargs sed -i 's|1.1.3|1.2.2|g'

            #vi ./feature-repo-parent/pom.xml
            #vi ./binding-parent/pom.xml
            #vi ./bundle-parent/pom.xml
            #vi ./pom.xml
            #vi ./single-feature-parent/pom.xml
            #vi ./odlparent-lite/pom.xml

            # Updated the CCSDK parent artifact "org.onap.ccsdk.parent" version should like the below one

            # This is to use the CCSDK with ODL Fluorine SR2 release

                                                  <parent>
                                                  <groupId>org.onap.ccsdk.parent</groupId>
                                                  <artifactId>odlparent-lite</artifactId>
                                                  <version>1.2.2</version>
                                                 <relativePath />
                                                 </parent>

           # Now, build the parent project. It would sometime and we should wait for this one to get completed.

            mvn clean install -DskipTests | tee appc-parent-build.log

1. Build appc core projectcd $HOME/ONAP-APPC/appc

            # We should first refer new local release version of the appc-parent components

            # It should be 1.4.2-SNAPSHOT

1. TODO