Hudson
Hudson continuous integration server
Overview
Hudson:
Hudson continuous integration server
Design
- Super Type
- ContinuousIntegration
| Role | Concrete. (Objects can be created.) |
| Instance Names | Unique |
| Notification | false |
| Template Directory | |
| Data View | Children, proximity: 1 |
| Logger Name | Hudson |
Constraints
Allowed Child Dependencies
- Builder
- HudsonAjpPort 1
- HudsonHttpPort 1
- HudsonHttpsPort 1
- HudsonJavaHome 1
- HudsonPlugin
- HudsonWar 1
1: These types have a Singleton constraint. Only one instance may be added as a resource.
Allowed Parent Dependencies
- Node
- Site
Attributes
Exported Attributes
| Name | Property |
|---|---|
| hudsonHome | deployment-basedir |
Defaults for Imported Attributes
| Name | Default |
|---|---|
| hudsonAdminAddress | build@localhost |
| hudsonAjpPort | 1100 |
| hudsonDefaultMailSuffix | |
| hudsonHttpPort | 8081 |
| hudsonHttpsPort | -1 |
| hudsonJavaHome | ${env.JAVA_HOME} |
| hudsonPollSpec | */5 * * * * |
| hudsonSmtpHost |
Commands
assertServiceIsDown
checks if process is down
Uses the process list to determine if a hudson out of this instance's HUDSON_HOME is running. Returns true if not.
- Usage
- assertServiceIsDown [-hudsonHome <>] [-javaHome <>]
Options
| Option | Description |
|---|---|
| hudsonHome | Hudson working directory |
| javaHome | Location of Java to use for Hudson winstone container |
assertServiceIsUp
checks if process is running
Uses the process list to determine if a hudson out of this instance's HUDSON_HOME is running. Prints the pid and returns true if yes.
- Usage
- assertServiceIsUp [-hudsonHome <>] [-javaHome <>]
Options
| Option | Description |
|---|---|
| hudsonHome | Hudson working directory |
| javaHome | Location of Java to use for Hudson winstone container |
startService
start the service process
Uses nohup to start the Hudson service.
- Usage
- startService [-hudsonAjpPort <>] [-hudsonHome <>] [-hudsonHttpPort <>] [-hudsonHttpsPort <>] [-javaHome <>]
Options
| Option | Description |
|---|---|
| hudsonAjpPort | Hudson ajp13 port |
| hudsonHome | Hudson working directory |
| hudsonHttpPort | Hudson web port |
| hudsonHttpsPort | Hudson secure web port |
| javaHome | Location of Java to use for Hudson winstone container |
stopService
stops the service process
Uses the process list to identify the pid of Hudson and kills it. NOTE: No verification of kill is currently done; to be implemented.
- Usage
- stopService [-hudsonHome <>] [-javaHome <>]
Options
| Option | Description |
|---|---|
| hudsonHome | Hudson working directory |
| javaHome | Location of Java to use for Hudson winstone container |
Docs-Generate
Generates Hudson configuration files based on builders
Generates the main Hudson configuration and the configuration for any child builders.
- Usage
- Docs-Generate [-hudsonHome <${entity.attribute.hudsonHome}>]
Options
| Option | Description |
|---|---|
| hudsonHome | Hudson working directory |
Related Types
The following types are defined for use with Hudson.
HudsonSetting
Overview
HudsonSetting:
Hudson configuration setting
Design
- Super Type
- Setting
| Role | Abstract. (Objects cannot be created.) |
| Instance Names | Unique |
HudsonJavaHome
Overview
HudsonJavaHome:
Java installation used to run Hudson
The JAVA_HOME to use to run Hudson. Default is ${env.JAVA_HOME}
Design
- Super Type
- HudsonSetting
| Role | Concrete. (Objects can be created.) |
| Instance Names | Unique |
Attributes
Exported Attributes
| Name | Property |
|---|---|
| hudsonJavaHome | settingValue |
HudsonHttpPort
Overview
HudsonHttpPort:
Hudson web port
The port to use for the Hudson web interface. Default is >8081. To disable, use -1.
Design
- Super Type
- HudsonSetting
| Role | Concrete. (Objects can be created.) |
| Instance Names | Unique |
Attributes
Exported Attributes
| Name | Property |
|---|---|
| hudsonHttpPort | settingValue |
HudsonHttpsPort
Overview
HudsonHttpsPort:
Hudson secure web port
The port to use for the Hudson secure web interface. Default is -1, which indicates disabled. To enable, set a port number such as 8444.
Design
- Super Type
- HudsonSetting
| Role | Concrete. (Objects can be created.) |
| Instance Names | Unique |
Attributes
Exported Attributes
| Name | Property |
|---|---|
| hudsonHttpsPort | settingValue |
HudsonAjpPort
Overview
HudsonAjpPort:
Hudson ajp13 port
The port to use for an AJP13 connection. Default is 1100. To disable, use -1.
Design
- Super Type
- HudsonSetting
| Role | Concrete. (Objects can be created.) |
| Instance Names | Unique |
Attributes
Exported Attributes
| Name | Property |
|---|---|
| hudsonAjpPort | settingValue |
HudsonPollSpec
Overview
HudsonPollSpec:
Hudson SCM polling schedule specification (cron-style)
How often to poll the source repository for changes, in cron format. Defaults to 5 minutes.
Design
- Super Type
- HudsonSetting
| Role | Concrete. (Objects can be created.) |
| Instance Names | Unique |
Attributes
Exported Attributes
| Name | Property |
|---|---|
| hudsonPollSpec | settingValue |
HudsonDefaultMailSuffix
Overview
HudsonDefaultMailSuffix:
Default mail suffix
What to append to unqualified addresses; e.g. a suffix of '@company.com' would make 'mlei' -> 'mlei@company.com'. Does not change qualified addresses such as myname@domain.com. Defaults to blank.
Design
- Super Type
- HudsonSetting
| Role | Concrete. (Objects can be created.) |
| Instance Names | Unique |
Attributes
Exported Attributes
| Name | Property |
|---|---|
| hudsonDefaultMailSuffix | settingValue |
HudsonAdminAddress
Overview
HudsonAdminAddress:
Email address of Hudson administrator
Defaults to build@localhost
Design
- Super Type
- HudsonSetting
| Role | Concrete. (Objects can be created.) |
| Instance Names | Unique |
Attributes
Exported Attributes
| Name | Property |
|---|---|
| hudsonAdminAddress | settingValue |
HudsonSmtpHost
Overview
HudsonSmtpHost:
Hostname of SMTP server to use for notification emails
Defaults to blank. Hudson uses localhost if this value is not specified.
Design
- Super Type
- HudsonSetting
| Role | Concrete. (Objects can be created.) |
| Instance Names | Unique |
Attributes
Exported Attributes
| Name | Property |
|---|---|
| hudsonSmtpHost | settingValue |