The following plugin provides functionality available through Pipeline-compatible steps. Read more about how to integrate steps into your Pipeline in the Steps section of the Pipeline Syntax page.

For a list of other such plugins, see the Pipeline Steps Reference page.

Anka Plugin

View this plugin on the Plugins site

ankaGetSaveImageResult: Wait for previous save image requests results

  • shouldFail : boolean
  • timeoutMinutes : int

createDynamicAnkaNode: create dynamic anka node

  • masterVmId : String (optional)
  • SSHPort : int (optional)
  • cloudName : String (optional)
  • credentialsId : String (optional)
  • deleteLatest : boolean (optional)
  • description : String (optional)
  • dontAppendTimestamp : boolean (optional)
  • environments (optional)
      Array / List of Nested Object
    • name : String
    • value : String
  • extraArgs : String (optional)
  • group : String (optional)
  • javaArgs : String (optional)
  • jnlpJenkinsOverrideUrl : String (optional)
  • jnlpTunnel : String (optional)
  • keepAliveOnError : boolean (optional)
  • labelString : String (optional)
  • launchDelay : int (optional)
  • launchMethod : String (optional)
  • mode (optional)
    • Values: NORMAL, EXCLUSIVE
  • nameTemplate : String (optional)
  • numberOfExecutors : int (optional)
  • priority : int (optional)
  • pushTag : String (optional)
  • remoteFS : String (optional)
  • retentionStrategy (optional)
      Nested Choice of Objects
    • agent-maintenance
      Take this agent offline during dedicated time windows, e.g. due to maintenance activities. Outside of an active maintenance window, the "Regular Availability" is applied.
      Exact behaviour what to do with running builds can be individually defined for each maintenanance window.
      • regularRetentionStrategy
        • Type: hudson.slaves.RetentionStrategy<hudson.slaves.SlaveComputer>
    • $class: 'AlmostAlways'
      • always
        • $class: 'AzureVMCloudOnceRetentionStrategy'
          • $class: 'AzureVMCloudPoolRetentionStrategy'
            • retentionInHours : int
              Retention time define the time of hour before automatically deleting since the agent created. Specify 0 means agents won't be deleted automatically.
            • poolSize : int
              Pool size define the number of agent you want to maintain.
            • bufferPercentage : int (optional)
              Percentage of busy machines to keep as buffer (0-100).

              For example, if 10 machines are currently busy and buffer percentage is 20%, the plugin will try to maintain 2 additional idle machines as buffer.

              The buffer is also calculated based on queue length - whichever produces a larger buffer (busy machines % or queued jobs %) will be used.

              Default: 10%

            • dynamicBufferEnabled : boolean (optional)
              Enable dynamic buffer sizing based on current workload.

              When enabled, the plugin will automatically maintain additional idle machines (buffer) proportional to the number of busy machines and queued jobs. This ensures that new jobs always have machines ready immediately.

              The effective pool size becomes: poolSize + calculatedBuffer

            • maximumBuffer : int (optional)
              Maximum buffer size to prevent runaway scaling.

              Limits how many buffer machines can be created, regardless of the percentage calculation. This helps control costs during sudden spikes in workload.

              Set to 0 or leave empty for no maximum limit (unlimited buffer scaling).

              Default: 0 (no limit)

            • minimumBuffer : int (optional)
              Minimum number of buffer machines to always have ready.

              Regardless of the percentage calculation, at least this many idle machines will be maintained as buffer. This ensures a baseline level of readiness even when no jobs are running.

              Set to 0 to disable minimum buffer requirement.

              Default: 0

            • singleUseAgents : boolean (optional)
              If enabled, agents are deleted after a single job is run. It is suggested to set retention time to 0 if this is enabled.
          • azureVMCloudRetentionStrategy
            • idleTerminationMinutes : int
          • $class: 'ContainerIdleRetentionStrategy'
            • idleMinutes : int
          • $class: 'ContainerOnceRetentionStrategy'
            • demand
              • inDemandDelay : long
              • idleDelay : long
            • $class: 'DockerCloudRetentionStrategy'
              • idleMinutes : int
                Number of minutes of idleness after which to kill the slave; serves a backup in case the strategy fails to detect the end of a task
            • $class: 'DockerSwarmAgentRetentionStrategy'
              • timeout : int
            • $class: 'IdleTimeCloudRetentionStrategy'
              • idleMinutes : int
            • demand
              • inDemandDelay : long
              • idleDelay : long
              • conflictsWith : String (optional)

                Optional regular expression (or string in trivial case) with name(s) of node(s) whose being online blocks the current node from starting.

                To properly take advantage of this, be sure to set low idleDelay timeout values for those other workers that no longer have work pending.

                Note that conflict is evaluated one way ("should this node start if inDemandDelay has elapsed?"), so all nodes in question should declare each other as conflicting -- e.g. by copying the regular expression, if such node names follow the same pattern. In any case, a node would not conflict with itself even if there is a match.

                As with other regular expressions, "negative look-ahead" can be used to exclude certain results from the following matching pattern, e.g.:

                ^(?!myServer$)(.*erver.*)$

                This setting allows a Jenkins deployment to co-locate various pre-defined or otherwise provisioned build environments without overwhelming their host -- and instead permits round-robining, one by one.

            • schedule
              • startTimeSpec : String
              • upTimeMins : int
              • keepUpWhenActive : boolean
            • swarmRetention
              • idleMinutes : int
            • $class: 'VSphereCloudRetentionStrategy'
              • idleMinutes : int
            • $class: 'com.github.kostyasha.yad.strategy.DockerOnceRetentionStrategy'
              • idleMinutes : int
                Number of minutes of idleness after which to kill the slave; serves a backup in case the strategy fails to detect the end of a task
            • $class: 'com.nirima.jenkins.plugins.docker.strategy.DockerOnceRetentionStrategy'
              • idleMinutes : int
                Number of minutes of idleness after which to kill the agent; serves a backup in case the strategy fails to detect the end of a task
              • numberOfTasksInProgress : int (optional)
              • terminateOnceDone : boolean (optional)
            • ankaRunOnceCloud
              • idleMinutes : int
            • $class: 'io.jenkins.plugins.orka.RunOnceCloudRetentionStrategy'
              • idleMinutes : int
            • $class: 'org.jenkinsci.plugins.vsphere.RunOnceCloudRetentionStrategy'
              • idleMinutes : int
          • saveImage : boolean (optional)
          • suspend : boolean (optional)
          • tag : String (optional)
          • templateDescription : String (optional)
          • templateId : String (optional)
          • timeout : int (optional)
          • vcpu : int (optional)
          • vram : int (optional)

          Was this page helpful?

          Please submit your feedback about this page through this quick form.

          Alternatively, if you don't wish to complete the quick form, you can simply indicate if you found this page helpful?

              


          See existing feedback here.