QuickBuild 1.2.0 User's Guide
QuickBuild 1.2.0 User's Guide
Copyright © 2005-2007 PMEase Inc.
Table of Contents
1. Introduction
Background
Basic concepts
Configuration
Build
Repository
Builder
Notifier
Step
Login mappings
Schedule
Triggering instance
Build queue
Build promotion
Configuration working directory
Configuration checkout directory
Configuration publish directory
Build publish directory
Build artifacts directory
Build JUNIT html report directory
Build Clover html report directory
2. User interface
Dashboard
Configurations
Build queues
Find builds
Manage groups
Manage users
Manage subscriptions
3. Configure repositories
Configure Base Clearcase
Configure Clearcase UCM repository
Configure CVS repository
Configure File system repository
Configure Perforce repository
Configure Perforce repository using template
Configure Subversion repository
Configure Visual Sourcesafe repository
Configure StarTeam repository
Configure Accurev repository
Configure QuickBuild repository
The dummy repository
4. Configure builders
Configure Ant/NAnt builder
Configure Maven/Maven2 builder
Configure Rake builder
Configure Command builder
The dummy builder
5. Configure notifiers
Configure Email notifier
Configure MSN Messenger notifier
Configure Jabber notifier
Configure Google Talker notifier
The dummy notifier
Configure subscription notifiers
6. Configure steps
Configure step "
Checkout
"
Configure step "
Build
"
Configure step "
Publish artifacts
"
Configure step "
Label checked out code
"
Configure step "
Label promotion
"
Configure step "
Send notification
"
Configure step "
Trigger build in another configuration
"
Configure step "
Fail current step conditionally
"
Configure step "
Evaluate velocity template
"
Configure step "
Fix text files eol/eof characters
"
Configure step "
Change file permissions
"
Configure step "
Serial composition
"
Configure step "
Parallel composition
"
The dummy step
7. Security
Account management
Administrator account
User management
Authenticator management
LDAP Authenticator
LDAP Authenticator (self binding)
Permission management
Set queue permissions
Set configuration permissions
Enable anonymous access and user self-registering
Trust public key of other servers
Secure QuickBuild through https (http over SSL)
8. Remote and parallel build support
Mechanism
Deadlock prevention
9. Data management
Backup and restore database
Database auto-backup
Data migration between different databases
Migrating data from QuickBuild PREVIEW2 and PREVIEW3
Migrating data from Luntbuild 1.2.x and 1.3.x
10. Build promotion
11. Remote API
12. Use cases
Basic use cases
Working with your first build
Working with Maven
Working with project dependencies
Trigger other builds after build of a particular project
Working with multiple branches
Working with configuration inheritance and overriding
Sharing working directories
Sharing build versions
Using date and iteration as part of build version
Managing major, minor, and iteration part of the version string
Specifying label to build against
Updating information for many projects
Working with build queues
Working with public configurations
Working with RSS
Real-time continuous integration use cases
Set up real-time continuous integration for CVS
Set up real-time continuous integration for Subversion
Remote and parallel use cases
Building multi-platform products
Working with parallel builds
Performing automation/smoke tests on a machine other than the build machine
LDAP authentication use cases
Authenticate using Microsoft Active Directory and retrieve user group information
Authenticate using Microsoft Active Directory, but manage user group relationship in QuickBuild
Authenticate uing Fedora Directory Server and retrieve user role information
Build promotion use cases
Promote build from one configuration into another
Promote build from one configuration into another and re-label the source code with new version
Run additional steps to further process an existing build (for example, deploy an existing build)
Promote build from one configuration into another by constructing the new build from the source code of source build.
Build notification use cases
Subscribe to configurations and get notified of new builds
Get notified of manually triggered build
Send build notification to dynamic list of users
Get build notification through RSS
Repository specific use cases
Monitor particular StarTeam promotion state, and trigger new build if new label detected for that state
Promote the build label at StarTeam side automatically when build is promoted from one configuration into another at QuickBuild side
Monitor ClearCase UCM latest baselines, and trigger new build if latest baselines has been changed
A. OGNL expressions
B. Velocity templates
C. Special variables
futureversion_verification_expression
All variables with the prefix "notification_group."
D. URL to published artifacts
List of Tables
3.1.
Date/Time format characters
7.1.
Configuration permissions
