Continuous Integration - leortyz/softwareEngineeringResources GitHub Wiki

• Automatically run tests after uploading new code to an existing repository using Jenkins.
• Obtain a report with the results of the tests.

• Eclipse IDE for Java Developers >= 2021‑03 Download from Eclipse || Get executable
• Gradle tool for eclipse
• Git
• Jenkins >= 2.222.1 Download
• Ngrok Download

Continuous integration is a software development practice where a new code is joined to an existing code that is hosted in a repository. The union of codes comes with automatic execution of tests to ensure its correct operation[1].
The goal of continuous integration is to quickly detect and locate bugs, so reduce the time to fix and improve the software, and that updates are available as soon as possible.
To carry out this workshop, you must use Jenkins as a continuous integration tool. Jenkins is Open Source and runs as a server on the host machine; In addition, it has numerous plugins that increase its capabilities.
Additionally, you must use Ngrok, which is a tool that allows exposing a local url to a public url.
For this workshop, Jenkins will run locally on your computer, by uploading the changes to our remote repository hosted on Github, it will be able to send a response to our server, so it is necessary to have a public url to expose our local server to the internet. Here Ngrok intervenes that will act as a communication bridge between Github and Jenkins.

1. Go to the following https://jenkins.io/download/
2. Download Jenkins (LTS o Weekly) for your OS.
3. Follow the steps shown in the following tutorial: Windows [2] o ubuntu[3]

1. Go to the following https://dashboard.ngrok.com/signup
2. Create an account. Github is recommended
3. Download the file

4. Unzip the file

//Replace <your authtoken> with the token given in the page
./ngrok authtoken <your authtoken>

5. Open the program and enter the following command
   Note: The authtoken is in the 2nd item of the ngrok page.
6. To test the operation, write the following command.

./ngrok http 8080

7. Take note of the highlighted URL and do not close the console.
   Note: ngrok will give you a random URL every time the command is entered. Do not close.

1. Create a Github repository
2. Set up your Jenkins connection
3. Go to Settings > Webhook > Add Webhook
4. In Payload URL, place your url as follow:

<your url>/github-webhook/. 
For example: http://e760c763.ngrok.io/github-webhook/

5. In Content type, select application/json
6. Leave the rest of the options as they are and click on Add WebHook
7. Check the console again and verify the connection

1. Select option “Manage Jenkins” > Manage Plugins
2. Select the Available tab and search “test-results-analyzer”
3. Mark the check Install y click “Install without restart”

1. Select the option “New Item” in the left menu
2. Enter a name, select “Freestyle Project” and click Ok
3. In the tab “General”, mark Github Project and write your repository url.

4. In the tab “Source Code Management”, select git and enter the url again.

5. In the tab “Build Trigger”, select the option “GitHub hook trigger for GITScm polling”
6. In the tab “Build”
   a. Select “Invoke Gradle script”
   b. Enter data as follow
   

7. In the tab “Post-build Actions”, enter data as follow.

8. Click Save.

1. Clone this repository: ContinuousIntegration
2. Open the project with Eclipse and verify the program and the test are running correctly.
3. Place the content in the repository created at step 1
4. Push to the repository
5. Review Jenkins and check a new build is running (lower left corner). The first build always takes more time, wait to the end and get the results.
6. When complete successfully, it will be marked in blue next to the build number. If it is marked in red, there are errors.

7. From the side menu, select "Test Results Analyzer” to get charts about the tests performed and save those charts.

After reviewing the code with the development team, a bug was found in one of the methods, although it does not show compilation errors and passes written tests, it is necessary to correct it to avoid further problems in the development process.

What you have to do:

1. Correct the error in isLess method in the correct relational operator, it should be only <
2. Upload changes to repository
3. Review the report obtained in Jenkins (save the graphics)

After review again, the error was corrected, but the Jenkins report indicates that not all tests have been passed successfully.
In addition, it was identified that missing test cases that have not been included and are necessary.
You should:

• Correct the necessary tests
• Add additional tests. There should be 6 tests in total, 3 for each method.
• Upload changes to repository
• Review Jenkins report (save charts)

1. Practice report with at least: cover, introduction, development, conclusions and recommendations, and references.
2. Answer these questions in the report:
   a. What is continuous integration?
   b. Why is it important and almost necessary?
   c. In what type of projects is it recommended to apply it?
   d. What would be the result of not doing the continuous integration of a project?
   Note: Do not include the questions, these are only a guide.
3. In the development of the report, include screens of the practice process. 6 graphs should be about the tests process (pie and bars for each build, the line graph is not necessary)
4. Include in the report the url of the repository where you did the practice.

╔════════════════════════════════════════════════════════════════════╦═══════╗
║ Description                                                        ║ Value ║
╠════════════════════════════════════════════════════════════════════╬═══════╣
║ Testing code (in the repository)                                   ║   50  ║
╠════════════════════════════════════════════════════════════════════╬═══════╣
║ Practice report                                                    ║   50  ║
╠════════════════════════════════════════════════════════════════════╬═══════╣
║ Penalty per hour or fraction of delay                              ║  -30  ║
╠════════════════════════════════════════════════════════════════════╬═══════╣
║ Penalty for not uploading required deliverables as specified       ║  -30  ║
╚════════════════════════════════════════════════════════════════════╩═══════╝

• 01 Amazon, «What is Continuous Integration?,»
• 02 P. Nguyen, «How to Install Jenkins on Windows»
• 03 E. Evans, «Installing Jenkins on Ubuntu 16.04»