Build and deploy a Java project with Eclipse and Azure DevOps Services

2019-05-13

TFS 2018 | TFS 2017

In this exercise, you are going to see a typical end-to-end workflow for a Java developer using Eclipse. You should have completed the labs that set up automated build and release (this is a CI/CD pipeline).

In this scenario, you will open the running MyShuttle application and discover a bug. You will then use the Exploratory Testing extension to create a Bug work item in Azure DevOps Services. You will then branch the code for fixing the bug. Once the bug is fixed on the branch, you will merge the code in via a Pull Request and code review. This will then automatically queue the build/release pipeline and your fix will be deployed.

Note

These Hands-On Labs use a virtual machine with a Java environment configured by our partner, Northwest Cadence.

Learn how to connect to the Java VM environment here.

Prerequisites

This exercise assumes you have completed the exercises to create a Team Project and have set up the Docker private Azure DevOps Services agent. You should also have completed the labs to set up an automated build for both the MyShuttleCalc and the MyShuttle2 repos. You should also have complete the release management lab. This exercise uses a team project named jdev, though your team project name may differ.

Note

The Team Explorer Everywhere plugin works with Eclipse versions 4.2 (Juno) - 4.6 (Neon).

Install the Exploratory Testing Extension for Chrome

In this task you will install the Exploratory Testing extension into Chrome.

Open chrome and navigate to https://chrome.google.com/webstore. Enter "exploratory testing" into the search box. Find the "Test & Feedback" extension from Microsoft Corporation and click "Add to Chrome". Click Install in the dialog.
Once installed, a beaker icon appears in the top right of the Chrome toolbar. Click it to open the UI.
Click on the gear icon to open the settings. Select "Connected" and enter your organization URL and click Next.
Select your team project and expand it and select the default team (which should have the same name as your team project). Click Save.

Note

Your team name may be different

Configure Branch Policies

In this task you will enforce quality on the main branch by creating branch policies.

In Chrome, connect to your Azure DevOps Services Team Project. Click on Code to open the Code Hub.
Click the Repo dropdown and select "Manage Repositories".
In the tree, expand the MyShuttle2 repo and click on the main branch. Click the Branch Policies tab.
Check the Protect this branch checkbox.
Check "Check for linked work items" and set the radio to required.
Under Build validation, click Add build policy. Select MyShuttle2 from the list of build pipelines and click Save.

Note

You can enforce other policy options like comment resolution and minimum number of reviewers, as well as specify the merge options (like squashing). You can also add default reviewers.

Log a Bug using the Exploratory Test Extension

In this task you will start a test session, discover a bug in the MyShuttle app and log it to Azure DevOps Services.

In the Test extension toolbar of the Exploratory Test extension, click the Play icon to start a testing session.

Note

The test extension is now recording all of your interactions. You can see the test icon beaker has a green dot indicating that a session is currently running.
Enter https://localhost:8081/myshuttledev in the toolbar to navigate to the application. Enter fred for the username and fredpassword for the password and click Log In.
On the Dashboard page, click "Access Your Fare History" to navigate to the fare history page.
If you look at the totals for the Fare and Driver column in the table, you will note that the total for the driver column is incorrect.
Click the Test Extension beaker icon and click the Camera icon (capture image).
Capture the grid with the incorrect total. Annotate the image appropriately and click the tick (accept) icon.
Click the Test Extension beaker icon and click flyout (lower right) of the icon with the page and exclamation mark (new bug). From the menu click Create bug.
In the title box, enter "Driver total incorrect" and click Save.

Note

All the pages visited, notes, screenshots and other information from the test session is included as details for the Bug, so you don't have to add these details manually. You also should see a button next to the title box reading "0 Similar". Azure DevOps Services checks to see if there are bugs already logged with similar titles, therefore minimizing duplicate bugs being logged.
Once the bug has been created, click the Stop button in the Test Extension toolbar to end the test session.
Navigate to your Azure DevOps Services team project. Click Work to navigate to the Work Hub. In the toolbar, enter "driver" into the Search Work Items box and press enter or click the magnifying glass icon.
You should see the Bug that you logged. Take a moment to look at the Repro Steps.
Assign the Bug to yourself and change the state to Active. Click Save.

Fix the Bug

In this task you will create a branch of the code to fix the Bug. You will then checkout the branch, fix the bug and commit the code. You will then create a Pull Request to merge the fix into main and see that this triggers the CI/CD pipeline to automatically deploy the fix to the dev environment.

Note: Use the personal access token (PAT) generated from the "Set up a Docker Build" lab that should be located at: home/vmadmin/pat.txt. Otherwise, follow the instructions from that lab again to generate a new PAT.

Open Eclipse if it is not already open. Open the MyShuttle2 project.
In Team Explorer change the drop down to "Work Items". If the dropdown does not show work items connect to your organization via the Team Explorer Home page.
If there are no queries saved in Azure DevOps Services, a query can be created in Eclipse (but not saved at this time). Right-click on the My Queries folder and select "New Query."
Run an existing query by double clicking it to find the bug. Or, right click in the New Query panel and select "Run Query." The output of the query will show the bug. Note the ID value of the bug.

Note

If you do not see the bug, ensure that it is assigned to you, since by default only work items assigned to you will appear in the work item list.
Create a new branch
In the dialog, change the branch name to "totalsBug" and click Create.
In the project view of Eclipse, browse to src/main/java/com.microsoft.example.servlet and open the LoginServlet class.
Around line 35, you will see what is causing the bug: the totalDriverFee is being calculated but the driverFeeTotal session attribute is being set to totalFareForDriver (this looks like a classic copy/paste error).

Change this line of code:
```
    session.setAttribute("driverFeeTotal", totalFareForDriver);
```
to
```
    session.setAttribute("driverFeeTotal", totalDriverFee);
```
Commit your changes by right clicking the file and selecting Team->Commit. Enter "Fixing totals bug #{ID of bug}" as the commit message. By putting the # symbol followed by an ID of a work item in a commit message, Azure DevOps Services will automatically associate the work item with the commit when it's pushed to Azure DevOps Services. In the example of the screenshot, the ID is #698. Click "Commit and Push" to push the changes to Azure DevOps Services.
If a window pops up that prompts for credentials, use the following values:

Name Value

User _Azure DevOps Services_Code_Access_Token

Password {PAT that you copied earlier}

In the Push commits dialog click the Push button.
Now that the fix has been pushed to Azure DevOps Services on a branch, you can create a Pull Request. This will be done in Azure DevOps Services following the standard process for pull requests. Under the Code hub, click on Files in the MyShuttle2 repo and there should be a notification that you updated the totalsBug branch. Click the link next to it, "Create a pull request."
Then, in the pull request panel, click "Create" to create the pull request. Note that the bug is associated with the commit.
Once the PR has been created, right-click it in the PR list and click Open in Browser. You should see that the build is running (this is the build mandated by the Branch Policy you set up earlier).

Note

If there was a merge conflict, Azure DevOps Services would warn you on the overview page. If there is no warning to this effect, then Git will be able to auto-merge the PR into the target branch.

Note

You configured the release to only trigger when successful builds off the main branch are available. Since this build is not building from the main branch, these changes will not yet be deployed.
Click on the Files tab to open the file compare. Note the changes.

Note

You can comment on code or files in the PR and have conversations with the team throughout the review process.
Click Approve to approve the PR.
Now that the policies have been fulfilled, you can complete the PR which will merge the changes into main (the target branch). Click Complete to do the merge.
In the dialog, accept the defaults and click Complete merge.
The PR completion triggers a new build off the main branch, which in turn will trigger a release. It also transitions the Bug work item to Resolved.
Click on Builds to watch your build. When the build completes, you will see the unit test and code coverage results as well as SonarQube analysis and quality gates (if you have configured SonarQube integration).
Click on Releases and open the latest release which should have triggered off the PR merge build completion event.
On the Release Summary page, you will see the linked Bug work item.
Click on commits to see the incoming commits for this release. There is the commit to fix the bug as well as the commit to merge into main.
Click on the Tests tab to see the test results. The UI tests should be passing.
Open the MyShuttle2 app by navigating to https://localhost:8081/myshuttledev. Log in again and verify that the totals column is correct and the Bug has been fixed.