Hacking on WildFly 9
1 like2,072 views
Presentation delivered by Darran Lofthouse, Principal Software Engineer, Red Hat & Kabir Khan, Principal Software Engineer, Red Hat, during London JBoss User Group event on the 21st of May 2014.
More Related Content
What's hot (20)
Viewers also liked (10)
Similar to Hacking on WildFly 9 (20)
More from JBUG London (11)
Recently uploaded (20)
Hacking on WildFly 9
- 1. Hacking on WildFly 9 Darran Lofthouse, Principal Software Engineer, Red Hat [email protected] Kabir Khan, Principal Software Engineer, Red Hat [email protected]
- 2. Agenda • Getting set up • Open source community • Useful Maven tricks • Fix a bug
- 3. GitHub, Build, IDE Getting set up
- 4. GitHub • Log in to www.github.com • Set up local git + SSH as described in • https://help.github.com/articles/set-up-git • https://help.github.com/articles/generating-ssh-keys • Wildfly @ https://github.com/wildfly/wildfly • Fork into https://github.com/londonjbug/wildfly • Clone your fork! • $git clone [email protected]:londonjbug/wildfly.git
- 5. Build • Pre-requisites: • JDK 7 • Maven 3.2+ • export $MAVEN_OPTS=-Xmx768m • Do the build • Wait! $cd checkout/folder/wildfly $mvn install
- 6. IDE Setup • IntelliJ - import as Maven project • Eclipse - Mmmm plugins! • m2e - bleeding edge • http://repository.takari.io:8081/nexus/content/sites/m2e. extras/m2e/1.5.0/N/LATEST/ • m2e-apt (optional) • Annotation processing • Logger interface implementation • http://download.jboss.org/jbosstools/builds/staging/m2e- apt/all/repo/
- 7. More than meets the eye! Open source community
- 8. What is an Open Source Community? • 99.9%(*) of people NOT involved in open source say: • Coders! * Totally made up statistic!
- 9. Open Source Community • Helping each other • Early testing of features • Bug reporting • Issue requests • Documentation • Code contributions
- 10. Forums • If you have a problem ask! • Include necessary information • Don’t post same question multiple times! • People tend to be helpful • Others might have had the same problem • Very important way for us to find out about bugs • Rapid feedback of user testing • A lot of contributors, low barrier to entry • Normally first way people get involved
- 11. Jira • Our issue tracker • Forum posts with new bugs -> Jira issue • Not a replacement for forums! • If in doubt, start in the forums • Medium volume of contributors
- 12. Documentation/Wiki • All our documentation is open for direct contribution • Less contributors
- 13. Code contributions • Find a Jira issue you would like to work on • Or create one! • Get in touch with the team • Mailing list • IRC #wildfly-dev on freenode • We’ll demo the process • Less contributors, “hardest” • But often not as hard as you might think!
- 14. jboss.org + wildfly.org • Your entry points • jboss.org - all JBoss projects • Account used for Jira/Forums etc. • wildfly.org - more relevant for WildFly • Downloads • Get Help -> Forum, Wiki, IRC • Documentation - hint, hint, you can edit ;-) • Join Us • development mailing list • http://jira.jboss.org/browse/WFLY • https://community.jboss.org/wiki/HackingOnWildFly
- 15. Time saving Useful Maven Tricks
- 16. Useful maven tricks • A full rebuild takes a long time • Want to avoid that for the code-test-code cycle • Only build a set of modules • mvn clean install -pl controller/,build • Only build a set of modules and their deps • mvn clean install -pl controller,build -am • Restart the build from a location • mvn clean install -rf controller • Can combine • mvn clean install -pl testsuite/integration/smoke -am - rf jmx/ build assembles server
- 17. • By default we run • unit test for each module • the ‘smoke’ tests • To build without running tests do • mvn clean install -DskipTests • We don’t just have ‘smoke’ tests! • mvn clean install -DallTests • Most tests are in testsuite/integration/basic • Good command to run before submitting PR: • mvn clean install -DallTests -pl testsuite/integration/basic -am Useful testsuite tricks
- 18. Debugging and submitting a PR Demo
- 19. Commands/useful stuff • build/ - assembles WF • build/target/wildfly-9.0.0.Alpha1-SNAPSHOT/ - the built WF instance • bin/ - the startup scripts • standalone.sh - start a standalone instance • standalone.conf - enable debug • domain.sh - start up a domain (more advanced…) • standalone/configuration/standalone.xml - the config of a standalone instance • domain/configuration/domain.xml and host.xml - the config of a domain and its hosts • https://docs.jboss.org/author/display/WFLY8/Getting+Started+Guide
- 20. Wrap-up • Git clone • Build & import into IDE • Found bug in Jira • Fixed bug • Opened PR • Community is more than just code!