The Forge

From Wiki
Revision as of 16:15, 26 February 2016 by David.w.smiley@gmail.com (Talk | contribs) (Describe how to configure the jar signer in more detail)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

This is a user's guide to using the LocationTech forge.

LocationTech accounts are identified using the email address of the individual, except where noted otherwise.

Getting an account

LocationTech uses the Eclipse Foundation account for authentication purposes. Anyone can register for an Eclipse account. If you wish to access the forge as a committer, you need to nominated by an existing project committer and elected by the existing project team before joining a project.

Code

  • Git and GitHub are the only SCM used on LocationTech.
  • Gerrit is used for code reviews on LocationTech.
  • All the code repositories are available at http://locationtech.org/c
    • Use your committer ID (e.g. wbeaton), Do not use your email address
    • For http protocol you need to use the password generated by Gerrit under Settings > Http Password
    • For ssh protocol you need to upload your ssh public key to Gerrit.
  • LocationTech on GitHub
  • To create a new repository, please file a bug (using the Eclipse Bugzilla) against the LocationTech Working Group. Don't forget to state for which LocationTech project you want the new repository.

Bugzilla

  • Bugzilla is available at https://locationtech.org/bugs/
  • Log in using your email address
  • To create Bugzilla products, components and milestones, please file a bug (using the Eclipse Bugzilla) against the LocationTech Working Group. Don't forget to state for which LocationTech project you want the new items.


Hudson

  • https://locationtech.org/hudson/ - Hudson docs at Eclipse
  • Log in using your email address
  • Each LocationTech project can have one Hudson instance (called HIPP)
  • HIPP owners can administer their instance
  • Using Hudson as a file download service is not appropriate. Promote builds to your project's download area (see below).
  • To request a HIPP, please file a bug (using the Eclipse Bugzilla) against the LocationTech Working Group. Don't forget to state for which LocationTech project you want the new Hudson instance.

Downloads

Forums

  • Forums are not enabled for LocationTech.

Builds and Signing

The JAR signing service is up and running @ locationtech.org. Here is a description about how to use it:

From a Maven build, use Eclipse's jar signer plugin. Version 1.1.3 and + must be used (currently, it is the latest available). For non-Maven builds, there is some info at that link that will be of use.

This is a configuration using it in a Maven profile dedicated to signing:

   <profile>
     <id>eclipse-sign</id>
     <build>
       <plugins>
         <plugin>
           <groupId>org.eclipse.cbi.maven.plugins</groupId>
           <artifactId>eclipse-jarsigner-plugin</artifactId>
           <version>1.1.3</version>
           <configuration>
             <signerUrl>http://locationtech.org:31338/sign</signerUrl>
           </configuration>
           <executions>
             <execution>
               <id>sign</id>
               <goals>
                 <goal>sign</goal>
               </goals>
               <phase>verify</phase>
             </execution>
           </executions>
         </plugin>
       </plugins>
     </build>
     <pluginRepositories>
       <pluginRepository>
         <id>cbi-releases</id>
         <url>https://repo.eclipse.org/content/repositories/cbi-releases/</url>
       </pluginRepository>
     </pluginRepositories>
   </profile>

The signing server only accepts connections originating from Eclipse infrastructure (e.g. Hudson). So to actually do any signing, you'll need to get a Hudson instance and possibly add a Job for the express purpose of signing. A ramification of this is that if you wish to deploy artifacts to Maven central, you can't (or shouldn't rather) fully use Maven's release plugin, although partial use is still useful. This is because the actual deployment step should ship Eclipse-signed jars that can only be obtained from a Hudson build server; jars built from a local developer's machine won't be signed. The Hudson Job should have the profile "eclipse-sign" (as named in this suggested profile config), and it should also be configured to create all auxiliary jar files desired to be deployed if your project wants to deploy them. For example javadoc jar, source jar, test jar, maybe other custom ones as desired. That can be done by configuring Maven plugins to execute certain goals, or it can be configured in the Hudson Job by adding javadoc:jar jar:test-jar source:jar to the goals list for example. The configuration above shows that the signing of available jars will happen at the Maven "verify" goal.

Mailing lists

  • http://locationtech.org/mailman/. Users can then subscribe to the mailing lists using the list's info page.
  • To request a new mailing list, please file a bug (using the Eclipse Bugzilla) against the LocationTech Working Group. Don't forget to state for which LocationTech project you want the new list.

Help documentation

Help documentation is not installed yet. Contact Webmaster for more information.

  • http://locationtech.org/help/
  • Documentation plugins must be uploaded to /home/httpd/help/eclipse/dropins/ by the webmaster. Please contact Webmaster, and provide the location of your doc plugins.

Website

  • http://locationtech.org/
  • Only designated editors can modify content.
  • Project-related content can be modified by project leads committers, and PMC leads and members.
  • Log in using your email address

See also