This post is from the CollabNet VersionOne blog and has not been updated since the original publish date.
Quickstart Guide: Version Control With Codesion
Whether you are completely new to Codesion, or have recently migrated from our legacy (V3) platform, setting up your account will only take a few minutes if you follow these easy steps:
1. Plan your attack. Who will be responsible for managing your Codesion Subversion repositories, Trac and Bugzilla instances? How many users will need access? How many projects are you working on? Do you have updated repository dump files to upload?
2. Familiarize yourself with Codesion architecture. Codesion has developed its own project-based approach for provisioning and configuring multiple services:
- Codesion Project – Our central concept- a place where you add users, provision per-project repositories, and configure role-based permissions, security controls, and service settings
- Subversion repositories: Add a Subversion repository to a Codesion project, then assign permissions down to the subdirectory level. Depending on your hosting plan, you can create unlimited Codesio projects and SVN repositories. Refer to Redbean for some repository organization insights.
- Subversion access URLs: SVN access URLs take the form svn.codesion.com/project1, svn.codesion.com/project2, etc. The Codesion backup system is highly granular, allowing one to access individual SVN backups at the project level.
- CVS repositories: The overall CVSRoot (‘instance’) sits at the account level, and you can add CVS modules at the Codesion project level. Unlike SVN, one cannot assign subdirectory-level permissions in CVS. You will need to create separate Codesion projects to restrict user access to your CVS modules. CVS backups are available on per-project basis.
- Trac/Bugzilla: Assign access controls at the Codesion Project level, then manipulate Trac-specific permissions within Trac.
3. Log in to your Codesion Dashboard and familiarize yourself with the environment:
- Menu Items – Quickly navigate to your Projects, Users, Service Settings, and System Logs
- Account Quickview– Shortcuts to common functions and recently accessed projects, people, or commands
- Log Tracking – Simple visual representation of the ten most active SVN committers in recent days/weeks/month
- Activity Feed– Live feed of recent Subversion commit log messages committed by your teammates
- Personal Settings– Edit email notification settings, passwords, marketing preferences; change, pay for, or cancel your plan in Billing (Admin only); submit a support ticket in “Help”
4. Create Your First Project. The Codesion Project is the fundamental component of your Codesion account.
To add a Project, you can either:
- Click “Create Projects” in your Dashboard Quickstart window, or
- Select “Projects > New”
The “Project Name” is the project’s official title and appears on the Project Dashboard. The “System Name” is a shortcut and is included in access URLs. After selecting “OK”, a new Project Dashboard will be created.
5. Customize your Project Dashboard. You can upload your logo, add a project description, and add people and services from your Project Dashboard.
6. Add Services (SVN, Trac, Bugzilla). Provision a fully backed up online Subversion repository and/or Trac instance in seconds!
Add hosted services (left column, above) or select your favorite externally-installed tools like Basecamp or Fogbugz (right column, above). These external commit integrations with SVN allow you to close or comment on stories or tickets from Subversion. You can also easily upload SVN repositories into Codesion.
7. Add Users and Groups. Next, you need to add your teammates or account users, and optionally add them into groups (e.g. “Developers” or “Collaborators”), in order to easily share projects and control access privileges.
8. Assign Project Permissions. Having added your users into Codesion, the next step is to share your files and folders. Navigate to the Project Dashboard page. Each Service has “Per Service Permissions”, which allow you to grant access at a high-level.
The Codesion Subversion Access Control List (ACL) editor makes complex ACLs easy to set up. Select the “ACL Editor”, which can be found under “Services | Subversion”. Using the image above:
- Select a directory that you wish to share
- Note that access rules are inherited from higher-level permissions (e.g. by default, a user with access rights to a directory has right to all subdirectories)
- Click “Add User” or “Add Security Group”, select your desired users, then grant access levels (read/write, read only, etc.)
- To see the Codesion-generated User Permissions (ACL) for a specified directory, click “Show”. Select “OK” when done.
9. Launch your Service and start work! Use the Project Quickview window to grab your online SVN repository URL, or to Quicklaunch Trac or Bugzilla.
Stay tuned for best practices around setting up your version control repositories or issue tracking systems. In the mean time, learn more about Codesion Pricing, or about:
Please add relevant comments or suggestions below!