Page History

...

curl -fsSL https://get.docker.com -o get-docker.sh
sh get-docker.sh

1. 1. Maven - version 3
   2. JDK - 1.817
2. Create a new user group in the VM named "docker" and add the Jenkins user to this user groups the below commands can be referred for the same

   1. Create the docker group.

      $ sudo groupadd docker
      

   2. Add your user to the docker group.

      $ sudo usermod -aG docker $USER
      

   3. Log out and log back in so that your group membership is re-evaluated.

      If testing on a virtual machine, it may be necessary to restart the virtual machine for changes to take effect.

      On a desktop Linux environment such as X Windows, log out of your session completely and then log back in.

      On Linux, you can also run the following command to activate the changes to groups:

      $ newgrp docker 
      

   4. Verify that you can run docker commands without sudo.

      $ docker run hello-world
      

      This command downloads a test image and runs it in a container. When the container runs, it prints a message and exits.

3. Access to pull the docker base image like tomcat, mysql from dockerhub should be available. If access cannot be provided then those images should be available locally in the Jenkins VM for building docker images of Automatics tools.

...

1. Clone the above repo and go to the directory "jenkinsServerSetup\"
2. Here you will find a file named "install_jenkins_server.sh" 
3. Execute this shell script as sudo. This will install Docker and pull the Jenkins server image from docker hub 
4. Then it will install all the necessary dependencies link maven, and Jenkins plugins.
5. Also Automatics Core & RDKB Utils build jobs as well as Build and Deployments jobs will be created.
6. When executing the shell script it will ask for the inputs like the port in which the Jenkins server needs to be started. Please input those details during execution
7. Once the jenkins server setup is completed. Open the browser and give the public ip and port(or domain name if you have one) in URL box which will open the jenkins webpage. For example if your public ip address is 192.168.91.44 and jenkins server is started on 8909 the give the URL as "192.168.91.44:8909", you will get the page like below 
   1. 
8. Now open "Manage Jenkins" option→ "Configure Global Security" → Under Security Realm, select Jenkins’ own user database → In the Authorization section, select Logged-in users can do anything. → Unselect Allow anonymous read access. → Click Save to save your changes.
   1. 
   2.  
   3. 
9. Now go inside the already created jobs in Jenkins and modify the necessary configurations like maven repo URL, Shell script file paths etc

...

1. Login to Jenkins webpage
2. Click on New Item button at the Left hand side menu
   1. 
3. Now Enter the name of the pipeline job and select pipeline option from below and click OK, as shown in the image below
   1. 
4. Navigate to the pipeline menu in the options and select "Pipeline script from SCM" in the drop down menu under the header definition. Then select the option Git for SCM. After that provide the Repo URL credentials and the branch. Then click save
   1. when adding the script path the path to the Jenkinsfile from the home directory of the repo should be provided. For the example the home directory of the repo is "/home/automatics/" and the location of Jenkins file for build job is "/home/automatics/automationScripts/build/Jenkinsfilehttps://code.rdkcentral.com/r/rdk/tools/automatics/dev-ops" then the script path should be entered as "automationScripts/build/Jenkinsfile"
   2. 

...

Provide all the fields based on the description provided against each field and press the build button to build the job.

Mandatory Automatics Configurations

...

for Test Execution

The below configurations needs to be done available in Automatics Orchestration, Automatics Properties, Device Manager and Jenkins jobs inorder to trigger a successful Test case execution from Automatics Orchestration

...

After completing the above set of configuration "CI_Automatics_Code_Deploy_And_3.0_Api_Parser" job should be executed. This job will build and deploy all the automatics dependencies to the repo and run the parsers needed for Automatics Scriptless automation (Automatics 3.0). After that "Deploy_RPi_Partner_Java_API" job needs to be executed. Once all these jobs are executed successfully it is good to go with jenkins job configuration for Automatics

Automatics Orchestration

System Configuration

The below mandatory system configurations needs to be done in Automatics orchestration for running a first dummy Test execution and result verification from automatics.

Device Models

The device model needs to be configured and you can see this document for adding device model to automatics orchestration Automatics Orchestration Setup#DeviceModels

Resource Details

Resource details holds the configuration like the URL of jenkins server which needs to be configured in automatics for triggering the job execution and you can see this document for adding resource details to automatics orchestration Automatics Orchestration Setup#ResourceDetails

Automatics Properties

All the mandatory properties mentioned in the document Automatics Properties should be configured in automatics properties for the successful execution of a test case.