Getting Started with Mergento

Mergento is a tool for software developers to manage their code. Developers can use Subversion, Git, or Bazaar to commit or push code to the mergento servers. You can also track bugs and collaborate with other developers on your team.

  • register for an account
  • create a repository to store your code on our servers
  • upload your code using Subversion, Git, or Bazaar tools
  • add users to upload and manage code for your projects

Working with Subversion

Subversion is a very popular source control management tool that was created to replace CVS. It is very easy to use and has a number of client applications for almost all operating systems.

Install Subversion

  • Download the subversion client.
  • Follow the installation instructions for your operating system.

Create and checkout a repository

  • Login to Mergento.com and create your Subversion repository.
  • On the command line run: svn co http://svn.mergento.com/yourusername/yoursvnrepo (you can also select checkout in any of the GUI applications) and enter your username and password you created on Mergento.
  • Copy your code to the newly created working copy of "yoursvnrepo" on your workstation.

Commit to your repository

  • Make changes to the files in your local working copy
  • On the command line run: svn ci -m "added the Twitter widget"

Working with Git

Git is gaining a lot a lot of ground among developers based on it ease of use and distributed architecture. It is developed and maintained by the Linux Kernel group.

Install Git

  • Download git.
  • Follow the installation instructions for your operating system.

Create and clone a repository

  • Login to Mergento.com and create your git repository.
  • Open a terminal window and run: git clone git+ssh://git@git.mergento.com/yourusername/yourgitrepo.git

Push up to your repository

  • Make changes to the files in your local repository
  • Open a terminal window and run: git add .
  • Then run: git commit -m "added the Twitter widget"
  • Then run: git push

Working with Bazaar

Bazaar is a very powerful source code management tool created by the fine folks at Ubuntu. Like Git, Bazaar is a distributed SCM and also shares a lot of the same commands as Git - which makes it easy to move between the two different tools.

Install Bazaar

  • Download Bazaar.
  • Follow the installation instructions for your operating system.

Create and branch a repository

  • Login to Mergento.com and create your Bazaar repository.
  • Open a terminal window and run: bzr branch bzr+ssh://bzr@bzr.mergento.com/yourusername/yourgitrepo

Push up to your repository

  • Make changes to the files in your local repository
  • Open a terminal window and run: bzr add .
  • Then run: bzr commit -m "added the Twitter widget"
  • Then run: bzr push bzr+ssh://bzr@bzr.mergento.com/yourusername/yourgitrepo (after the first push your can run: bzr push)

Bug Tracking with Trac

All application have bugs. Managing those bugs is crucial and lets your users know that you are serious about their security and the maintenance of you application.

Create your Trac project

  • If your account supports bug tracking, click on the repository name on the list repos page
  • click on the enable Trac button

Create users

  • Any users created in Mergento will have access to the Trac page
  • Each user will need to login to the Trac page for additional functionality
  • You can modify the users permissions on the Admin:Permissions page

Post-commit callbacks

Post-commit callbacks give you the ability to perform a function every time a commit or push had been made by any of your developers. A simple example would be sending an email every time a commit was made to your subversion repository.

Create a callback

  • Create a script that parses POST data and performs some action like sends an email, updates a remote repository, etc.
  • Put the script on a publicly accesible webserver

Enable callback for your repository

  • Click on the repository name on the list repos page
  • Type in the URL for your callback script and click update
  • Now the next time you commit or push to this repository, we will POST the following data to your script:
  • Array ('reponame'=>'somereponame', 'newrev'=>'34', 'oldrev'=>'33', 'repotype'=>'bzr')