This document introduces Apache Yetus, a pre-commit system for Apache HBase that runs tests and checks on code changes. It has personalities to add framework-specific tests for HBase. Yetus outputs a vote table and failure details in log files. The document provides guidance on interpreting Yetus output and using it to validate patches in various code branches and against different Java versions. Yetus is still in a version 0 release but aims to standardize pre-commit testing for Apache projects.

1. Apache Yetus: Intro to Precommit for Apache HBase
Contributors
Allen Wittenauer
Effective Machines
Apache HBase Meetup 2016-05-23

2. ! email: aw @ effectivemachines.com, aw @ apache.org
! github: aw-was-here
! gitlab: _a__w_
! slideshare: allenwittenauer
! twitter: @_a__w_ ( 1 a 2 w 1 )
22016-05-23

3. WARNING!
Apache Yetus is still a "version-0". This means bits
will likely change in newer releases. This
presentation is for v0.3.0 primarily.

4. Driver
Personality Bug Systems Build Tools Tests
Language
Support
Static Analysis
Unit Tests
Test Log
Processing
4

5. Apache HBase Personality
! Dictates the defaults
! Two available
– Bundled with Apache Yetus
– Bundled with Apache HBase (dev-support/hbase-personality.sh)
! For details on using test-patch manually, see:
– https://yetus.apache.org/documentation/0.3.0/precommit-basic/
! Adds several Apache HBase-specific tests
– hadoopcheck = compile against various Apache Hadoop versions
– hbaseprotoc = checks for protobuf problems
– hbaseanti = checks for Apache HBase source anti-patterns
! (e.g., using Apache Hadoop annotations)

6. Patch Naming Conventions
JIRA Project
and Issue
Number
Branch Revision Patch Filename
HBASE-55 Master 0 HBASE-55.000.patch
HBASE-55 Master 3 HBASE-55.003.patch
HBASE-55 branch-1 0 HBASE-55-branch-1.000.patch
HBASE-55 branch-1.2 2 HBASE-55.branch-1.2.002.patch
HBASE-55 branch-1 2 HBASE-55.branch-1.2.patch ??

7. Output Anatomy: Vote Table
Precheck
Compile Cycle
(Branch)
Compile Cycle
(Patch)
Unit and
other Tests

8. Output Anatomy: Footer
Configura=on
Informa=on
More info
on Failures

9. Log Files are the Key
! Located in --patch-dir/Jenkins artifact dir/linked in footer
! Three kinds
– Full logs of maven runs
– Individual test logs
– Diffs of pre- and post- runs
! Tell them apart:
– "Before": branch-*
– "After": patch-*
– diffs of the two: diff-*
– Maven module
– JDK version (multijdk mode)
! Generics lack -fixes

10. Administrivia
! Website: https://yetus.apache.org
! Mailing list: dev@yetus.apache.org
! Twitter: @ApacheYetus
! Current Release: 0.3.0 (2016-05-23)
! Yetus is an archaic synonym of the Cymbium genus of gastropods
! First ASF TLP with a ‘Y’
102016-05-23