SWGANH Git - Revision history

Schmunzel: /* Configure Git and Checkout SWG:ANH Projects */

2010-05-20T10:34:00Z

‎Configure Git and Checkout SWG:ANH Projects

Sostrata: /* Git Setup Guide */

2010-04-07T03:23:54Z

‎Git Setup Guide

Apathy: /* Configure Git and Checkout SWG:ANH Projects */

2010-04-06T16:01:58Z

‎Configure Git and Checkout SWG:ANH Projects

Apathy: /* Installing the PuTTY Suite */

2010-04-06T15:53:25Z

‎Installing the PuTTY Suite

Apathy at 15:52, 6 April 2010

2010-04-06T15:52:01Z

Apathy at 03:05, 27 March 2010

2010-03-27T03:05:50Z

Apathy at 02:51, 27 March 2010

2010-03-27T02:51:43Z

Apathy at 02:25, 27 March 2010

2010-03-27T02:25:47Z

Apathy: New page: = Git Setup Guide = Git is a & open source, distributed version control system designed to handle everything from small to very large projects with speed and efficiency. - http://www.git-s...

2010-03-26T22:12:09Z

New page: = Git Setup Guide = Git is a & open source, distributed version control system designed to handle everything from small to very large projects with speed and efficiency. - http://www.git-s...

New page

= Git Setup Guide =
Git is a & open source, distributed version control system designed to handle everything from small to very large projects with speed and efficiency. - http://www.git-scm.com/

Over the years the SWG:ANH source has evolved into a massive project both in scope and in terms of number of lines of code, which at last count numbered over 145,000 lines. Up to March 2010 the SWG:ANH project used Subversion as it’s version control system, however, with the source base being the size that it is normal day-to-day tasks such as log lookups and branching/merging were a cumbersome chore. With this in mind the decision was made to switch to an alternative version control system better suited to the task.

Historically, support for Git on Windows was only possible using cygwin however, over the past few years support has improved greatly through projects like msysgit and TortoiseGit. The following guide will walk you through installing Git and configuring for use with SWG:ANH projects.

== Installing Git on Windows ==
To begin download the latest Git installer from the msysgit project site:
[http://code.google.com/p/msysgit/]

At the time of this writing the latest version is Git-1.7.0.2-preview20100309.exe.

Follow the guided installation and select the default options for the Destination Location, Component Selection, and Start Menu Folder pages. When you get to the '''Adjusting your PATH environment''' page select the “'''Run Git from the Windows Command Prompt'''” option as shown below and continue.

IMAGE PLACEHOLDER

On the following page select “'''Checkout Windows-style, commit Unix-style line endings'''.”

IMAGE PLACEHOLDER

The installer will then copy all the necessary files and finish up. Now you’re ready to configure your Git environment for use with the SWG:ANH project.

== Generating an SSH Key ==
In order to authenticate with the SWG:ANH Git repository you will first need to set up an SSH key. To do this open the Git Bash shortcut located on your Desktop or from the Start Menu in the Git folder.

From the command prompt enter the following to start off the generation of your SSH key. Be sure to use your swganh.org email address to generate the key! '''NOTE: If you have not been assigned a swganh.org account yet, see Snow to get one set up.'''

<code>
ssh-keygen -C "yournick@swganh.org" -t rsa
</code>

Once you’ve run the above command you will be asked to select a name for the SSH key, simply hit enter to select the default, id_rsa. You will then be asked to optionally enter (and re-enter) a password. '''NOTE: Do not forget the password if you set one here, you will need it when performing operations on the remote repository.'''

In your Windows user directory you will now have a folder labeled .ssh with the SSH key files like the following:

IMAGE PLACEHOLDER

Open the id_rsa.pub file and copy the contents into an email or private message to Snow who will enable your access on the Git repository server. That’s it for the SSH key setup, you’re now ready to clone your first SWG:ANH project!

== Configure Git and Checkout SWG:ANH Projects ==
Now you’re ready to configure Git and checkout the MMOServer and MMOServerDB projects which are the heart of the SWG:ANH server. First open a command prompt and navigate to the directory where you want to checkout the projects into, for windows Vista/7 users you can Shift+Right Click on a directory to bring up the '''Open command window here''' option.

Once you have the command window open at the location you want enter the following two commands to configure Git to identify yourself correctly with the SWG:ANH Git Repository.

<code>
git config --global user.name "yournick"
git config --global user.email "yournick@swganh.org"
</code>

With your configuration set you’re now ready to check out the MMOServer project with the following command:

<code>
git clone swganh@git.swganh.org:mmoserver.git
</code>

The first time that you check out a project from the SWG:ANH Git Repository you receive a message asking you if you wish to continue connecting, simply enter yes to continue. You will also be asked to enter the passphrase that you selected when setting up your SSH key at this point, enter it to continue checking out the source. The initial clone will take a minute or two to complete, albeit much faster than the SVN checkouts use to take!

Once the MMOServer clone has finished it’s time to do the same for the MMOServerDB project. Enter the following command for that:

<code>
git clone swganh@git.swganh.org:mmoserverdb.git
</code>

After the MMOServerDB project has been cloned you’re now ready to start working on the project! For those who are coming over from SVN and are not comfortable working with the command line on a regular basis read on to the next chapter on setting up TortoiseGit, the TortoiseSVN alternative for Git projects.

@@ Line 63: / Line 63: @@
 <code>
-  git clone swganh@git.swganh.org:mmoserver.git
+  git clone git@github.com:mmoserver.git
 </code>
@@ Line 77: / Line 77: @@
 <code>
-  git clone swganh@git.swganh.org:mmoserverdb.git
+  git clone git@github.com:mmoserverdb.git
 </code>

@@ Line 24: / Line 24: @@
 Right click on the Pageant icon and choose New Session, this will bring up the PuTTY configuration window which should be filled out as below.
--- INSERT IMAGE --
+[[Image:Putty1.PNG]]
 Here the Host Name section is filled in with the repository address and a name is given to the Session in the Saved Sessions area. Once these two fields have been set hit the Save button to save the Session and then hit Open to make a new connection to the repository. When connecting the first time a Security Alert will pop up notifying that that the host's key is not in the registry, this is expected so hit Yes.
--- INSERT IMAGE --
+[[Image:Putty2.PNG]]
 Another failure message will pop up after this, simply ignore it and close the putty session. SSH is now configured and ready for use.

@@ Line 14: / Line 14: @@
 Follow the guided installation and select the default options for the Destination Location, Component Selection, and Start Menu Folder pages. When you get to the '''Adjusting your PATH environment''' page select the “'''Run Git from the Windows Command Prompt'''” option as shown below and continue.
-IMAGE PLACEHOLDER
+[[Image:Git1.png]]
 On the following page select “'''Checkout Windows-style, commit Unix-style line endings'''.”
-IMAGE PLACEHOLDER
+[[Image:Git2.png]]
 The installer will then copy all the necessary files and finish up. Now you’re ready to configure your Git environment for use with the SWG:ANH project.
@@ Line 35: / Line 35: @@
 In your Windows user directory you will now have a folder labeled .ssh with the SSH key files like the following:
-IMAGE PLACEHOLDER
+[[Image:Git3.png]]
 Open the id_rsa.pub file and copy the contents into an email or private message to Snow who will enable your access on the Git repository server. That’s it for the SSH key setup, you’re now ready to clone your first SWG:ANH project!
@@ Line 70: / Line 70: @@
 When running the installer you’re safe to select the default values until you reach the Choose SSH Client page, there you will need to select the “'''TortoisePLink, coming from Putty, which does better integrate with Windows'''” option as shown below.
-IMAGE PLACEHOLDER
+[[Image:Git4.png]]
 Allow the installer to finish and then restart your PC when prompted.
@@ Line 78: / Line 78: @@
 Using SSH keys means entering a password on a regular basis. Most unix based operating systems support a feature natively called a "keychain", however, this isn't the case for Windows which is the most common development platform at SWG:ANH. To ease the pain of dealing with SSH keys you will use a tool called Pageant to manage the keys and use them as needed. Before we can do that though we need to first convert our existing key to the Putty format.
-To convert your SSH key to Putty format go to the Start Menu and under the TortoiseGit folder there will be a Puttygen application, select this. On the application that comes up hit the Load button next to "Load an existing private key file."
+To convert your SSH key to Putty format go to the Start Menu and under the TortoiseGit folder there will be a Puttygen application, select this. On the application that comes up hit the '''Load''' button next to "'''Load an existing private key file'''."
-Navigate to the .ssh directory inside your user account, no files will show up however so you must use the dropdown menu that has "PuTTY Private Key Files (*.ppk)" selected by default and change it to "All Files (*.*)." You should now see your private key that was created earlier in the tutorial, select this and hit Open. You will be asked for your password and after entering it your private key will be imported. Now select the "Save private key" option to save your key in the Putty format. It is suggested that you save this in the same .ssh directory as your original key.
+Navigate to the .ssh directory inside your user account, no files will show up however so you must use the dropdown menu that has "'''PuTTY Private Key Files (*.ppk)'''" selected by default and change it to "'''All Files (*.*)'''." You should now see your private key that was created earlier in the tutorial, select this and hit Open. You will be asked for your password and after entering it your private key will be imported. Now select the "'''Save private key'''" option to save your key in the Putty format. It is suggested that you save this in the same .ssh directory as your original key.
 === Loading your SSH Key with Pageant ===
-Now that your SSH key has been converted to Putty format go to the Start Menu and under the TortoiseGit directory select the Pageant application. This application runs in the background and can be accessed via right clicking the icon in the System Tray. Right click on this icon and choose to "Add Key." Navigate to the .ssh directory inside your user account and select the key that you just converted. After you select the key you will be asked for your password one last time, enter it and you're finished!
+Now that your SSH key has been converted to Putty format go to the Start Menu and under the TortoiseGit directory select the Pageant application. This application runs in the background and can be accessed via right clicking the icon in the System Tray. Right click on this icon and choose to "'''Add Key'''." Navigate to the .ssh directory inside your user account and select the key that you just converted. After you select the key you will be asked for your password one last time, enter it and you're finished!
 === Using TortoiseGit to Checkout a Project ===
@@ Line 92: / Line 92: @@
 A prompt much like the one found in TortoiseSVN for checkouts will appear. Simply enter the address for the SWG:ANH project you wish to clone and hit OK.
-IMAGE PLACEHOLDER
+[[Image:Git5.png]]
 This process can take a few minutes so please be patient, it's been noted that on the first checkout that the TortoiseGit application appears to be hanging. Fear not, it's just pulling down the entire revision history of the SWG:ANH project!

@@ Line 1: / Line 1: @@
 = Git Setup Guide =
-Git is a & open source, distributed version control system designed to handle everything from small to very large projects with speed and efficiency. - http://www.git-scm.com/
+Git is a free & open source, distributed version control system designed to handle everything from small to very large projects with speed and efficiency. - http://www.git-scm.com/
 Over the years the SWG:ANH source has evolved into a massive project both in scope and in terms of number of lines of code, which at last count numbered over 145,000 lines. Up to March 2010 the SWG:ANH project used Subversion as it’s version control system, however, with the source base being the size that it is normal day-to-day tasks such as log lookups and branching/merging were a cumbersome chore. With this in mind the decision was made to switch to an alternative version control system better suited to the task.

@@ Line 68: / Line 68: @@
 The first time that you check out a project from the SWG:ANH Git Repository you receive a message asking you if you wish to continue connecting, simply enter yes to continue. You will also be asked to enter the passphrase that you selected when setting up your SSH key at this point, enter it to continue checking out the source. The initial clone will take a minute or two to complete, albeit much faster than the SVN checkouts use to take!
-Once the MMOServer clone has finished it’s time to do the same for the MMOServerDB project. Enter the following command for that:
+Now that the project is cloned new developers and testers will want to switch over to the develop branch where the latest changes are being made. This is done via a checkout command like below:
 <code>

@@ Line 5: / Line 5: @@
 Historically, support for Git on Windows was only possible using cygwin however, over the past few years support has improved greatly through projects like msysgit and TortoiseGit. The following guide will walk you through installing Git and configuring for use with SWG:ANH projects.
 == Installing Git on Windows ==
@@ Line 19: / Line 45: @@
 [[Image:Git2.png]]
 The installer will then copy all the necessary files and finish up. Now you’re ready to configure your Git environment for use with the SWG:ANH project.
 == Configure Git and Checkout SWG:ANH Projects ==
@@ Line 64: / Line 75: @@
 After the MMOServerDB project has been cloned you’re now ready to start working on the project! For those who are coming over from SVN and are not comfortable working with the command line on a regular basis read on to the next chapter on setting up TortoiseGit, the TortoiseSVN alternative for Git projects.
 == Additional Reading ==

@@ Line 8: / Line 8: @@
 == Installing Git on Windows ==
 To begin download the latest Git installer from the msysgit project site:
-[http://code.google.com/p/msysgit/|http://code.google.com/p/msysgit/]
+http://code.google.com/p/msysgit/[http://code.google.com/p/msysgit/]
 At the time of this writing the latest version is Git-1.7.0.2-preview20100309.exe.
@@ Line 64: / Line 64: @@
 After the MMOServerDB project has been cloned you’re now ready to start working on the project! For those who are coming over from SVN and are not comfortable working with the command line on a regular basis read on to the next chapter on setting up TortoiseGit, the TortoiseSVN alternative for Git projects.