Git has been integrated into ZenTao 5.0+, tasks, bugs and code can be linked, so it is convenient for users to check that. The followings are about how to integrate Git in ZenTao.

1. Git integration mechanism

The basic mechanism of Git integration is to

Analyze code comments committed => Get IDs of linked tasks and bug => Write IDs to ZenTao database.

Users have two ways to do what has been mentioned above. One is to use the hook built in SVN. When the code is committed, a hook is triggered. Then its comments will be analyzed, and the IDs of a bug/task will be obtained. Then ZenTao API is revoked, and enter the data to the database. The other way is to use the log command via Git. The command will get the committed data, then analyze it to get the IDs, and then write it in the database.

Each way has its pros and cons. The second one is used in ZenTao, because it is easier to debug and more convenient to deploy. It is also more flexible and can be used to analyze all the previous records.

2. Deploy GIT client on the machine installed ZenTao

GIT client refers to command lines built in Git. It is git.exe in Windows and git in Linux. Currently, ZenTao can only integrate Git repos store on the same machine which installs ZenTao. If it is a remote repo that you want to use, you have to clone that repo and update it regularly.

You have to install Git for machines of Linux system. Install Git via yum for rhel and Centos and apt-get install for Debian.

3. Configure Git in ZenTao

3.1 Codes

The configuration file of Git is saved in zentao/module/git/config.php. You can modify it and save it in git/ext/config/git.php as recommended, so the configuration file will not be overridden once updated.

3.2 Configuration

Before setting GIT parameters, there are some concepts involved as follows.

• Git client location
  
• Repo: multiple repos can be set.

Now let’s see an example below.

3.2.1 Find the code in a red box as shown below.

3.2.2  Modify the code
Modify codes as shown below.

$config->git->client   //  the Git client path
$config->git->repos[$i]['path']   // the path to Git repo

3.3 Set multiple repos
3.3.1 Find the code in the red box in the same file.

3.3.2 Modify the code

• Delete “/*” and ”*/“ from the code and other modifications are the same as shown above. Notes: $i ++ should not be modified.
• For other Git repos, copy the code and configure in the same way.

4. Comment

When committing to GIT, a comment on changes in relevant task or bug IDs is required. Please follow the format below.

• bug#123,234, 1234, or bug: 123,234 1234. Either a comma or space is used as space holders among IDs. 
• task#123.

Bugs and tasks must be labeled.

5. Git sync

5.1 Refer to Chapter 8.1.1  Initialize Scripts to initialize all the scripts of the command line.
5.2 Enter the directory of zentao/bin/ and execute syncgit.bat or syncgit.sh. 

5.3 The screenshot of executing the scripts.

5.4 Check linked bugs.

6. Activate Cron

6.1 When all the command lines are deployed, add the commands to the cron. 

• Solution 1: Login ZenTao, and go to Admin->Cron. Switch it on and then activate Sync Git scripts. 
• Solution 2: Use the cron in Control Panel of Windows and crontab in Linux.

6.2 The repository configured has to be synchronized via the cron. Use Git PULL to update every 5 minutes.