> User Documentation Home

User Handbook
Tutorials
Resources

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.

Table of Contents

OpenShift Pipeline Jenkins Plugin

View this plugin on the Plugins site

openshiftBuild: Trigger OpenShift Build

  • bldCfg
    If you run `oc get bc` for the project listed in "nameSpace", that is the value you want to put here.
    • Type: String
  • apiURL (optional)
    • Type: String
  • authToken (optional)
    • Type: String
  • buildName (optional)
    The value here is what you supply with the --from-build option when invoking the OpenShift `oc start-build` command. It allows you to point to OpenShift build to a previously run build, and run another build with exactly the same source and destination metadata. If you do not supply a value, the plugin will generate a new OpenShift build based on the Build Configuration referenced.
    • Type: String
  • checkForTriggeredDeployments (optional)
    This flag is the toggle for turning on or off the verification that any deployments triggered by this build's output fired.
    • Type: String
  • commitID (optional)
    The value here is what you supply with the --commit option when invoking the OpenShift `oc start-build` command. It allows you to point the OpenShift build to a specific commit hash from the git-log of the source repository. If you do not supply a value, the plugin assumes the latest version from the source repository should be used.
    • Type: String
  • env (optional)
    Specify a list of environment variables to include in the build (see `oc start-build -e ...`).
      Array / List of Nested Object
    • name
      The name of the environment variable to set.
      • Type: String
    • value
      The value for the environment variable.
      • Type: String
  • namespace (optional)
    • Type: String
  • showBuildLogs (optional)
    Indicates whether the build logs get dumped to the console of the Jenkins build.
    • Type: String
  • verbose (optional)
    • Type: String
  • waitTime (optional)
    • Type: String
  • waitUnit (optional)
    • Type: String

openshiftCreateResource: Create OpenShift Resource(s)

  • jsonyaml
    The JSON or YAML formatted text that conforms to the schema for defining the various OpenShift resources.
    • Type: String
  • apiURL (optional)
    • Type: String
  • authToken (optional)
    • Type: String
  • namespace (optional)
    • Type: String
  • verbose (optional)
    • Type: String

openshiftDeleteResourceByJsonYaml: Delete OpenShift Resource(s) from JSON or YAML

  • jsonyaml
    The JSON or YAML formatted text that conforms to the schema for defining the various OpenShift resources.
    • Type: String
  • apiURL (optional)
    • Type: String
  • authToken (optional)
    • Type: String
  • namespace (optional)
    • Type: String
  • verbose (optional)
    • Type: String

openshiftDeleteResourceByKey: Delete OpenShift Resource(s) by Key

  • types
    The comma separated list of types of API objects to delete. See https://docs.openshift.org/latest/rest_api/index.html for the supported types.
    • Type: String
  • keys
    The comma separated list of keys of the API objects to delete.
    • Type: String
  • apiURL (optional)
    • Type: String
  • authToken (optional)
    • Type: String
  • namespace (optional)
    • Type: String
  • verbose (optional)
    • Type: String

openshiftDeleteResourceByLabels: Delete OpenShift Resource(s) using Labels

  • types
    The comma separated list of types of API objects to delete, where those objects have labels corresponding to the specified key/value pairs. See https://docs.openshift.org/latest/rest_api/index.html for the supported types.
    • Type: String
  • keys
    The comma separated list of keys of the labels in the API objects to delete.
    • Type: String
  • values
    The comma separated list of values of the labels in the API objects to delete.
    • Type: String
  • apiURL (optional)
    • Type: String
  • authToken (optional)
    • Type: String
  • namespace (optional)
    • Type: String
  • verbose (optional)
    • Type: String

openshiftDeploy: Trigger OpenShift Deployment

  • depCfg
    If you run `oc get dc` for the project listed in "nameSpace", that is the value you want to put here.
    • Type: String
  • apiURL (optional)
    • Type: String
  • authToken (optional)
    • Type: String
  • namespace (optional)
    • Type: String
  • verbose (optional)
    • Type: String
  • waitTime (optional)
    • Type: String
  • waitUnit (optional)
    • Type: String

openshiftExec: OpenShift Exec

  • pod
    The pod in which to execute a command.
    • Type: String
  • apiURL (optional)
    • Type: String
  • arguments (optional)
    Specify a list of arguments to pass to the command.
      Array / List of Nested Object
    • value
      The value for the environment variable.
      • Type: String
  • authToken (optional)
    • Type: String
  • command (optional)
    The name of the command to execute.
    • Type: String
  • container (optional)
    The container in which to execute a command. If not specified, the first container in the pod will be used.
    • Type: String
  • namespace (optional)
    • Type: String
  • verbose (optional)
    • Type: String
  • waitTime (optional)
    • Type: String
  • waitUnit (optional)
    • Type: String

openshiftImageStream: OpenShift ImageStreams

  • name (optional)
    The name of the ImageStream is what shows up in the NAME column if you dump all the ImageStream's with the `oc get is` command invocation.
    • Type: String
  • tag (optional)
    The specific image tag within the ImageStream to monitor.
    • Type: String
  • namespace (optional)
    • Type: String
  • apiURL (optional)
    • Type: String
  • authToken (optional)
    • Type: String
  • changelog (optional)
    Enable or Disable 'Include in changelog':

    If 'Include in changelog' is enabled for an SCM source, then when a build occurs, the changes from that SCM source will be included in the changelog.

    If 'Include in changelog' is disabled, then when a build occurs, the changes from this SCM source will not be included in the changelog.

    • Type: boolean
  • poll (optional)
    Enable or Disable 'Include in polling'

    If 'Include in polling' is enabled or 'Include in changelog' is enabled, then when polling occurs, the job will be started if changes are detected from this SCM source.

    If 'Include in polling' is disabled and 'Include in changelog' is disabled, then when polling occurs, changes that are detected from this repository will be ignored.

    • Type: boolean
  • verbose (optional)
    • Type: String

openshiftScale: Scale OpenShift Deployment

  • depCfg
    If you run `oc get dc` for the project listed in "nameSpace", that is the value you want to put here.
    • Type: String
  • replicaCount
    The value here should be the number of started pods desired for the deployment specified. It is the equivalent of the value supplied to --replicas with an `oc scale` command invocation. This is a required parameter. If an integer is not specified here, this build step can not be added to the job. Note: specifying a 0 is allowed, and means you do not want any pods for the specified deployment config running.
    • Type: String
  • apiURL (optional)
    • Type: String
  • authToken (optional)
    • Type: String
  • namespace (optional)
    • Type: String
  • verbose (optional)
    • Type: String
  • verifyReplicaCount (optional)
    This flag is the toggle for turning on or off the verification that the specified replica count for the deployment has been reached.
    • Type: String
  • waitTime (optional)
    • Type: String
  • waitUnit (optional)
    • Type: String

openshiftTag: Tag OpenShift Image

  • srcStream
    The name of the ImageStream for the existing tag.
    • Type: String
  • srcTag
    The name of the existing tag, or an actual, existing image ID. The image referenced will have the new tag applied to it.
    • Type: String
  • destStream
    One or more ImageStream names in a comma delimited list. If multiple streams and multiple destination tags are specified, the two lists must contain the same number of elements.
    • Type: String
  • destTag
    One or more tag names in a comma delimited list. If multiple streams and multiple destination tags are specified, the two lists must contain the same number of elements.
    • Type: String
  • alias (optional)
    This flag is the equivalent of the `--alias` option for the `oc tag` command. When false, the destination tag type is "ImageStreamImage", and when true, the destination tag type is "ImageStreamTag".
    • Type: String
  • apiURL (optional)
    • Type: String
  • authToken (optional)
    • Type: String
  • destinationAuthToken (optional)
    The value here is what you supply with the --token option when invoking the OpenShift `oc` command. If you do not supply a value, the plugin will assume it is running in the OpenShift Jenkins image and attempt to load the kubernetes service account token stored in that image.
    • Type: String
  • destinationNamespace (optional)
    The value here should match the value from the output from `oc project` if you created the resources related to this task from the command line. If nothing is specified, the plugin will inspect the PROJECT_NAME environment variable.
    • Type: String
  • namespace (optional)
    • Type: String
  • verbose (optional)
    • Type: String

openshiftVerifyBuild: Verify OpenShift Build

  • bldCfg
    If you run `oc get bc` for the project listed in "nameSpace", that is the value you want to put here.
    • Type: String
  • apiURL (optional)
    • Type: String
  • authToken (optional)
    • Type: String
  • checkForTriggeredDeployments (optional)
    This flag is the toggle for turning on or off the verification that any deployments triggered by this build's output fired.
    • Type: String
  • namespace (optional)
    • Type: String
  • verbose (optional)
    • Type: String
  • waitTime (optional)
    • Type: String
  • waitUnit (optional)
    • Type: String

openshiftVerifyDeployment: Verify OpenShift Deployment

  • depCfg
    If you run `oc get dc` for the project listed in "nameSpace", that is the value you want to put here.
    • Type: String
  • apiURL (optional)
    • Type: String
  • authToken (optional)
    • Type: String
  • namespace (optional)
    • Type: String
  • replicaCount (optional)
    This optional field's value represents the number expected running pods for the deployment for the DeploymentConfig specified. If no value is specified it will work the number of running pods against the desired replica count in the DeploymentConfig.
    • Type: String
  • verbose (optional)
    • Type: String
  • verifyReplicaCount (optional)
    This flag is the toggle for turning on or off the verification that the specified replica count for the deployment has been reached.
    • Type: String
  • waitTime (optional)
    • Type: String
  • waitUnit (optional)
    • Type: String

openshiftVerifyService: Verify OpenShift Service

  • svcName
    The equivalent to the name supplied to a `oc get service` command line invocation.
    • Type: String
  • apiURL (optional)
    • Type: String
  • authToken (optional)
    • Type: String
  • namespace (optional)
    • Type: String
  • retryCount (optional)
    • Type: String
  • verbose (optional)
    • Type: String

step([$class: 'OpenShiftBuildCanceller']): Cancel OpenShift Builds

  • apiURL
    • Type: String
  • namespace
    • Type: String
  • authToken
    • Type: String
  • verbose
    • Type: String
  • bldCfg
    If you run `oc get bc` for the project listed in "nameSpace", that is the value you want to put here.
    • Type: String

step([$class: 'OpenShiftDeployCanceller']): Cancel OpenShift Deployment

  • apiURL
    • Type: String
  • depCfg
    If you run `oc get dc` for the project listed in "nameSpace", that is the value you want to put here.
    • Type: String
  • namespace
    • Type: String
  • authToken
    • Type: String
  • verbose
    • Type: String

step([$class: 'OpenShiftScalerPostAction']): Scale OpenShift Deployment

  • apiURL
    • Type: String
  • depCfg
    If you run `oc get dc` for the project listed in "nameSpace", that is the value you want to put here.
    • Type: String
  • namespace
    • Type: String
  • replicaCount
    The value here should be the number of started pods desired for the deployment specified. It is the equivalent of the value supplied to --replicas with an `oc scale` command invocation. This is a required parameter. If an integer is not specified here, this build step can not be added to the job. Note: specifying a 0 is allowed, and means you do not want any pods for the specified deployment config running.
    • Type: String
  • authToken
    • Type: String
  • verbose
    • Type: String
  • verifyReplicaCount
    This flag is the toggle for turning on or off the verification that the specified replica count for the deployment has been reached.
    • Type: String
  • waitTime
    • Type: String
  • waitUnit
    • Type: String

step([$class: 'OpenShiftBuildVerifier']): Verify OpenShift Build

  • apiURL
    • Type: String
  • bldCfg
    If you run `oc get bc` for the project listed in "nameSpace", that is the value you want to put here.
    • Type: String
  • namespace
    • Type: String
  • authToken
    • Type: String
  • verbose
    • Type: String
  • checkForTriggeredDeployments
    This flag is the toggle for turning on or off the verification that any deployments triggered by this build's output fired.
    • Type: String
  • waitTime
    • Type: String
  • waitUnit
    • Type: String

step([$class: 'OpenShiftBuilder']): Trigger OpenShift Build

  • apiURL
    • Type: String
  • bldCfg
    If you run `oc get bc` for the project listed in "nameSpace", that is the value you want to put here.
    • Type: String
  • namespace
    • Type: String
  • env
    Specify a list of environment variables to include in the build (see `oc start-build -e ...`).
      Array / List of Nested Object
    • name
      The name of the environment variable to set.
      • Type: String
    • value
      The value for the environment variable.
      • Type: String
  • authToken
    • Type: String
  • verbose
    • Type: String
  • commitID
    The value here is what you supply with the --commit option when invoking the OpenShift `oc start-build` command. It allows you to point the OpenShift build to a specific commit hash from the git-log of the source repository. If you do not supply a value, the plugin assumes the latest version from the source repository should be used.
    • Type: String
  • buildName
    The value here is what you supply with the --from-build option when invoking the OpenShift `oc start-build` command. It allows you to point to OpenShift build to a previously run build, and run another build with exactly the same source and destination metadata. If you do not supply a value, the plugin will generate a new OpenShift build based on the Build Configuration referenced.
    • Type: String
  • showBuildLogs
    Indicates whether the build logs get dumped to the console of the Jenkins build.
    • Type: String
  • checkForTriggeredDeployments
    This flag is the toggle for turning on or off the verification that any deployments triggered by this build's output fired.
    • Type: String
  • waitTime
    • Type: String
  • waitUnit
    • Type: String

step([$class: 'OpenShiftCreator']): Create OpenShift Resource(s)

  • apiURL
    • Type: String
  • namespace
    • Type: String
  • authToken
    • Type: String
  • verbose
    • Type: String
  • jsonyaml
    The JSON or YAML formatted text that conforms to the schema for defining the various OpenShift resources.
    • Type: String

step([$class: 'OpenShiftDeleterJsonYaml']): Delete OpenShift Resource(s) from JSON or YAML

  • apiURL
    • Type: String
  • namespace
    • Type: String
  • authToken
    • Type: String
  • verbose
    • Type: String
  • jsonyaml
    The JSON or YAML formatted text that conforms to the schema for defining the various OpenShift resources.
    • Type: String

step([$class: 'OpenShiftDeleterLabels']): Delete OpenShift Resource(s) using Labels

  • apiURL
    • Type: String
  • namespace
    • Type: String
  • authToken
    • Type: String
  • verbose
    • Type: String
  • types
    The comma separated list of types of API objects to delete, where those objects have labels corresponding to the specified key/value pairs. See https://docs.openshift.org/latest/rest_api/index.html for the supported types.
    • Type: String
  • keys
    The comma separated list of keys of the labels in the API objects to delete.
    • Type: String
  • values
    The comma separated list of values of the labels in the API objects to delete.
    • Type: String

step([$class: 'OpenShiftDeleterList']): Delete OpenShift Resource(s) by Key

  • apiURL
    • Type: String
  • namespace
    • Type: String
  • authToken
    • Type: String
  • verbose
    • Type: String
  • types
    The comma separated list of types of API objects to delete. See https://docs.openshift.org/latest/rest_api/index.html for the supported types.
    • Type: String
  • keys
    The comma separated list of keys of the API objects to delete.
    • Type: String

step([$class: 'OpenShiftDeployer']): Trigger OpenShift Deployment

  • apiURL
    • Type: String
  • depCfg
    If you run `oc get dc` for the project listed in "nameSpace", that is the value you want to put here.
    • Type: String
  • namespace
    • Type: String
  • authToken
    • Type: String
  • verbose
    • Type: String
  • waitTime
    • Type: String
  • waitUnit
    • Type: String

step([$class: 'OpenShiftDeploymentVerifier']): Verify OpenShift Deployment

  • apiURL
    • Type: String
  • depCfg
    If you run `oc get dc` for the project listed in "nameSpace", that is the value you want to put here.
    • Type: String
  • namespace
    • Type: String
  • replicaCount
    This optional field's value represents the number expected running pods for the deployment for the DeploymentConfig specified. If no value is specified it will work the number of running pods against the desired replica count in the DeploymentConfig.
    • Type: String
  • authToken
    • Type: String
  • verbose
    • Type: String
  • verifyReplicaCount
    This flag is the toggle for turning on or off the verification that the specified replica count for the deployment has been reached.
    • Type: String
  • waitTime
    • Type: String
  • waitUnit
    • Type: String

step([$class: 'OpenShiftExec']): OpenShift Exec

  • apiURL
    • Type: String
  • namespace
    • Type: String
  • authToken
    • Type: String
  • verbose
    • Type: String
  • pod
    The pod in which to execute a command.
    • Type: String
  • container
    The container in which to execute a command. If not specified, the first container in the pod will be used.
    • Type: String
  • command
    The name of the command to execute.
    • Type: String
  • arguments
    Specify a list of arguments to pass to the command.
      Array / List of Nested Object
    • value
      The value for the environment variable.
      • Type: String
  • waitTime
    • Type: String
  • waitUnit
    • Type: String

step([$class: 'OpenShiftImageTagger']): Tag OpenShift Image

  • apiURL
    • Type: String
  • testTag
    The name of the existing tag, or an actual, existing image ID. The image referenced will have the new tag applied to it.
    • Type: String
  • prodTag
    One or more tag names in a comma delimited list. If multiple streams and multiple destination tags are specified, the two lists must contain the same number of elements.
    • Type: String
  • namespace
    • Type: String
  • authToken
    • Type: String
  • verbose
    • Type: String
  • testStream
    The name of the ImageStream for the existing tag.
    • Type: String
  • prodStream
    One or more ImageStream names in a comma delimited list. If multiple streams and multiple destination tags are specified, the two lists must contain the same number of elements.
    • Type: String
  • destinationNamespace
    The value here should match the value from the output from `oc project` if you created the resources related to this task from the command line. If nothing is specified, the plugin will inspect the PROJECT_NAME environment variable.
    • Type: String
  • destinationAuthToken
    The value here is what you supply with the --token option when invoking the OpenShift `oc` command. If you do not supply a value, the plugin will assume it is running in the OpenShift Jenkins image and attempt to load the kubernetes service account token stored in that image.
    • Type: String
  • alias
    This flag is the equivalent of the `--alias` option for the `oc tag` command. When false, the destination tag type is "ImageStreamImage", and when true, the destination tag type is "ImageStreamTag".
    • Type: String

step([$class: 'OpenShiftScaler']): Scale OpenShift Deployment

  • apiURL
    • Type: String
  • depCfg
    If you run `oc get dc` for the project listed in "nameSpace", that is the value you want to put here.
    • Type: String
  • namespace
    • Type: String
  • replicaCount
    The value here should be the number of started pods desired for the deployment specified. It is the equivalent of the value supplied to --replicas with an `oc scale` command invocation. This is a required parameter. If an integer is not specified here, this build step can not be added to the job. Note: specifying a 0 is allowed, and means you do not want any pods for the specified deployment config running.
    • Type: String
  • authToken
    • Type: String
  • verbose
    • Type: String
  • verifyReplicaCount
    This flag is the toggle for turning on or off the verification that the specified replica count for the deployment has been reached.
    • Type: String
  • waitTime
    • Type: String
  • waitUnit
    • Type: String

step([$class: 'OpenShiftServiceVerifier']): Verify OpenShift Service

  • apiURL
    • Type: String
  • svcName
    The equivalent to the name supplied to a `oc get service` command line invocation.
    • Type: String
  • namespace
    • Type: String
  • authToken
    • Type: String
  • verbose
    • Type: String

openshiftVerifyBuild: Verify OpenShift Build

  • bldCfg
    If you run `oc get bc` for the project listed in "nameSpace", that is the value you want to put here.
    • Type: String
  • apiURL (optional)
    • Type: String
  • authToken (optional)
    • Type: String
  • checkForTriggeredDeployments (optional)
    This flag is the toggle for turning on or off the verification that any deployments triggered by this build's output fired.
    • Type: String
  • namespace (optional)
    • Type: String
  • verbose (optional)
    • Type: String
  • waitTime (optional)
    • Type: String
  • waitUnit (optional)
    • Type: String

openshiftBuild: Trigger OpenShift Build

  • bldCfg
    If you run `oc get bc` for the project listed in "nameSpace", that is the value you want to put here.
    • Type: String
  • apiURL (optional)
    • Type: String
  • authToken (optional)
    • Type: String
  • buildName (optional)
    The value here is what you supply with the --from-build option when invoking the OpenShift `oc start-build` command. It allows you to point to OpenShift build to a previously run build, and run another build with exactly the same source and destination metadata. If you do not supply a value, the plugin will generate a new OpenShift build based on the Build Configuration referenced.
    • Type: String
  • checkForTriggeredDeployments (optional)
    This flag is the toggle for turning on or off the verification that any deployments triggered by this build's output fired.
    • Type: String
  • commitID (optional)
    The value here is what you supply with the --commit option when invoking the OpenShift `oc start-build` command. It allows you to point the OpenShift build to a specific commit hash from the git-log of the source repository. If you do not supply a value, the plugin assumes the latest version from the source repository should be used.
    • Type: String
  • env (optional)
    Specify a list of environment variables to include in the build (see `oc start-build -e ...`).
      Array / List of Nested Object
    • name
      The name of the environment variable to set.
      • Type: String
    • value
      The value for the environment variable.
      • Type: String
  • namespace (optional)
    • Type: String
  • showBuildLogs (optional)
    Indicates whether the build logs get dumped to the console of the Jenkins build.
    • Type: String
  • verbose (optional)
    • Type: String
  • waitTime (optional)
    • Type: String
  • waitUnit (optional)
    • Type: String

openshiftCreateResource: Create OpenShift Resource(s)

  • jsonyaml
    The JSON or YAML formatted text that conforms to the schema for defining the various OpenShift resources.
    • Type: String
  • apiURL (optional)
    • Type: String
  • authToken (optional)
    • Type: String
  • namespace (optional)
    • Type: String
  • verbose (optional)
    • Type: String

openshiftDeleteResourceByJsonYaml: Delete OpenShift Resource(s) from JSON or YAML

  • jsonyaml
    The JSON or YAML formatted text that conforms to the schema for defining the various OpenShift resources.
    • Type: String
  • apiURL (optional)
    • Type: String
  • authToken (optional)
    • Type: String
  • namespace (optional)
    • Type: String
  • verbose (optional)
    • Type: String

openshiftDeleteResourceByLabels: Delete OpenShift Resource(s) using Labels

  • types
    The comma separated list of types of API objects to delete, where those objects have labels corresponding to the specified key/value pairs. See https://docs.openshift.org/latest/rest_api/index.html for the supported types.
    • Type: String
  • keys
    The comma separated list of keys of the labels in the API objects to delete.
    • Type: String
  • values
    The comma separated list of values of the labels in the API objects to delete.
    • Type: String
  • apiURL (optional)
    • Type: String
  • authToken (optional)
    • Type: String
  • namespace (optional)
    • Type: String
  • verbose (optional)
    • Type: String

openshiftDeleteResourceByKey: Delete OpenShift Resource(s) by Key

  • types
    The comma separated list of types of API objects to delete. See https://docs.openshift.org/latest/rest_api/index.html for the supported types.
    • Type: String
  • keys
    The comma separated list of keys of the API objects to delete.
    • Type: String
  • apiURL (optional)
    • Type: String
  • authToken (optional)
    • Type: String
  • namespace (optional)
    • Type: String
  • verbose (optional)
    • Type: String

openshiftDeploy: Trigger OpenShift Deployment

  • depCfg
    If you run `oc get dc` for the project listed in "nameSpace", that is the value you want to put here.
    • Type: String
  • apiURL (optional)
    • Type: String
  • authToken (optional)
    • Type: String
  • namespace (optional)
    • Type: String
  • verbose (optional)
    • Type: String
  • waitTime (optional)
    • Type: String
  • waitUnit (optional)
    • Type: String

openshiftVerifyDeployment: Verify OpenShift Deployment

  • depCfg
    If you run `oc get dc` for the project listed in "nameSpace", that is the value you want to put here.
    • Type: String
  • apiURL (optional)
    • Type: String
  • authToken (optional)
    • Type: String
  • namespace (optional)
    • Type: String
  • replicaCount (optional)
    This optional field's value represents the number expected running pods for the deployment for the DeploymentConfig specified. If no value is specified it will work the number of running pods against the desired replica count in the DeploymentConfig.
    • Type: String
  • verbose (optional)
    • Type: String
  • verifyReplicaCount (optional)
    This flag is the toggle for turning on or off the verification that the specified replica count for the deployment has been reached.
    • Type: String
  • waitTime (optional)
    • Type: String
  • waitUnit (optional)
    • Type: String

openshiftExec: OpenShift Exec

  • pod
    The pod in which to execute a command.
    • Type: String
  • apiURL (optional)
    • Type: String
  • arguments (optional)
    Specify a list of arguments to pass to the command.
      Array / List of Nested Object
    • value
      The value for the environment variable.
      • Type: String
  • authToken (optional)
    • Type: String
  • command (optional)
    The name of the command to execute.
    • Type: String
  • container (optional)
    The container in which to execute a command. If not specified, the first container in the pod will be used.
    • Type: String
  • namespace (optional)
    • Type: String
  • verbose (optional)
    • Type: String
  • waitTime (optional)
    • Type: String
  • waitUnit (optional)
    • Type: String

openshiftTag: Tag OpenShift Image

  • srcStream
    The name of the ImageStream for the existing tag.
    • Type: String
  • srcTag
    The name of the existing tag, or an actual, existing image ID. The image referenced will have the new tag applied to it.
    • Type: String
  • destStream
    One or more ImageStream names in a comma delimited list. If multiple streams and multiple destination tags are specified, the two lists must contain the same number of elements.
    • Type: String
  • destTag
    One or more tag names in a comma delimited list. If multiple streams and multiple destination tags are specified, the two lists must contain the same number of elements.
    • Type: String
  • alias (optional)
    This flag is the equivalent of the `--alias` option for the `oc tag` command. When false, the destination tag type is "ImageStreamImage", and when true, the destination tag type is "ImageStreamTag".
    • Type: String
  • apiURL (optional)
    • Type: String
  • authToken (optional)
    • Type: String
  • destinationAuthToken (optional)
    The value here is what you supply with the --token option when invoking the OpenShift `oc` command. If you do not supply a value, the plugin will assume it is running in the OpenShift Jenkins image and attempt to load the kubernetes service account token stored in that image.
    • Type: String
  • destinationNamespace (optional)
    The value here should match the value from the output from `oc project` if you created the resources related to this task from the command line. If nothing is specified, the plugin will inspect the PROJECT_NAME environment variable.
    • Type: String
  • namespace (optional)
    • Type: String
  • verbose (optional)
    • Type: String

openshiftScale: Scale OpenShift Deployment

  • depCfg
    If you run `oc get dc` for the project listed in "nameSpace", that is the value you want to put here.
    • Type: String
  • replicaCount
    The value here should be the number of started pods desired for the deployment specified. It is the equivalent of the value supplied to --replicas with an `oc scale` command invocation. This is a required parameter. If an integer is not specified here, this build step can not be added to the job. Note: specifying a 0 is allowed, and means you do not want any pods for the specified deployment config running.
    • Type: String
  • apiURL (optional)
    • Type: String
  • authToken (optional)
    • Type: String
  • namespace (optional)
    • Type: String
  • verbose (optional)
    • Type: String
  • verifyReplicaCount (optional)
    This flag is the toggle for turning on or off the verification that the specified replica count for the deployment has been reached.
    • Type: String
  • waitTime (optional)
    • Type: String
  • waitUnit (optional)
    • Type: String

openshiftVerifyService: Verify OpenShift Service

  • svcName
    The equivalent to the name supplied to a `oc get service` command line invocation.
    • Type: String
  • apiURL (optional)
    • Type: String
  • authToken (optional)
    • Type: String
  • namespace (optional)
    • Type: String
  • retryCount (optional)
    • Type: String
  • verbose (optional)
    • Type: String

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.