Introduction to Subversion

Introduction to Subversion

Wendy Smoak Rob Richardson

Wendy Smoak

● Sr. Systems Analyst,

Arizona State University

– _{Web application development}

– _{Systems and database administration}

● Member, The Apache Software Foundation

– _{Struts, MyFaces, Shale, Maven}

– _{Infrastructure, release management, documentation}

● Contact me:

– _{[email protected]}

Rob Richardson

● Principal, Richardson & Sons

– _{Provides enterprise software development for small- to medium-sized}

businesses.

– _{Has created software applications raging from enterprise-scale}

applications to PDA-based systems, web applications to embedded database synchronization and postscript processing systems.

– _{Specializes in translating business requirements into technical}

solutions.

– _{Our business is listening to your needs and building you effective}

tools.

● My Qualifications

– _{Masters of Science in Computer Information Systems (MSCIS)} – _{Bachelors of Fine Arts in Industrial Design (BFA ID), the study of}

human factors and human / technology interaction

– _{Over 10 years of software development experience}

● Contact me:

What is source control?

● A central place to store your code

– _{Backup and recovery}

● Records a history of code changes

● Facilitates collaboration among development

team members

● Easy to check out prior code, undo changes,

How does source control work?

Import or Add Update Commit Check Out User1 Create Project User2 Working Copy User3 Working Copy The Repository

Why should I

use source control?

● Because the alternative is frightening beyond

all reason

● Some motivation:

“Well, I'd been working on the code, and got it to a state where I was prepared to share it. Then I thought I'd clean up the target directory and do a new build just to be sure. So I type rm -r *. But hold on, I'm not in the target directory, I'm in the project home directory, and I'd just deleted the entire project. Luckily I've got earlier versions lying around but I've lost a few hours work.”

What is Subversion?

● Free/open source version control system ● Replacement for CVS

– _{CVS was the de facto standard on Unix/Linux/BSD}

● Started and still partially funded by CollabNet ● Tracks changes in any type of file, not just

Tradeoffs

● Disk space

– _{Local control files require disk space}

● Control

– _{Must move and rename files through the tools}

● User Maintenance Time

– _{Users must be diligent in checking in and out}

Choosing a Subversion Client

● Command line

– _{Text commands, scriptable}

● Graphical

– _TortoiseSVN

● IDE Integration

● Browser-based viewers

Demo

Commit Messages

● Explain what the change does and why you

When to Commit

● When you've finished a feature

● Don't break the repository’s build

● Don’t diverge too far from the repository ● Be a good team player

● Work with your organization to develop

What to Commit:

If you can build it, don’t commit it

● Commit these: – _{Source files} – _{Saved database} info: ● stored procedures ● table definitions – _Resources ● Images ● resx files – _{Configuration files} – _{Build notes} – _{Test harnesses} ● Not these: – _{User files} ● *.suo ● *.csproj.user – _{Temp files}

● obj & bin folders ● Debug & Release

folders – _{Built files} ● *.dll, *.exe ● *.cab, *.tar ● *.jar, *.msi – _{The database} – _{Absolute path} references

Choosing a Subversion Client

● Command line – _{Text commands} – _{Shell scripts} ● Graphical – _TortoiseSVN

Each tool has the same functionality Choose the tool that

works for you

● IDE Integration – _{IntelliJ IDEA} – _Eclipse – _{Visual Studio} ● Browser- based Viewers – _ViewVC – _FishEye – _{Repo Browser}

IDE Integration

● IntelliJ IDEA ● Eclipse – _{http://subclipse.tigris.org/} ● Visual Studio – _{Ankh: http://ankhsvn.tigris.org/} – _{SvnLitePlugin:} ● http://cnicholson.net/content.php?id=61 – _{VisualSVN: http://www.visualsvn.com} – _{PushOK: http://www.pushok.com/soft_svn.php} – _{TortoiseSVN + VS.NET:} ● http://garrys-brain.blogspot.com/2006/10/tortoisesvn-vsnet-2005-good-stuff.html

Viewing the contents of a repo

● TortoiseSVN Repo Browser

● ViewVC

– _{formerly ViewCVS}

– _{http://www.viewvc.org/}

● FishEye

– _Cenqua

Demo

Repository Design

● Multiple repositories?

● Convention, for each project

– _trunk

– _branches – _tags

Creating a new repository

● TortoiseSVN “Create repository here”

● svnadmin at the command prompt ● Access the repository with file:// urls

Importing and Adding Code

● 'svn mkdir'

– _{Creates a directory}

● 'svn import'

– _{Imports the contents of a directory}

● 'svn add'

Demo

Create a repository and

import a project

Moving and Renaming Files

• Use the tools, commit changes

– 'svn move‘ – 'svn rename'

• Moving and renaming any other way will cause your working

copy to get out of sync with the repository

• To recover, undo your changes, then re-do with svn commands.

Removing and Reverting

● Nothing is ever truly gone

– _{Be careful what you add!}

– _{Possible to remove with dump, filter, load} – _{This is scary beyond measure}

● 'svn rm' or 'svn delete'

– _{Removes files from your working copy} – _{Will remove files in project from now on} – _{Will not remove the history of the file}

● (removing the file does not shrink repository)

● 'svn revert'

– _{Local “undo” command}

– _{svn revert . (current directory)}

Subversion as a Server

● file://

– _{OK for small applications} – _{Not truly client / server}

– _{File system must provide security}

● svn://

– _{True client-server access mechanism} – _{Run subversion as a windows service} – _{Can integrate with ssh}

● http:// or https://

– _{Apache httpd webserver}

– _{Subversion comes with mod_*_svn.so}

– _{Various Apache authentication modules available} – _{Apache can use with Windows authentication}

Starting svnserve

● svnserve --help (for options)

● As a Windows Service

– _{http://dark.clansoft.dk/~mbn/svnservice/SVNService.zip}

● As a daemon

– _{svnserve -d -r “c:\codecamp\repo”}

● Listens on port 3690 by default

– _{May need to configure firewall rules}

● Now check out project via svn://

Configuring svnserve

● Edit conf/svnserve.conf – _{anon-access = none} – _{auth-access = write} – _{password-db = passwd} – _{authz-db = authz}

● Add users and passwords to conf/passwd

– _{userid = topsecret}

● Add authorization rules to conf/authz

– _[/]

– _{userid = rw} – _{* =}

Other topics

● Properties

– _{svn:externals definitions} – _svn:ignore

– _{svn:eol-style}

● Converting repository to Subversion

– _cvs2svn – _vss2svn

Resources

● Subversion – _{http://subversion.tigris.org} ● TortoiseSVN – _{http://tortoisesvn.tigris.org} ● CollabNet – _{http://www.collab.net} ● Eric Sinc – _{http://software.ericsinc.com/scm/source-control.html} ● SVN 1-click Setup – _{http://svn1clicksetup.tigris.org/}

● Slides and Screenshots

Books

● Version Control with Subversion

– _{http://svnbook.red-bean.com}

● Practical Subversion (Garrett Rooney)

● Pragmatic Version Control using Subversion