Spring Projects Infrastructure
                           Roy Clarkson, Spring for Android/Mobile Project Lead
                                    Gunnar Hillert, Spring Integration
                                 Twitter/GitHub: @royclarkson, @ghillert



© 2012 SpringOne 2GX. All rights reserved. Do not distribute without permission.
2
What is Spring?

                           Spring Mobile          Spring Gemfire
       Spring AMQP
                                         Spring for Android
                                                                Spring Hadoop
           Spring Batch

                        Spring Framework
                                                                    Spring Social
    Spring .NET            Spring Integration
                                                  Spring Security
                  Spring Data
Spring Shell                                                   Spring Web Flow
                                 Spring Roo
6
Agenda
•       Issue Tracking
•       Build
•       Continuous Integration/Deployment
•       Repositories
•       Source Control
•       Community Contributions




    4
jira.springsource.org
5
Issue Tracking
•       Submit bug reports
•       Request features
•       Vote for issues
•       Provide feedback
•       Track status
•       Watch issues




    6
Lifecycle of an Issue
•       Unassigned
•       Waiting For Triage
•       Triaged
•       In Progress
•       Resolved
•       Closed




    7
More Information
• github.com/SpringSource/spring-framework/wiki/The-
  Lifecycle-of-an-Issue




 8
9
Gradle Hello World

          task hello {
          	 doLast {
          	 	 println 'Hello world!'
          	 }
          }




10
Demo




11
Building Spring
$ git clone git://github.com/SpringSource/
spring-framework.git
$ cd spring-framework
$ ./gradlew build




 12
Projects using Gradle
•        Spring Framework (since Jan 2012)
•        Spring Integration (since Oct 2010)
•        Spring AMQP (since Jun 2012)
•        Spring for Android (since May 2011)
•        Spring Mobile (since Nov 2010)
•        Spring Social (since Oct 2010)
•        And more …



    13
Gradle
•        Version 1.2 released 2012-09-12
•        Gradle Wrapper
•        Maven-like defaults
•        More concise than Maven
•        Scripting capabilities like Ant
•        Supports multi-project builds
•        Dependency management based on Apache Ivy
•        Build scripts written in Groovy

    14
Common Tasks for Spring Projects
•        clean – Deletes the build directory
•        build – Assembles and tests this project
•        dist – Creates Zip (Jars, Reference, Api Doc, Schema)
•        api – Generates aggregated Javadoc API documentation
•        reference – Generates HTML and PDF documentation
•        install – Install archives artifacts into local .m2 cache
•        eclipse – Generates all Eclipse files
•        idea – Generates IDEA project files
•        sonarAnalyze – Gather Sonar Metrics
    15
Demo




16
Spring Tool Suite
• Gradle Support since 2.7.0
• Import Gradle projects directly into STS
• static.springsource.org/sts/docs/latest/reference/html/
  gradle




 17
IntelliJ IDEA
• Gradle Support in IntelliJ IDEA 11
• www.jetbrains.com/idea/webhelp/gradle-2.html
• confluence.jetbrains.com/display/IDEADEV/News




 18
More Information
• gradle.org




 19
build.springsource.org

20
Bamboo Features
•        Continuous Integration
•        Highly Configurable
•        Instant Feedback
•        Continuous Deployment
•        Release Management
•        JIRA Integration
•        Plugin Support



    21
sonar.springsource.org

22
Sonar Metrics




23
repo.springsource.org

24
SpringSource Artifactory
•        Replaces previous Maven repositories
•        GA releases still available in Maven Central
•        Unified search
•        Put a watch on anything
•        License information
•        Transitive resolution
•        Release process



    25
SpringSource Repository




      repo.springsource.org




26
SpringSource Repository
• Local Repositories
      – libs-snapshot-local, libs-milestone-local, libs-release-local


• Virtual Repositories
      – snapshot, milestone, release


• Virtual Repositories with Third-Party Support
      – libs-snapshot, libs-milestone, libs-release


 27
Maven
<repository>
    <id>springsource-release</id>
    <name>SpringSource Release Repository</name>
    <url>http://repo.springsource.org/libs-release</url>
</repository>

<repository>
    <id>springsource-milestone</id>
    <name>SpringSource Milestone Repository</name>
    <url>http://repo.springsource.org/libs-milestone</url>
</repository>

<repository>
    <id>springsource-snapshot</id>
    <name>SpringSource Snapshot Repository</name>
    <url>http://repo.springsource.org/libs-snapshot</url>
</repository>


28
More Information
• Spring Repository FAQ

      github.com/SpringSource/spring-framework/wiki/
      SpringSource-repository-FAQ

• Downloading Spring Artifacts

      github.com/SpringSource/spring-framework/wiki/
      Downloading-Spring-artifacts

 29
SpringSource on GitHub




            github.com/SpringSource
30
SpringSource on GitHub
•        Spring Integration moved August 2011
•        Spring Framework moved December 2011
•        Spring Web Flow recently moved
•        All major projects now on GitHub




    31
Benefits of GitHub
•        Accessible UI built around Git
•        Well known open source code repository
•        Code browsing
•        Commit history
•        Community contributions
•        Issue tracking
•        Wiki pages



    32
Contributing




     support.springsource.com/spring_committer_signup
33
Fork the Repository
• Navigate to github.com/SpringSource/<project>
• Select the         button
• Select your local GitHub account as the destination




 34
Local Development Environment
$ git clone git@github.com:<username>/<project>.git
$ cd <project>
$ git remote add upstream git@github.com:SpringSource/
<project>.git
$ git fetch --all
$ git remote show
$ git branch -a




 35
Submitting a Pull Request
• Create a new topic branch based on issue number
$ git checkout -b <project>-123

• Complete your changes
• Push your branch to origin
$ git push origin <project>-123

• Select              when you are ready to submit your
  code to the project lead for review
 36
Successful Pull Requests
• Please note that all pull requests must be able to be
  cleanly merged with the upstream master’s current state
• Rebase with Master

 $ git pull --rebase upstream master




 37
Code Reviews




38
Code Reviews
•        Comment on each commit or on individual lines
•        Markdown supported
•        Comments trigger notifications (@user notation)
•        Pull Requests can be comprised of multiple commits
•        Compare code between commits or branches
•        Contributors and Committers follow same process!

                   GitHub Pull Request = Code + Issue + Code Comments



    39
Jürgenization


40
More Information
• github.com/SpringSource/spring-framework/wiki/
  Contributor-guidelines
• github.com/SpringSource/spring-integration/wiki/
  Contributor-Guidelines
• help.github.com/articles/fork-a-repo
• help.github.com/articles/using-pull-requests




 41
More Information
• Pro Git: Contributing to a Project
  http://git-scm.com/book/ch5-2.html

• Pro Git: Rebasing
  http://git-scm.com/book/ch3-6.html

• McCullough and Berglund on Mastering Git
  http://shop.oreilly.com/product/0636920017462.do


 42
Cloud Foundry Code Reviews




43
44
Gerrit
•        Originally developed at Google
•        Web based code review and project management for Git
•        Shows changes in a side-by-side display
•        Allows inline comments by reviewers
•        Authorized users can initiate merges




    45
Recommendation
• Try GitHub first
• Consider Gerrit




 46
More Information
• code.google.com/p/gerrit




 47
Community
•        www.springsource.org
•        blog.springsource.org
•        twitter.com/springsource
•        twitter.com/springframework
•        forum.springsource.org
•        stackoverflow.com/questions/tagged/spring




    48
More Sessions
• Gradle the Innovation Continues - Hans Dockter
• Standardizing your Enterprise Build Environment with
  Gradle - Luke Daley
• Gradle Plugin Best Practices - Luke Daley
• Building an Integration Platform with Grails and Gradle -
  Brian Saville




 49
Q&A

Spring Projects Infrastructure

  • 1.
    Spring Projects Infrastructure Roy Clarkson, Spring for Android/Mobile Project Lead Gunnar Hillert, Spring Integration Twitter/GitHub: @royclarkson, @ghillert © 2012 SpringOne 2GX. All rights reserved. Do not distribute without permission.
  • 2.
  • 3.
    What is Spring? Spring Mobile Spring Gemfire Spring AMQP Spring for Android Spring Hadoop Spring Batch Spring Framework Spring Social Spring .NET Spring Integration Spring Security Spring Data Spring Shell Spring Web Flow Spring Roo 6
  • 4.
    Agenda • Issue Tracking • Build • Continuous Integration/Deployment • Repositories • Source Control • Community Contributions 4
  • 5.
  • 6.
    Issue Tracking • Submit bug reports • Request features • Vote for issues • Provide feedback • Track status • Watch issues 6
  • 7.
    Lifecycle of anIssue • Unassigned • Waiting For Triage • Triaged • In Progress • Resolved • Closed 7
  • 8.
  • 9.
  • 10.
    Gradle Hello World task hello { doLast { println 'Hello world!' } } 10
  • 11.
  • 12.
    Building Spring $ gitclone git://github.com/SpringSource/ spring-framework.git $ cd spring-framework $ ./gradlew build 12
  • 13.
    Projects using Gradle • Spring Framework (since Jan 2012) • Spring Integration (since Oct 2010) • Spring AMQP (since Jun 2012) • Spring for Android (since May 2011) • Spring Mobile (since Nov 2010) • Spring Social (since Oct 2010) • And more … 13
  • 14.
    Gradle • Version 1.2 released 2012-09-12 • Gradle Wrapper • Maven-like defaults • More concise than Maven • Scripting capabilities like Ant • Supports multi-project builds • Dependency management based on Apache Ivy • Build scripts written in Groovy 14
  • 15.
    Common Tasks forSpring Projects • clean – Deletes the build directory • build – Assembles and tests this project • dist – Creates Zip (Jars, Reference, Api Doc, Schema) • api – Generates aggregated Javadoc API documentation • reference – Generates HTML and PDF documentation • install – Install archives artifacts into local .m2 cache • eclipse – Generates all Eclipse files • idea – Generates IDEA project files • sonarAnalyze – Gather Sonar Metrics 15
  • 16.
  • 17.
    Spring Tool Suite •Gradle Support since 2.7.0 • Import Gradle projects directly into STS • static.springsource.org/sts/docs/latest/reference/html/ gradle 17
  • 18.
    IntelliJ IDEA • GradleSupport in IntelliJ IDEA 11 • www.jetbrains.com/idea/webhelp/gradle-2.html • confluence.jetbrains.com/display/IDEADEV/News 18
  • 19.
  • 20.
  • 21.
    Bamboo Features • Continuous Integration • Highly Configurable • Instant Feedback • Continuous Deployment • Release Management • JIRA Integration • Plugin Support 21
  • 22.
  • 23.
  • 24.
  • 25.
    SpringSource Artifactory • Replaces previous Maven repositories • GA releases still available in Maven Central • Unified search • Put a watch on anything • License information • Transitive resolution • Release process 25
  • 26.
    SpringSource Repository repo.springsource.org 26
  • 27.
    SpringSource Repository • LocalRepositories – libs-snapshot-local, libs-milestone-local, libs-release-local • Virtual Repositories – snapshot, milestone, release • Virtual Repositories with Third-Party Support – libs-snapshot, libs-milestone, libs-release 27
  • 28.
    Maven <repository> <id>springsource-release</id> <name>SpringSource Release Repository</name> <url>http://repo.springsource.org/libs-release</url> </repository> <repository> <id>springsource-milestone</id> <name>SpringSource Milestone Repository</name> <url>http://repo.springsource.org/libs-milestone</url> </repository> <repository> <id>springsource-snapshot</id> <name>SpringSource Snapshot Repository</name> <url>http://repo.springsource.org/libs-snapshot</url> </repository> 28
  • 29.
    More Information • SpringRepository FAQ github.com/SpringSource/spring-framework/wiki/ SpringSource-repository-FAQ • Downloading Spring Artifacts github.com/SpringSource/spring-framework/wiki/ Downloading-Spring-artifacts 29
  • 30.
    SpringSource on GitHub github.com/SpringSource 30
  • 31.
    SpringSource on GitHub • Spring Integration moved August 2011 • Spring Framework moved December 2011 • Spring Web Flow recently moved • All major projects now on GitHub 31
  • 32.
    Benefits of GitHub • Accessible UI built around Git • Well known open source code repository • Code browsing • Commit history • Community contributions • Issue tracking • Wiki pages 32
  • 33.
    Contributing support.springsource.com/spring_committer_signup 33
  • 34.
    Fork the Repository •Navigate to github.com/SpringSource/<project> • Select the button • Select your local GitHub account as the destination 34
  • 35.
    Local Development Environment $git clone git@github.com:<username>/<project>.git $ cd <project> $ git remote add upstream git@github.com:SpringSource/ <project>.git $ git fetch --all $ git remote show $ git branch -a 35
  • 36.
    Submitting a PullRequest • Create a new topic branch based on issue number $ git checkout -b <project>-123 • Complete your changes • Push your branch to origin $ git push origin <project>-123 • Select when you are ready to submit your code to the project lead for review 36
  • 37.
    Successful Pull Requests •Please note that all pull requests must be able to be cleanly merged with the upstream master’s current state • Rebase with Master $ git pull --rebase upstream master 37
  • 38.
  • 39.
    Code Reviews • Comment on each commit or on individual lines • Markdown supported • Comments trigger notifications (@user notation) • Pull Requests can be comprised of multiple commits • Compare code between commits or branches • Contributors and Committers follow same process! GitHub Pull Request = Code + Issue + Code Comments 39
  • 40.
  • 41.
    More Information • github.com/SpringSource/spring-framework/wiki/ Contributor-guidelines • github.com/SpringSource/spring-integration/wiki/ Contributor-Guidelines • help.github.com/articles/fork-a-repo • help.github.com/articles/using-pull-requests 41
  • 42.
    More Information • ProGit: Contributing to a Project http://git-scm.com/book/ch5-2.html • Pro Git: Rebasing http://git-scm.com/book/ch3-6.html • McCullough and Berglund on Mastering Git http://shop.oreilly.com/product/0636920017462.do 42
  • 43.
  • 44.
  • 45.
    Gerrit • Originally developed at Google • Web based code review and project management for Git • Shows changes in a side-by-side display • Allows inline comments by reviewers • Authorized users can initiate merges 45
  • 46.
    Recommendation • Try GitHubfirst • Consider Gerrit 46
  • 47.
  • 48.
    Community • www.springsource.org • blog.springsource.org • twitter.com/springsource • twitter.com/springframework • forum.springsource.org • stackoverflow.com/questions/tagged/spring 48
  • 49.
    More Sessions • Gradlethe Innovation Continues - Hans Dockter • Standardizing your Enterprise Build Environment with Gradle - Luke Daley • Gradle Plugin Best Practices - Luke Daley • Building an Integration Platform with Grails and Gradle - Brian Saville 49
  • 50.