A User's Guide To Moves

Overview

Moves is Education Systems' tool for managing releases and for deploying applications to the Test, QA, and Production environments. It is closely integrated with the Maven build tool and the MIT Maven repository (maven.mit.edu). The URL for Moves (in production) is:

...

The Moves home page looks like this:

Standard Workflow

For a new application that is under development, Moves comes into the picture the first time a deployment to Test is needed. This is the first time an actual version number (minus the snapshot designation) is assigned to the application.

[Note that prior to this stage, builds and deployments to the Development environment are handled by the continuous integration server, Bamboo at build.mit.edu.]

To perform the build, you will first go to Moves (https://moves.mit.edu/) and choose the "Build a Release" option from the home page. This option will, when complete, do the following:

• Check out the code from the head of the trunk
• Replace the version numbers in Moves' working copy of the pom.xml file for the app and dependent components like CSF.
• Build the application
• Run the unit tests
• Package the application into a war or jar file, tagged with the version number
• Deploy the packaged application (jar or war) to the MIT Maven repository (https://maven.mit.edu)
• Commit a tag to the app's SVN repository, labeled with the release version number (tags/releases/x.x.x). The pom file in this tag will contain the release version number, and the actual released versions of dependent components like CSF that were used for the build
• Increment the snapshot version number in the pom file and commit that change to the trunk

The top-level menu items are:

• Home
• Workflows
• Administration
• Help

Access to many links in the application are restricted based on the user's authorizations. So some users may not see, for example, the Administration link.

Home

This link simply returns you to the home page (see above).

Workflows

This page shows a list of workflows that have been executed, or are currently in progress. Clicking on a particular workflow will show more detail about the workflow's execution: the original request, the log entries generated by the workflow execution (including the full Maven log), and the workflow history. The detailed information here is valuable when diagnosing a failed workflow.

Administration

This is the entry page for the administration of the Moves application overall, and the configuration of the individual application builds and deployments.

The administrative functions are detailed under "Administering Moves".

 Developers must then update their own working copies of the app to receive the pom file updates.