Subversion (SVN) is a software control system used by developers to manage source code and files and collaborate with others on the same file at the same time. In Subversion, files are stored in a repository where you can view and track a file’s change history and compare versions to see what was changed.
In this overview, we’ll go over:
- Enabling Subversion
- Creating a repository
- Using an external repository
- Exporting a repository
Enabling Subversion
You must be an admin or project admin to enable Subversion:
- Go to the project settings.
- Select “General.”
- Check the “Enable Subversion” box.
- Select “Save.”
Once enabled, you can view and manage Subversion settings by going to Project settings > Subversion. In the settings, you can disable Subversion, which deletes all info in the repository.
Backlog uses Subversion 1.8, and you’ll get an incompatibility error if you commit from other versions of the client application. Upgrade your Subversion clients if you use more than one (e.g., TortoiseSVN, SmartSVN).
Creating a repository
To create a repository, select Subversion > Create a repository on Backlog > Submit. When you create a repository, the URL is formatted as: https://[Space ID].backlog.com/svn/[Project key].
Selecting the “React on issue reference and keyword commit log” box means referenced issues get a new comment linking to the version.
To access the repository, enter your Backlog login info. If you’re using two-factor authentication, enter the special password generated in your Backlog personal settings. Users with guest roles can’t access Subversion.
Using an external a repository
Link your company’s existing Subversion repository to Backlog to view revision information and commit logs using HTTP or HTTPS access. To link an external repository:
- Go to the subversion settings.
- Select “Use external repository.”
- Input the required information.
- Select “Submit.”
External repository linking is available to users with the Standard plan or higher. Using an external repository means revision information is acquired through a network connection, causing a lag in when information is shown.
Exporting a repository
You can export Subversion repositories with the svnsync command. For example, for Linux OS:
#! / bin / bash
#
# Script to svnsync "Backlog" project repository.
#
if [$ # -ne 2]; then
echo "Usage: $ 0 [space key] [project key]"
exit 1;
fi
SPACE_KEY = $ 1
PROJECT_KEY = $ 2
cwd = `pwd`
hook_revprop = $ {PROJECT_KEY} / hooks / pre-revprop-change
svnadmin create $ PROJECT_KEY
echo'#! / Bin / sh'> $ hook_revprop
echo'exit 0'>> $ hook_revprop
chmod + x $ hook_revprop
svnsync init file: // $ {cwd} / $ {PROJECT_KEY} https: // $ {SPACE_KEY} .backlog.jp/svn/${PROJECT_KEY}
svnsync sync file: // $ {cwd} / $ {PROJECT_KEY}