ON THIS PAGE
we will show you how to build your Subversion repository using Team Foundation Server 2015 Update 1 or Visual Studio Team Services.
- You have a Team Foundation team project available on either Team Foundation Server 2015 Update 1 or with Team Services. If you don't, we encourage you to go through our Getting Started walkthrough. That walkthrough will show you how to create the accounts necessary for Team Services and where to get the DeepSpace code that you can check in to your Subversion repository.
- If you would rather use your own Subversion repository, you'll need the connection details for it and should be prepared to commit a change.
While all of the recent talk in the Java world about version control systems centers on Git, Subversion is still very much in use across the industry. In this walkthrough, we will show you how to build solutions from your Subversion repository.
Through this walkthrough, we will use some sample code written in Java and AngularJS. The project is called DeepSpace. All of our instructions in the walkthrough pages and screenshots will assume you are using this same sample code, but would also apply if you had your own code (with names changed appropriately). Our project will be stored in a Subversion repository.
Following the instructions below, you will build a Java project (create a WAR file) using Maven. We will lead you through the steps to: 1) Create a new build definition that uses code in a Subversion repository; 2) Add a build step to run Maven; 3) Configure the Maven build options; 4) Set up continuous integration for the project; 5) Queue a manual build of the project; and 6) Commit a change to the Subversion repository and get a continuous integration build via polling.
Create a new Build Definition
From within your team project, click on the Build menu option at the top left of the webpage. Now let's create the build definition we'll use to build the DeepSpace solution stored in our Subversion repository.
Click the green
+ sign in the left build pane (appears above the build definitions list). Once you click, the "Create New Build Definition" dialog will appear. In that dialog,
select the "Empty" build template (at the bottom of the list) and click
Add the Maven build task
Next, add a new build step by clicking
Add build step under the "Definitions" window.
Add Tasks window will appear. Within this window, select
Maven (Build with Apache Maven), click the
Add button associated with Maven,
and then click
Close (as shown in the image below).
Configure the Maven build
Once you have created the new build definition with the single build step for Maven, you need to configure one of the Maven options.
Maven POM file text box, enter "pom.xml" (without the double-quotes).
This should be the only option you need to configure.
Choose Subversion as the Repository type
Click on the
Repository tab and change the Repository type to "Subversion". Notice that the Connection property requires a value which is indicated by the background color of the textbox
changing to yellow. This is the name of the Connection (or "Service Endpoint") that will be used to connect to the Subversion repository.
To create the necessary endpoint, click the
Manage link. This will open the services administration page for the team project.
+ New Service Endpoint in the left pane and choose "Subversion" from the dropdown list. Once you click, the "Add New Subversion Repository Connection" dialog will appear.
Enter the friendly name you wish to use for this connection. The name should be unique in the list of connect services and something easy to remember (e.g, "Subversion - DeepSpace"). Next,
enter the Server URL, User name and Password used to connect to the desired Subversion repository. Click
Go ahead and close the services administration web page to get back to the build definition. Now that you're back on the Repository tab, click the
Refresh button next to the Manage link.
Once you do, the Connection property will be populated with the "Subversion - DeepSpace" value. If you have more than one value in the Connection drop down, ensure that you select
the one pointing to the Subversion repository. When complete, your repository tab should look similar to the image below.
Optional: Add Mappings
If you are using your own repository (and not the DeepSpace repository), you can optionally add mappings which define the server-side folders that will be checked out on the build machine. This allows you to only bring down the necessary code to build a portion of the repository. If you do not add any mappings, the entire Subversion repository will be downloaded (and this is what we will do for the DeepSpace project).
If you do add mappings for your repository, you will need to provide the Server path (the path in the Subversion repository), a Local path (a relative path for mapping the solution on the build agent), the Revision you want to pull from that path, the Depth (Empty, Files, Children or Infinity) and whether to Ignore externals.
Enable Continuous Integration and Scheduled Triggers
Next, click on the
Triggers tab. If you selected the Continuous integration checkbox during the creation of the build definition, the Triggers tab should look like the image below. If
it does not, go ahead and select the
Continuous integration (CI) checkbox now. For the purposes of this walkthrough, set the "Polling interval (seconds)" to 60 seconds. Also, if you'd like,
check the box next to
Scheduled and select a date+time period you'd like a build to start.
Save the definition by clicking the
Save button. Give the definition a name like "DeepSpace.Svn.CI".
Queue a Manual Build
Now that you have created a build definition, let's manually queue our first build of the project. Click on the
Queue build... menu option under
your "DeepSpace.Svn.CI" build definition. This will display a window titled
Queue Build For DeepSpace.Svn.CI giving you an option to pick a build
queue to use (for now, leave this as the default). Click
OK. A build progress
Console window will
appear and will reflect the output of the Maven build task (you will see that the code is being pulled from the Subversion repository). The build can
take a few seconds to a minute to begin and may last a few minutes. You will know the build is complete when a green bar is displayed
showing "Build Succeeded" as in the image below.
Commit a change to the Subversion repository
Now that the manual build has completed, let's ensure that the polling trigger can identify our changes and build them automatically. On a development machine with the Subversion client tools, check out the DeepSpace repo (or your own) so you can make a change. If you're using the DeepSpace repository, update the "src/main/webapp/js/directivesFlyingStars.js" file by uncommenting line 44 to show the slider for the star count. If you're using your own repository, make some change in that source. Commit the change and provide a commit message. After the change has been committed, the polling trigger will detect the changes in the repository and queue a build.
Here's what the build queued via polling will look like in the build queue:
The image below shows the four builds that were run during this walkthrough.
Build 12 was the manual build we ran in the previous step. Build 13 is the initial build performed by the polling trigger (the polling trigger ran and found that it needed to queue a build). Build 15 is the build performed by the polling trigger when it detected the commit we made during this step (Source Version is 5). Finally, Build 16 was the scheduled build we set up in a previous step.
Congratulations! You've successfully created a build definition that polls for changes in a Subversion repository and queues a build for those changes.
If you want to see a video of this walkthrough, have a look at the "Build code in a Subversion repository with Visual Studio Team Services" video on our JavaALM YouTube channel.
Frequently Asked Questions (FAQ)
Q: What does the value of "Default branch or tag" represent?
A: You can change this value to build a default branch (or tag) in your Subversion repository with this build definition. For instance, if you want to create a Release build definition to build a “branches/releases/v14.0” branch, you would set the value of “Default branch or tag” to “branches/releases/v14.0”.
Q: What does "Batch changes" do? And what if I uncheck it?
A: When "Batch changes" is enabled, a build will be queued for the latest source in the repository whenever a commit occurs. Let's assume that while a batched build is running, three commits are made to the repository. When that batched build completes, another build will be queued containing those three commits. In this scenario, if "Batch changes" is unchecked, each of those three commits will be built individually (this is also known as an "Individual CI" build).
Q: What are the valid values for the polling interval?
A: The minimum polling interval is 60 seconds. The maximum is 86,400. If you need an interval larger than that, a Scheduled build is what you want.
Q: Can I use the Subversion support with a hosted provider?
A: Yes. When you set up the Subversion endpoint, simply use the URL of your hosted repository and provide the proper credentials.
Q: Where can I learn more about the new build system?
A: Check out the documentation for the new build system. You can also view the "New Team Build in Team Foundation Server 2015 & Visual Studio Team Services" video on YouTube.
Q: How do I hear about new releases?
A: Choose your favorite social media site on the Contact Us page and look for new announcements there.