日本語 : Features controlled by system properties

オリジナル: Features controlled by system properties

Jenkins Features Controlled with System Properties

Jenkinsにはいくつかの"隠し"機能があり、システムプロパティで有効にできます。システムプロパティは、-Dproperty=valuejavaコマンドラインに渡してJenkinsを開始することで設定されます。これらの引数は、全て引数-jarで渡すことに注意してください。そうではない場合、それらは無視されます。

例:

java -Dhudson.footerURL=http://example.org -jar jenkins.war

以下は、プロパティとそれらが導入されたJenkinsのバージョンの一覧です。

  • プロパティ - Javaプロパティ名
  • デフォルト - 明示的に指定しない場合のデフォルト値
  • バージョン - このプロパティが導入されたJenkinsのバージョン
  • 備考 - その他の覚書

プロパティ

デフォルト

バージョン

備考

hudson.ClassicPluginStrategy.useAntClassLoader

false

1.316

 

hudson.consoleTailKB

150

 

How many KB of console log to show in default console view

hudson.diagnosis.HudsonHomeDiskUsageChecker.freeSpaceThreshold

1073741824

1.339

The notification threshold for when the Hudson home directory is running low on disk space, in bytes

hudson.diyChunking

false

 

Set to true if the servlet container doesn't support chunked encoding

hudson.DNSMultiCast.disabled

false

1.359

Set to "true" to disable DNS multicast

hudson.footerURL

http://jenkins-ci.org/

1.416

Allows tweaking the URL displayed at the bottom of Jenkins' UI

hudson.Functions.autoRefreshSeconds

10

1.365

Number of seconds between reloads when Auto Refresh is enabled

hudson.lifecycle

 

 

Specify full class name for Lifecycle implementation to override default

hudson.matrix.MatrixConfiguration.useShortWorkspaceName

false

 

Use shorter but cryptic names to avoid 256 character limit on paths in Cygwin

hudson.model.DownloadService.never

false

 

Suppress the periodic download of data files for plugins

hudson.model.Hudson.flyweightSupport

was:false
1.337:true

1.318

Matrix parent job won't consume an executor when true

hudson.model.Hudson.killAfterLoad

false

 

Exit Jenkins right after loading

hudson.model.Hudson.logStartupPerformance

false

 

Log startup timing info

hudson.model.Hudson.parallelLoad

true

 

Loads job configurations in parallel on startup

hudson.model.LoadStatistics.clock

10000

 

Load statistics clock cycle in milliseconds

hudson.model.LoadStatistics.decay

0.9

 

Decay ratio for every clock cycle in node utilization charts

hudson.model.MultiStageTimeSeries.chartFont

SansSerif-10

1.562

Font used for load statistics (see Java documentation on how the value is decoded)

hudson.model.Queue.cacheRefreshPeriod

1000

1.577

Defines the refresh period for the internal queue cache (in milliseconds). The greater period workarounds web UI delays on large installations, which may be caused by locking of the build queue by build executors. Downside - builds appear in the queue with a noticeable delay.

hudson.model.Run.ArtifactList.listCutoff

16

1.330

More artifacts than this will use tree view or simple link rather than listing out artifacts

hudson.model.Run.ArtifactList.treeCutoff

40

1.330

More artifacts than this will show a simple link to directory browser rather than showing artifacts in tree view

hudson.model.Slave.workspaceRoot

workspace

1.341?

name of the folder within the slave root directory to contain workspaces

hudson.model.UpdateCenter.never

false

 

When true, don't automatically check for new versions

hudson.model.WorkspaceCleanupThread.disabled

false

 

Don't clean up old workspaces on slave nodes

hudson.os.solaris.ZFSInstaller.disabled

false

 

True to disable ZFS monitor on Solaris

hudson.remoting.FlightRecorderInputStream.BUFFER_SIZE

1048576

1.563

Size (in bytes) of the flight recorder ring buffer used for debugging remoting issues

hudson.remoting.Launcher.pingIntervalSec

600

1.367

Seconds between ping checks to monitor health of slave nodes; 0 to disable ping

hudson.remoting.Launcher.pingTimeoutSec

240

1.367

If ping of slave node takes longer than this, consider it dead; 0 to disable ping

hudson.PluginStrategy

 

 

Allow plugins to be loaded into a different environment, such as an existing DI container like Plexus; specify full class name here to override default ClassicPluginStrategy

hudson.scheduledRetention

false

Up to 1.354

Control a slave based on a schedule

hudson.scm.CVSSCM.skipChangeLog

false

 

Useful with ancient versions of CVS that don't support the -d option in the log command

hudson.security.csrf.requestfield

.crumb

1.310

Parameter name that contains a crumb value on POST requests

hudson.security.ArtifactsPermission

false

1.374

The Artifacts permission allows to control access to artifacts; When this property is unset or set to false, access to artifacts is not controlled

hudson.security.ExtendedReadPermission

false

1.324

The ExtendedReadPermission allows read-only access to adminstrative pages; can also enable with extended-read-permission plugin

hudson.security.WipeOutPermission

false

1.416

The WipeOut permission allows to control access to the "Wipe Out Workspace" action, which is normally available as soon as the Build permission is granted

hudson.security.LDAPSecurityRealm.groupSearch

Mouseover

 

LDAP filter to look for groups by their names

hudson.slaves.ChannelPinger.pingInterval

5

1.405

Frequency (in minutes) of pings between the master and slaves

hudson.slaves.WorkspaceList

@

1.424

When concurrent builds is enabled, a unique workspace directory name is required for each concurrent build. To create this name, this token is placed between project name and a unique ID, e.g. "my-project@123".

hudson.tasks.ArtifactArchiver.warnOnEmpty

false

 

When true, builds don't fail when there is nothing to archive

hudson.tasks.Fingerprinter.enableFingerprintsInDependencyGraph

false

1.430

When true, jobs associated through fingerprints are added to the dependency graph, even when there is no configured upstream/downstream relationship between them.

hudson.tasks.MailSender.maxLogLines

250

 

Number of lines of console output to include in emails

hudson.TcpSlaveAgentListener.hostName

n/a (same as web)

1.445

Change the host name CLI should connect to, e.g. when Jenkins UI is accessed through reverse proxy on other host

hudson.TreeView

false

 

Experimental nested views feature

hudson.triggers.SCMTrigger.starvationThreshold

1 hour

 

Milliseconds waiting for polling executor before trigger reports it is clogged

hudson.udp

33848

 

Port for UDP multicast broadcast (set to -1 to disable)

hudson.upstreamCulprits

false

1.327

Pass blame information to downstream jobs

hudson.Util.noSymLink

false

 

True to disable creation of symbolic links in job/builds directories

hudson.util.ProcessTree.disable

false

 

True to disable cleanup of child processes

hudson.util.RingBufferLogHandler.defaultSize

256

1.563

Number of log entries in loggers available on the UI at /log/

hudson.util.Secret.provider

 

1.360

Force a particular crypto provider; with Glassfish Enterprise set value to SunJCE to workaround a known issue.

hudson.Util.symlinkEscapeHatch

false

 

True to use exec of "ln" binary to create symbolic links instead of native code

jenkins.security.FrameOptionsPageDecorator.enabled

true

1.581

Whether to send X-Frame-Options: sameorigin header, set to false to disable and make Jenkins embeddable

jenkins.InitReactorRunner.concurrency

2x of CPU

 

During start of Jenkins, loading of jobs in parallel have a fixed number of threads by default (twice the CPU). To make Jenkins load time 8x faster, increase it to 8x. For example, 24 CPU Jenkins Master host use this: -Dhudson.InitReactorRunner.concurrency=192

No compatibility guarantee

In general, these switches are often experimental in nature, and subject to change without notice. If you find some of those useful, please file a ticket to promote it to the official feature.