Difference between revisions of "E4/Git"

From Eclipsepedia

< E4
Jump to: navigation, search
(Submitting for a build)
(Submitting for a build)
Line 61: Line 61:
 
  /bin/bash git-gen-map.sh git://git.eclipse.org/gitroot/e4/org.eclipse.e4.search.git v20101124-0800 bundles tests features
 
  /bin/bash git-gen-map.sh git://git.eclipse.org/gitroot/e4/org.eclipse.e4.search.git v20101124-0800 bundles tests features
  
=== Submitting for a build ===
+
=== Submitting for a build ===
 +
<blockquote>''Note:'' We have a policy that all commits have the associated bug number. Usually our format is: "Bug &lt;number&gt; - &lt;bug title&gt;" and then any specific comments after the title or on the next line. It's important that we only list 1 bug # per line, and at the beginning of the line. A line with "bug #" or "Bug #" without the title is also acceptable. <br> </blockquote>
 +
We have 2 scripts used for submitting for the build. One to update the map files, and one to generate the submission report for our mailing list e4-dev@eclipse.org
  
We have 2 scripts used for submitting for the build. One to update the map files, and one to generate the submission report for our mailing list e4-dev@eclipse.org
+
[http://dev.eclipse.org/viewcvs/index.cgi/e4/releng/org.eclipse.e4.builder/scripts/git-map.sh?view=co&content-type=text/plain git-map.sh] is used to update the map files.The output is a set of commands which should be captured, reviewed and then executed to update the map files.<br>
  
[http://dev.eclipse.org/viewcvs/index.cgi/e4/releng/org.eclipse.e4.builder/scripts/git-map.sh?view=co&content-type=text/plain git-map.sh] is used to update the map files.
+
[http://dev.eclipse.org/viewcvs/index.cgi/e4/releng/org.eclipse.e4.builder/scripts/git-submission.sh?view=co&content-type=text/plain git-submission.sh] is used to generate a build submission report. The last command output by git-map.sh will be a call to git-submission.sh saving the output to "report.txt".<br>
  
[http://dev.eclipse.org/viewcvs/index.cgi/e4/releng/org.eclipse.e4.builder/scripts/git-submission.sh?view=co&content-type=text/plain git-submission.sh] is used to generate a build submission report.
+
<br> When submitting for a build, the git repository clones should be checked out on the branch you wish to tag.<br>
  
''Note:'' We have a policy that all commits have the associated bug number.  Usually our format is:
+
The git-map.sh takes the following arguments:
Bug <number> - <bug title>
+
and then any specific comments after the title or on the next line. It's important that we only list 1 bug # per line, and at the beginning of the line.  A line with "bug #" or "Bug #" without the title is also acceptable.
+
  
When ready to submit deeplinking for the build, you have to submit 2 repos, org.eclipse.e4.deeplink and org.eclipse.e4.utils.  For each repo:
+
git-map.sh repoRoot relengRoot repoUrl [repoUrl]*
  
#cd into the repo (make sure it's up to date, you're on the master branch, etc)
+
*repoRoot: an absolute path to a folder containing cloned git repositories
#tag the repo: git tag v20101022-1030  # we use vDATE-TIME as our tag
+
*relengRoot: an absolute path to the releng project containing the map files
#make sure you push the tag back to the public repo.  ex: git push --tags
+
*repoUrl - git repository URLs to tag
#run the script (see example below)
+
#You'll have to execute the script for each subdiretory: bundles, examples, features, tests.
+
#Repeat the steps for the second repo.
+
#Then refresh your workspace and commit.
+
  
git-map.sh example:
+
The script performs the following steps:  
$ /bin/bash git-map.sh v20101022-1030 /opt/pwebster/workspaces/e4/releng/org.eclipse.e4.deeplink.releng/maps/deeplink.map  bundles
+
 
+
  
Then when done you can generate your build submission report for the e4-dev list:
+
#Find all the map files under '''relengRoot'''
  $ /bin/bash git-submission.sh >report.txt
+
#For each map file, find all entries containing "repo='''repoUrl'''" where repoUrl is one of the passed in git repositories
 +
#For each git map file entry, find the corresponding project under the git repository clone under '''repoRoot'''.
 +
#Check if the last commit in the project has the current tag from the map file, if not tag and output a command to update the map file
 +
 
 +
For example, consider a git repository git://git.eclipse.org/gitroot/org.eclipse.e4.deeplink.git. If '''repoRoot=/eclipse/git''' then the script expects a subfolder '''/eclipse/git/org.eclipse.e4.deeplink''' which is a clone of this repository.&nbsp; The releng map files are under '''/eclipse/workspace/e4-releng'''.&nbsp; The command line to invoke git-map.sh would be:<br>
 +
<pre>repoRoot: /eclipse/git
 +
          /eclipse/git/org.eclipse.e4.deeplink #deeplink clone
 +
          /eclipse/git/org.eclipse.e4.search    #search clone
 +
 
 +
relengRoot: /eclipse/workspace/e4-releng        #project containing map files
 +
            /eclipse/workspace/e4-releng/org.eclipse.e4.deeplink.releng/maps/deeplink.map
 +
            /eclipse/workspace/e4-releng/org.eclipse.e4.search.releng/maps/search.map
 +
 
 +
 
 +
/bin/bash git-map.sh /eclipse/git \
 +
                    /eclipse/workspace/e4-releng \
 +
                    git://git.eclipse.org/gitroot/e4/org.eclipse.e4.deeplink.git \
 +
                    git://git.eclipse.org/gitroot/e4/org.eclipse.e4.search.git &gt; run.txt 
 +
 
 +
more run.txt          #examine run.txt
 +
/bin/bash run.txt
 +
more report.txt       #examine submission report
 +
</pre>

Revision as of 16:49, 12 August 2011

For working in git lately I've been using the latest eGit. Functionality has been increasing week over week, so I just use their latest nightly:

http://download.eclipse.org/egit/updates-nightly

Some resources:

Git in e4

We have a place in e4 for git repositories.

Current Repos

A repo then follows our standard subdir convention:

  • bundles
  • features
  • examples
  • tests

When creating a repo on the server, follow these steps (Please update them if there are better steps :-)

  1. log into git.eclipse.org
  2. cd /gitroot/e4
  3. mkdir component.id.git # ex: mkdir org.eclipse.e4.search.git
  4. cd component.id.git
  5. git init --bare

This creates a bare repo that can be cloned. Then on your work machine

  1. git clone ssh://pwebster@git.eclipse.org/gitroot/e4/component.id.git
  2. cd component.id
  3. mkdir bundles features examples tests
  4. add a useful .gitignore. See below
  5. copy in your plugins into bundles, features into features, test plugins into tests, etc
  6. add all of your files: git add -A
  7. commit them with a useful commit message
  8. add 2 tags. One will be initial-import. The other should be a time tag, like v20101124-0800
  9. I split the next step up into 2:
    1. git push origin master
    2. git push --tags origin


Example .gitignore

bin/
*~
*.rej
*.bak


We build our git repos still using map files, checked into CVS in the /cvsroot/eclipse e4/releng module. You can generate a default map file for your initial commit from your repo root using git-gen-map.sh. ex:

/bin/bash git-gen-map.sh git://git.eclipse.org/gitroot/e4/org.eclipse.e4.search.git v20101124-0800 bundles tests features

Submitting for a build

Note: We have a policy that all commits have the associated bug number. Usually our format is: "Bug <number> - <bug title>" and then any specific comments after the title or on the next line. It's important that we only list 1 bug # per line, and at the beginning of the line. A line with "bug #" or "Bug #" without the title is also acceptable.

We have 2 scripts used for submitting for the build. One to update the map files, and one to generate the submission report for our mailing list e4-dev@eclipse.org

git-map.sh is used to update the map files.The output is a set of commands which should be captured, reviewed and then executed to update the map files.

git-submission.sh is used to generate a build submission report. The last command output by git-map.sh will be a call to git-submission.sh saving the output to "report.txt".


When submitting for a build, the git repository clones should be checked out on the branch you wish to tag.

The git-map.sh takes the following arguments:

git-map.sh repoRoot relengRoot repoUrl [repoUrl]*
  • repoRoot: an absolute path to a folder containing cloned git repositories
  • relengRoot: an absolute path to the releng project containing the map files
  • repoUrl - git repository URLs to tag

The script performs the following steps:

  1. Find all the map files under relengRoot
  2. For each map file, find all entries containing "repo=repoUrl" where repoUrl is one of the passed in git repositories
  3. For each git map file entry, find the corresponding project under the git repository clone under repoRoot.
  4. Check if the last commit in the project has the current tag from the map file, if not tag and output a command to update the map file

For example, consider a git repository git://git.eclipse.org/gitroot/org.eclipse.e4.deeplink.git. If repoRoot=/eclipse/git then the script expects a subfolder /eclipse/git/org.eclipse.e4.deeplink which is a clone of this repository.  The releng map files are under /eclipse/workspace/e4-releng.  The command line to invoke git-map.sh would be:

repoRoot: /eclipse/git 
          /eclipse/git/org.eclipse.e4.deeplink  #deeplink clone
          /eclipse/git/org.eclipse.e4.search    #search clone

relengRoot: /eclipse/workspace/e4-releng        #project containing map files
            /eclipse/workspace/e4-releng/org.eclipse.e4.deeplink.releng/maps/deeplink.map
            /eclipse/workspace/e4-releng/org.eclipse.e4.search.releng/maps/search.map


/bin/bash git-map.sh /eclipse/git \
                     /eclipse/workspace/e4-releng \
                     git://git.eclipse.org/gitroot/e4/org.eclipse.e4.deeplink.git \
                     git://git.eclipse.org/gitroot/e4/org.eclipse.e4.search.git > run.txt   

more run.txt          #examine run.txt
/bin/bash run.txt
more report.txt       #examine submission report