You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@asterixdb.apache.org by ti...@apache.org on 2016/07/22 01:20:18 UTC
asterixdb-site git commit: community and dev-setup fixes
Repository: asterixdb-site
Updated Branches:
refs/heads/asf-site 7bb6ace2e -> ad8974b76
community and dev-setup fixes
* remove incubator from mailing lists
* specify Eclipse version
* add IntelliJ IDEA to prerequisites
* some code formatting
* fix the "Manual Trigger" section
Change-Id: Ic7b3c53ed39b1465954162e7e1f31b67f9df699c
Reviewed-on: https://asterix-gerrit.ics.uci.edu/998
Reviewed-by: Yingyi Bu <bu...@gmail.com>
Project: http://git-wip-us.apache.org/repos/asf/asterixdb-site/repo
Commit: http://git-wip-us.apache.org/repos/asf/asterixdb-site/commit/ad8974b7
Tree: http://git-wip-us.apache.org/repos/asf/asterixdb-site/tree/ad8974b7
Diff: http://git-wip-us.apache.org/repos/asf/asterixdb-site/diff/ad8974b7
Branch: refs/heads/asf-site
Commit: ad8974b7614da1b68a9f0b2b30c42eca2c3263a9
Parents: 7bb6ace
Author: Till Westmann <ti...@apache.org>
Authored: Thu Jul 21 18:12:01 2016 -0700
Committer: Till Westmann <ti...@apache.org>
Committed: Thu Jul 21 18:19:25 2016 -0700
----------------------------------------------------------------------
community.md | 12 +++---
content/community.html | 24 +++++------
content/dev-setup.html | 92 +++++++++++++++++++++++++-----------------
dev-setup.md | 98 ++++++++++++++++++++++++---------------------
4 files changed, 127 insertions(+), 99 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/asterixdb-site/blob/ad8974b7/community.md
----------------------------------------------------------------------
diff --git a/community.md b/community.md
index 0755fbc..593be05 100644
--- a/community.md
+++ b/community.md
@@ -14,12 +14,12 @@ answers to any AsterixDB-related questions.
Most AsterixDB and Hyracks related discussion takes place on these mailing lists. To subscribe, send a blank email to the subscription address.
{:.table .table-striped .table-bordered}
-| Name | Address | Subscribe Address | Archives |
-|---------------|----------------------------------------------|--------------------------------------------------------|----------|
-| dev | dev@asterixdb.incubator.apache.org | dev-subscribe@asterixdb.incubator.apache.org | [link](https://mail-archives.apache.org/mod_mbox/incubator-asterixdb-dev/)|
-| users | users@asterixdb.incubator.apache.org | users-subscribe@asterixdb.incubator.apache.org | [link](https://mail-archives.apache.org/mod_mbox/incubator-asterixdb-users/)|
-| commits | commits@asterixdb.incubator.apache.org | commits-subscribe@asterixdb.incubator.apache.org | [link](https://mail-archives.apache.org/mod_mbox/incubator-asterixdb-commits/)|
-| notifications | notifications@asterixdb.incubator.apache.org | notifications-subscribe@asterixdb.incubator.apache.org | [link](https://mail-archives.apache.org/mod_mbox/incubator-asterixdb-notifications/)|
+| Name | Address | Subscribe Address | Archives |
+|---------------|------------------------------------|----------------------------------------------|----------|
+| dev | dev@asterixdb.apache.org | dev-subscribe@asterixdb.apache.org | [link](https://mail-archives.apache.org/mod_mbox/asterixdb-dev/)|
+| users | users@asterixdb.apache.org | users-subscribe@asterixdb.apache.org | [link](https://mail-archives.apache.org/mod_mbox/asterixdb-users/)|
+| commits | commits@asterixdb.apache.org | commits-subscribe@asterixdb.apache.org | [link](https://mail-archives.apache.org/mod_mbox/asterixdb-commits/)|
+| notifications | notifications@asterixdb.apache.org | notifications-subscribe@asterixdb.apache.org | [link](https://mail-archives.apache.org/mod_mbox/asterixdb-notifications/)|
### IRC
http://git-wip-us.apache.org/repos/asf/asterixdb-site/blob/ad8974b7/content/community.html
----------------------------------------------------------------------
diff --git a/content/community.html b/content/community.html
index a9f0987..d4e0b8a 100644
--- a/content/community.html
+++ b/content/community.html
@@ -129,27 +129,27 @@ answers to any AsterixDB-related questions.</p>
<tbody>
<tr>
<td>dev</td>
- <td>dev@asterixdb.incubator.apache.org</td>
- <td>dev-subscribe@asterixdb.incubator.apache.org</td>
- <td><a href="https://mail-archives.apache.org/mod_mbox/incubator-asterixdb-dev/">link</a></td>
+ <td>dev@asterixdb.apache.org</td>
+ <td>dev-subscribe@asterixdb.apache.org</td>
+ <td><a href="https://mail-archives.apache.org/mod_mbox/asterixdb-dev/">link</a></td>
</tr>
<tr>
<td>users</td>
- <td>users@asterixdb.incubator.apache.org</td>
- <td>users-subscribe@asterixdb.incubator.apache.org</td>
- <td><a href="https://mail-archives.apache.org/mod_mbox/incubator-asterixdb-users/">link</a></td>
+ <td>users@asterixdb.apache.org</td>
+ <td>users-subscribe@asterixdb.apache.org</td>
+ <td><a href="https://mail-archives.apache.org/mod_mbox/asterixdb-users/">link</a></td>
</tr>
<tr>
<td>commits</td>
- <td>commits@asterixdb.incubator.apache.org</td>
- <td>commits-subscribe@asterixdb.incubator.apache.org</td>
- <td><a href="https://mail-archives.apache.org/mod_mbox/incubator-asterixdb-commits/">link</a></td>
+ <td>commits@asterixdb.apache.org</td>
+ <td>commits-subscribe@asterixdb.apache.org</td>
+ <td><a href="https://mail-archives.apache.org/mod_mbox/asterixdb-commits/">link</a></td>
</tr>
<tr>
<td>notifications</td>
- <td>notifications@asterixdb.incubator.apache.org</td>
- <td>notifications-subscribe@asterixdb.incubator.apache.org</td>
- <td><a href="https://mail-archives.apache.org/mod_mbox/incubator-asterixdb-notifications/">link</a></td>
+ <td>notifications@asterixdb.apache.org</td>
+ <td>notifications-subscribe@asterixdb.apache.org</td>
+ <td><a href="https://mail-archives.apache.org/mod_mbox/asterixdb-notifications/">link</a></td>
</tr>
</tbody>
</table>
http://git-wip-us.apache.org/repos/asf/asterixdb-site/blob/ad8974b7/content/dev-setup.html
----------------------------------------------------------------------
diff --git a/content/dev-setup.html b/content/dev-setup.html
index 09fe42e..d252ee6 100644
--- a/content/dev-setup.html
+++ b/content/dev-setup.html
@@ -159,7 +159,7 @@ A great way to start contributing is to pick a bug labelled starter in JIRA and
<li>A suitable *nix environment (Linux, OSX)</li>
<li>JDK 1.8+</li>
<li>Maven 3.3.9 or greater</li>
- <li>A relatively recent version of Eclipse</li>
+ <li>Eclipse Juno (or later) or IntelliJ IDEA 15.0 (or later)</li>
</ul>
<h3 id="steps">Steps</h3>
@@ -238,8 +238,8 @@ A great way to start contributing is to pick a bug labelled starter in JIRA and
</li>
<li>Set up Eclipse code formatting rules
<ul>
- <li>Download files <a href="https://cwiki.apache.org/confluence/download/attachments/61322291/AsterixCodeFormatProfile.xml">AsterixCodeFormatProfile.xml</a>
- <a href="https://cwiki.apache.org/confluence/download/attachments/61322291/AsterixCleanupFormatProfile.xml">AsterixCleanupFormatProfile.xml</a></li>
+ <li>Download files <a href="https://cwiki.apache.org/confluence/download/attachments/61322291/AsterixCodeFormatProfile.xml">AsterixCodeFormatProfile.xml</a>
+ <a href="https://cwiki.apache.org/confluence/download/attachments/61322291/AsterixCleanupFormatProfile.xml">AsterixCleanupFormatProfile.xml</a></li>
<li>Import profiles into Eclipse
<ul>
<li>Preferences -> Java -> Code style -> Formatter -> Import -> Select AsterixCodeFormatProfile.xml</li>
@@ -272,32 +272,33 @@ You should only need to perform the following steps once.</p>
<li>Visit the above URL, and click on \u201cRegister\u201d in the upper right.</li>
<li>Gerrit uses OpenID; you may create an account using any OpenID provider, or with a Yahoo! account.</li>
<li>Click on \u201cSign in with a Yahoo! ID\u201d. You will be taken to a page to log in to Yahoo!.</li>
- <li>From there, you will get a page asking you to allow asterix-gerrit.ics.uci.edu to access your email and basic information. Approve this request.</li>
+ <li>From there, you will get a page asking you to allow <code>asterix-gerrit.ics.uci.edu</code> to access your email and basic information. Approve this request.</li>
<li>You will be directed back to Gerrit to complete the account signup. Make sure to fill out this page! It is necessary to allow you to push code changes to Gerrit for review.</li>
<li>For \u201cFull Name\u201d and \u201cPreferred Email\u201d, enter what you like. If you would like to register a different email address such as an @uci.edu address, you may do so. This is where Gerrit will send you notifications about code review requests, voting, and so on.</li>
<li>For \u201cSelect a unique username\u201d, choose a short alphanumeric ID. This will be your ssh username for git access. Be sure to click \u201cSelect Username\u201d to verify that the name is unique and allowed.</li>
<li>Also provide a ssh public key here. There is information on the page on creating one if you do not have one. Click \u201cAdd\u201d when done.
- * Note that you can create a new ssh public key just for Gerrit if you like; if you do so you will need to modify your .ssh/config file to ensure the right key is selected.</li>
+Note that you can create a new ssh public key just for Gerrit if you like; if you do so you will need to modify your <code>.ssh/config</code> file to ensure the right key is selected.</li>
<li>Click \u201cContinue\u201d at the bottom of the page.</li>
<li>
- <p>Finally, verify that you have everything set up: From a command-line, type
-<code>
-ssh -p 29418 username@asterix-gerrit.ics.uci.edu
-</code></p>
- </li>
- <li>You should see</li>
-</ol>
+ <p>Finally, verify that you have everything set up: From a command-line, type</p>
-<pre><code> **** Welcome to Gerrit Code Review ****
+ <pre><code>ssh -p 29418 username@asterix-gerrit.ics.uci.edu
+</code></pre>
+ </li>
+ <li>
+ <p>You should see</p>
- Hi Full Name, you have successfully connected over SSH.
+ <pre><code>**** Welcome to Gerrit Code Review ****
- Unfortunately, interactive shells are disabled.
- To clone a hosted Git repository, use:
+Hi Full Name, you have successfully connected over SSH.
- git clone ssh://username@asterix-gerrit.ics.uci.edu:29418/REPOSITORY_NAME.git
+Unfortunately, interactive shells are disabled.
+To clone a hosted Git repository, use:
+git clone ssh://username@asterix-gerrit.ics.uci.edu:29418/REPOSITORY_NAME.git
</code></pre>
+ </li>
+</ol>
<p>At this point, please send an email to Chris or Ian, specifying the email address of your new account, and ask to be added to the \u201cAsterixDB Devs\u201d group. You may push change proposals to Gerrit, and vote +1/-1 Code Review on any proposals without being in AsterixDB Devs, but you cannot vote +2 on anything to allow a change to be merged.</p>
@@ -308,15 +309,21 @@ ssh -p 29418 username@asterix-gerrit.ics.uci.edu
<h3 id="one-time-tasks">One-time tasks</h3>
<ol>
- <li>At the command-line, run the following. Replace \u201cusername\u201d with the user name you chose in step 7 above.
-<code>
-git config --global gerrit.url ssh://username@asterix-gerrit.ics.uci.edu:29418/
-</code></li>
- <li>Download my \u201cgit-gerrit\u201d utility library:
-<code>
-git clone https://github.com/ceejatec/git-gerrit
-</code></li>
- <li>Ensure that the <code>git-gerrit/git-gerrit</code> script is on your PATH. You could copy it to somewhere, but it would be best to leave it inside the github clone so you can easily get updates.</li>
+ <li>
+ <p>At the command-line, run the following. Replace \u201cusername\u201d with the user name you chose in step 7 above.</p>
+
+ <pre><code>git config --global gerrit.url ssh://username@asterix-gerrit.ics.uci.edu:29418/
+</code></pre>
+ </li>
+ <li>
+ <p>Download my \u201cgit-gerrit\u201d utility library:</p>
+
+ <pre><code>git clone https://github.com/ceejatec/git-gerrit
+</code></pre>
+ </li>
+ <li>
+ <p>Ensure that the <code>git-gerrit/git-gerrit</code> script is on your PATH. You could copy it to somewhere, but it would be best to leave it inside the github clone so you can easily get updates.</p>
+ </li>
</ol>
<h3 id="once-per-repository-tasks">Once-per-repository tasks</h3>
@@ -342,7 +349,7 @@ git clone https://github.com/ceejatec/git-gerrit
<ol>
<li>
- <p>When you want to start working on a bug, feature, etc, first make a local <code>git</code> branch. Never work directly on
+ <p>When you want to start working on a bug, feature, etc, first make a local <code>git</code> branch. Never work directly on
<code>master</code>! <code>master</code> should always be a pure mirror of <code>origin/master</code>, i.e., the GitHub mirror or the ASF repository.</p>
<pre><code>git checkout -b my_branch
@@ -393,11 +400,12 @@ To ssh://ceej@fulliautomatix.ics.uci.edu:29418/ceej-gerrit-test
<p>In that case, you may notice that the list of changes on the branch still contains older commits which have been merged. That is due to the unfortunate way Gerrit works; it requires squashing to a single git commit for review, which loses the association with the original commits in your history.</p>
-<p>It is also possible that you may want to re-use a branch and git-gerrit fails to notice that the older change has been merged - or perhaps the change was Abandoned on Gerrit and not merged, and you want to continue working on the same branch to create a new proposal. In this case, run
-<code>
-git gerrit new
-</code>
-on your branch. This will force git-gerrit to create a new Change-Id and commit message the next time you run <code>git gerrit submit</code>.</p>
+<p>It is also possible that you may want to re-use a branch and git-gerrit fails to notice that the older change has been merged - or perhaps the change was Abandoned on Gerrit and not merged, and you want to continue working on the same branch to create a new proposal. In this case, run</p>
+
+<pre><code>git gerrit new
+</code></pre>
+
+<p>on your branch. This will force git-gerrit to create a new Change-Id and commit message the next time you run <code>git gerrit submit</code>.</p>
<hr />
@@ -405,17 +413,29 @@ on your branch. This will force git-gerrit to create a new Change-Id and commit
<h3 id="verification">Verification</h3>
-<p>As of right now, whenever a patch set is submitted to Gerrit (i.e. whenever a user performs \u2018git gerrit submit\u2019) are automatically picked up by Jenkins, which runs <code>mvn verify</code> to test the patch fully. Once the build finishes, Jenkins comments on the patchset and votes with the result (+1 for all tests passing, -1 for anything less). Ideally, and in most cases, verifocation of a patchset reqires no intervention. However there are a few exceptions to this as detailed below.</p>
+<p>As of right now, whenever a patch set is submitted to Gerrit (i.e. whenever a user performs \u2018git gerrit submit\u2019) are automatically picked up by Jenkins, which runs <code>mvn verify</code> to test the patch fully.
+Once the build finishes, Jenkins comments on the patchset and votes with the result (+1 for all tests passing, -1 for anything less).
+Ideally, and in most cases, verification of a patchset reqires no intervention.
+However there are a few exceptions to this as detailed below.</p>
<h3 id="retrigggering-builds-and-triggering-builds-manually">Retrigggering builds and triggering builds manually</h3>
<h4 id="retriggering">Retriggering</h4>
-<p>Occasionally, there are builds in which tests failed, but perhaps not for a reason that has anything to do with the proposed patch\u2019s changes. For example, on occasion the Integration tests can have issues with ports on the build server already being bound. The simple work around to this is to try building again.</p>
+<p>Occasionally, there are builds in which tests failed, but perhaps not for a reason that has anything to do with the proposed patch\u2019s changes.
+For example, on occasion the Integration tests can have issues with ports on the build server already being bound.
+The simple work around to this is to try building again.</p>
-<p>One way to perform this is by simply visiting the link that is posted on Gerrit by Jenkins, and hitting the \u2018Retrigger\u2019 link on the left-hand side of the page. This will try retesting the build with the exact same parameters as last time, hopefully with a different result.</p>
+<p>One way to perform this is by simply visiting the link that is posted on Gerrit by Jenkins, and hitting the \u2018Retrigger\u2019 link on the left-hand side of the page.
+This will try retesting the build with the exact same parameters as last time, hopefully with a different result.</p>
<h4 id="manual-trigger">Manual Trigger</h4>
-<p>Builds of Gerrit patches can also be fully manually triggered from Jenkins. This can be desirable if a change is now dependent on a Hyracks change (via the Topic field feature described below), or if the patch is a draft or is not triggered automatically for any other reason. To manually trigger a build of a patchset, visit the Jenkins front-page, and click the \u2018Query and Trigger Gerrit patches\u2019 link. This should link to a page allowing you to manually trigger Gerrit patches. In the search field any query that can be searched in the Gerrit web interface can be used, but the default query of all open patchsets is likely fine. Hit the \u2018Search\u2019 button, and then click the checkbox that represents the patch that needs to be built. Then simply click \u2018Trigger Selected\u2019 and the patch will start building.</p>
+<p>Builds of Gerrit patches can also be fully manually triggered from Jenkins.
+This can be desirable if the patch is a draft or is not triggered automatically for any other reason.
+To manually trigger a build of a patchset, visit the Jenkins front-page, and click the \u2018Query and Trigger Gerrit patches\u2019 link.
+This should link to a page allowing you to manually trigger Gerrit patches.
+In the search field any query that can be searched in the Gerrit web interface can be used, but the default query of all open patchsets is likely fine.
+Hit the \u2018Search\u2019 button, and then click the checkbox that represents the patch that needs to be built.
+Then simply click \u2018Trigger Selected\u2019 and the patch will start building.</p>
<hr />
http://git-wip-us.apache.org/repos/asf/asterixdb-site/blob/ad8974b7/dev-setup.md
----------------------------------------------------------------------
diff --git a/dev-setup.md b/dev-setup.md
index f1f66ab..7f1635b 100644
--- a/dev-setup.md
+++ b/dev-setup.md
@@ -35,7 +35,7 @@ If you are a developer simply looking for a snapshot of the latest development v
* A suitable \*nix environment (Linux, OSX)
* JDK 1.8+
* Maven 3.3.9 or greater
- * A relatively recent version of Eclipse
+ * Eclipse Juno (or later) or IntelliJ IDEA 15.0 (or later)
### Steps
@@ -75,28 +75,28 @@ If you are a developer simply looking for a snapshot of the latest development v
#### Eclipse IDE Setup
3. In Eclipse, import asterixdb as an existing Maven Project.
-* `File -> Import -> Maven -> Existing Maven Projects -> Next`
-* Specify the Root directory as `asterixdb` and then click Next until Finish is enabled.
-* If Eclipse tries to install the `m2e` (Maven To Eclipse) connector, let it do so.
-* There might be some plugin errors; however, that is not a big deal. Wait until the job finishes.
-* Then, click Finish. Restart Eclipse if asked to do so.
+ * `File -> Import -> Maven -> Existing Maven Projects -> Next`
+ * Specify the Root directory as `asterixdb` and then click Next until Finish is enabled.
+ * If Eclipse tries to install the `m2e` (Maven To Eclipse) connector, let it do so.
+ * There might be some plugin errors; however, that is not a big deal. Wait until the job finishes.
+ * Then, click Finish. Restart Eclipse if asked to do so.
4. Fix Eclipse's build path to include compile-time generated sources.
-* Right click the project where a red X mark is shown(e.g. `asterix-algebra`. Then resolve by applying the following:
- * Right click asterix-algebra. Click Build Path and Configure Build Path. Click Add Folder.
- * Under the `target -> generated sources`, check the parent folder of the `org` folder and click OK.
- * For example, if the directory structure is "target - generated-sources - javacc - org - apache ...", check the javacc directory and click OK. Then X mark will dissapear.
-* Repeat this step to all projects which show a red X mark except "asterix-fuzzyjoin" and "asterix-transactions".
-* It may be the case that only "asterix-algebra" and "asterix-external-data" will require these steps.
-* If you see "plugin execution not covered by lifecycle configuration" errors such as this one - "Plugin execution not covered by lifecycle configuration: org.apache.asterix:asterix-test-datagenerator-maven-plugin:0.8.9-SNAPSHOT:generate-testdata (execution: replace-template-data, phase: process-test-resources)", try to resolve it using the quick fix feature. You can call this feature by right click on the error and select "quick fix". And then choose "Mark goal generate-testdata as ignored in Eclipse build in Eclipse preferences".
+ * Right click the project where a red X mark is shown(e.g. `asterix-algebra`. Then resolve by applying the following:
+ * Right click asterix-algebra. Click Build Path and Configure Build Path. Click Add Folder.
+ * Under the `target -> generated sources`, check the parent folder of the `org` folder and click OK.
+ * For example, if the directory structure is "target - generated-sources - javacc - org - apache ...", check the javacc directory and click OK. Then X mark will dissapear.
+ * Repeat this step to all projects which show a red X mark except "asterix-fuzzyjoin" and "asterix-transactions".
+ * It may be the case that only "asterix-algebra" and "asterix-external-data" will require these steps.
+ * If you see "plugin execution not covered by lifecycle configuration" errors such as this one - "Plugin execution not covered by lifecycle configuration: org.apache.asterix:asterix-test-datagenerator-maven-plugin:0.8.9-SNAPSHOT:generate-testdata (execution: replace-template-data, phase: process-test-resources)", try to resolve it using the quick fix feature. You can call this feature by right click on the error and select "quick fix". And then choose "Mark goal generate-testdata as ignored in Eclipse build in Eclipse preferences".
5. Set up Eclipse code formatting rules
-* Download files [AsterixCodeFormatProfile.xml](https://cwiki.apache.org/confluence/download/attachments/61322291/AsterixCodeFormatProfile.xml)
- [AsterixCleanupFormatProfile.xml](https://cwiki.apache.org/confluence/download/attachments/61322291/AsterixCleanupFormatProfile.xml)
-* Import profiles into Eclipse
- * Preferences -> Java -> Code style -> Formatter -> Import -> Select AsterixCodeFormatProfile.xml
- * Preferences -> Java -> Code style -> Clean up -> Import -> Select AsterixCleanupFormatProfile.xml
- * Preferences -> Java -> Editor -> Save actions -> Perform the selected action on save -> Format source code
+ * Download files [AsterixCodeFormatProfile.xml](https://cwiki.apache.org/confluence/download/attachments/61322291/AsterixCodeFormatProfile.xml)
+ [AsterixCleanupFormatProfile.xml](https://cwiki.apache.org/confluence/download/attachments/61322291/AsterixCleanupFormatProfile.xml)
+ * Import profiles into Eclipse
+ * Preferences -> Java -> Code style -> Formatter -> Import -> Select AsterixCodeFormatProfile.xml
+ * Preferences -> Java -> Code style -> Clean up -> Import -> Select AsterixCleanupFormatProfile.xml
+ * Preferences -> Java -> Editor -> Save actions -> Perform the selected action on save -> Format source code
6. Lastly, go to the asterixdb folder and execute following command again. This is required since Eclipse might have cleaned the projects and rebuilt the them without creating all necessary classes. Currently, some of the class files can be only built using mvn command.
@@ -116,31 +116,27 @@ Our Gerrit server is [here](https://asterix-gerrit.ics.uci.edu/)
1. Visit the above URL, and click on "Register" in the upper right.
1. Gerrit uses OpenID; you may create an account using any OpenID provider, or with a Yahoo! account.
1. Click on "Sign in with a Yahoo! ID". You will be taken to a page to log in to Yahoo!.
- 1. From there, you will get a page asking you to allow asterix-gerrit.ics.uci.edu to access your email and basic information. Approve this request.
+ 1. From there, you will get a page asking you to allow `asterix-gerrit.ics.uci.edu` to access your email and basic information. Approve this request.
1. You will be directed back to Gerrit to complete the account signup. Make sure to fill out this page! It is necessary to allow you to push code changes to Gerrit for review.
1. For "Full Name" and "Preferred Email", enter what you like. If you would like to register a different email address such as an @uci.edu address, you may do so. This is where Gerrit will send you notifications about code review requests, voting, and so on.
1. For "Select a unique username", choose a short alphanumeric ID. This will be your ssh username for git access. Be sure to click "Select Username" to verify that the name is unique and allowed.
1. Also provide a ssh public key here. There is information on the page on creating one if you do not have one. Click "Add" when done.
- * Note that you can create a new ssh public key just for Gerrit if you like; if you do so you will need to modify your .ssh/config file to ensure the right key is selected.
+ Note that you can create a new ssh public key just for Gerrit if you like; if you do so you will need to modify your `.ssh/config` file to ensure the right key is selected.
1. Click "Continue" at the bottom of the page.
1. Finally, verify that you have everything set up: From a command-line, type
-```
-ssh -p 29418 username@asterix-gerrit.ics.uci.edu
-```
- 1. You should see
+ ssh -p 29418 username@asterix-gerrit.ics.uci.edu
-```
- **** Welcome to Gerrit Code Review ****
+ 1. You should see
- Hi Full Name, you have successfully connected over SSH.
+ **** Welcome to Gerrit Code Review ****
- Unfortunately, interactive shells are disabled.
- To clone a hosted Git repository, use:
+ Hi Full Name, you have successfully connected over SSH.
- git clone ssh://username@asterix-gerrit.ics.uci.edu:29418/REPOSITORY_NAME.git
+ Unfortunately, interactive shells are disabled.
+ To clone a hosted Git repository, use:
-```
+ git clone ssh://username@asterix-gerrit.ics.uci.edu:29418/REPOSITORY_NAME.git
At this point, please send an email to Chris or Ian, specifying the email address of your new account, and ask to be added to the "AsterixDB Devs" group. You may push change proposals to Gerrit, and vote +1/-1 Code Review on any proposals without being in AsterixDB Devs, but you cannot vote +2 on anything to allow a change to be merged.
@@ -151,13 +147,13 @@ At this point, please send an email to Chris or Ian, specifying the email addres
### One-time tasks
1. At the command-line, run the following. Replace "username" with the user name you chose in step 7 above.
-```
-git config --global gerrit.url ssh://username@asterix-gerrit.ics.uci.edu:29418/
-```
+
+ git config --global gerrit.url ssh://username@asterix-gerrit.ics.uci.edu:29418/
+
1. Download my "git-gerrit" utility library:
-```
-git clone https://github.com/ceejatec/git-gerrit
-```
+
+ git clone https://github.com/ceejatec/git-gerrit
+
1. Ensure that the `git-gerrit/git-gerrit` script is on your PATH. You could copy it to somewhere, but it would be best to leave it inside the github clone so you can easily get updates.
### Once-per-repository tasks
@@ -217,9 +213,9 @@ Once you are done with a change (that is, it has been Code Reviewed and approved
In that case, you may notice that the list of changes on the branch still contains older commits which have been merged. That is due to the unfortunate way Gerrit works; it requires squashing to a single git commit for review, which loses the association with the original commits in your history.
It is also possible that you may want to re-use a branch and git-gerrit fails to notice that the older change has been merged - or perhaps the change was Abandoned on Gerrit and not merged, and you want to continue working on the same branch to create a new proposal. In this case, run
-```
-git gerrit new
-```
+
+ git gerrit new
+
on your branch. This will force git-gerrit to create a new Change-Id and commit message the next time you run `git gerrit submit`.
---
@@ -228,16 +224,28 @@ on your branch. This will force git-gerrit to create a new Change-Id and commit
### Verification
-As of right now, whenever a patch set is submitted to Gerrit (i.e. whenever a user performs 'git gerrit submit') are automatically picked up by Jenkins, which runs `mvn verify` to test the patch fully. Once the build finishes, Jenkins comments on the patchset and votes with the result (+1 for all tests passing, -1 for anything less). Ideally, and in most cases, verifocation of a patchset reqires no intervention. However there are a few exceptions to this as detailed below.
+As of right now, whenever a patch set is submitted to Gerrit (i.e. whenever a user performs 'git gerrit submit') are automatically picked up by Jenkins, which runs `mvn verify` to test the patch fully.
+Once the build finishes, Jenkins comments on the patchset and votes with the result (+1 for all tests passing, -1 for anything less).
+Ideally, and in most cases, verification of a patchset reqires no intervention.
+However there are a few exceptions to this as detailed below.
### Retrigggering builds and triggering builds manually
#### Retriggering
-Occasionally, there are builds in which tests failed, but perhaps not for a reason that has anything to do with the proposed patch's changes. For example, on occasion the Integration tests can have issues with ports on the build server already being bound. The simple work around to this is to try building again.
+Occasionally, there are builds in which tests failed, but perhaps not for a reason that has anything to do with the proposed patch's changes.
+For example, on occasion the Integration tests can have issues with ports on the build server already being bound.
+The simple work around to this is to try building again.
-One way to perform this is by simply visiting the link that is posted on Gerrit by Jenkins, and hitting the 'Retrigger' link on the left-hand side of the page. This will try retesting the build with the exact same parameters as last time, hopefully with a different result.
+One way to perform this is by simply visiting the link that is posted on Gerrit by Jenkins, and hitting the 'Retrigger' link on the left-hand side of the page.
+This will try retesting the build with the exact same parameters as last time, hopefully with a different result.
#### Manual Trigger
-Builds of Gerrit patches can also be fully manually triggered from Jenkins. This can be desirable if a change is now dependent on a Hyracks change (via the Topic field feature described below), or if the patch is a draft or is not triggered automatically for any other reason. To manually trigger a build of a patchset, visit the Jenkins front-page, and click the 'Query and Trigger Gerrit patches' link. This should link to a page allowing you to manually trigger Gerrit patches. In the search field any query that can be searched in the Gerrit web interface can be used, but the default query of all open patchsets is likely fine. Hit the 'Search' button, and then click the checkbox that represents the patch that needs to be built. Then simply click 'Trigger Selected' and the patch will start building.
+Builds of Gerrit patches can also be fully manually triggered from Jenkins.
+This can be desirable if the patch is a draft or is not triggered automatically for any other reason.
+To manually trigger a build of a patchset, visit the Jenkins front-page, and click the 'Query and Trigger Gerrit patches' link.
+This should link to a page allowing you to manually trigger Gerrit patches.
+In the search field any query that can be searched in the Gerrit web interface can be used, but the default query of all open patchsets is likely fine.
+Hit the 'Search' button, and then click the checkbox that represents the patch that needs to be built.
+Then simply click 'Trigger Selected' and the patch will start building.
---