03 January 2017
We should seek excellence in our jobs, doesn’t matter our line of work. As professionals, we should always aim to improve the quality of our outputs, either it is customer satisfaction, code quality or just faster builds and deployments.
As any developer knows, working with a Version Control System (VCS) is great, but it has some pain points. As an example, if you are working in a product framework and you have lots of branches, it’s complicated to do cross-branch searches with parameters like commit comments, authors and time. Plus we have a strict rule of code reviews (what we call the 4 eyes rule) to assess the code standards and the implementation itself. The code review comments are on our ticket system, disconnected from the VCS (I know there are integrated systems, but for business reasons the products do not interact as we like).
To close this gap, improving the developers’ performance, we did research for useful tools that can help us. The frontrunner was UpSource from JetBrains. UpSource supports most of the VCS, giving some cool visualisations, allowing us to do the code reviews and last but not the least provide us with a full range of searches over the code branches.
Before buying the license, we set up the free version of UpSource, and using Continuous Improvements techniques we start an experiment with of our development teams.
To configure UpSource (version 3.5.3597) we:
In the bash command line for the VM we:
yum -y update
yum install net-tools
yum install wget
yum install unzip
unzip upsource-3.5.3597.zip -d /usr/local
shutdown -r now
hostnameclt set-hostname my_machine_name
firewall-cmd --zone=public --add-port=8080/tcp --permanent
Using a browser we:
And at this point, we hit a roadblock… The certificate use by the VCS is self-signed. To fix it, we applied the following recipe:
And UpSource started to get all the information of the configured branches. :)
As a security measure, we enabled HTTPS following these instructions. We close the shop, go home, take a good rest and start using it in the next day, using the rules agreed between the teams’ technical leads.
After a week of usage, we start to see the benefits. We can search the code and the reviews in a faster way, leveraging the index system of UpSource. Plus we have visualisations that help us to identify what are the commits without reviews. In one particular situation, we found one optimisation broke our verifications in one of the plugins. Due to the search and comparison capabilities of UpSource, we cross-reference between different branches, identifying the bug and fixing it in a matter of minutes. If we use the tools provided by the VCS it will take a couple of hours to do the same job.
Our plan is to keep the experience with the team, refining the development process, since we change the way of doing code reviews. So far, we like the tool, and we are looking for the integration with Visual Studio. After we agree and settle on the process, we will roll out to all the development teams within the company.