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.

IBM Cloud DevOps

evaluateGate: IBM Cloud DevOps Gate

  • policy
    • Type: String
  • applicationName (optional)
    • Type: String
  • buildNumber (optional)
    • Type: String
  • credentialsId (optional)
    • Type: String
  • environment (optional)
    • Type: String
  • forceDecision (optional)
    • Type: String
  • orgName (optional)
    • Type: String
  • toolchainId (optional)
    • Type: String

notifyOTC: Send notification to OTC

  • stageName
    • Type: String
  • status
    • Type: String
  • webhookUrl (optional)
    • Type: String

publishBuildRecord: Publish build record to IBM Cloud DevOps

  • result
    • Type: String
  • gitRepo
    • Type: String
  • gitBranch
    • Type: String
  • gitCommit
    • Type: String
  • applicationName (optional)
    • Type: String
  • buildNumber (optional)
    • Type: String
  • credentialsId (optional)
    • Type: String
  • orgName (optional)
    • Type: String
  • toolchainId (optional)
    • Type: String

publishDeployRecord: Publish deploy record to IBM Cloud DevOps

  • result
    • Type: String
  • environment
    • Type: String
  • appUrl (optional)
    • Type: String
  • applicationName (optional)
    • Type: String
  • buildNumber (optional)
    • Type: String
  • credentialsId (optional)
    • Type: String
  • orgName (optional)
    • Type: String
  • toolchainId (optional)
    • Type: String

publishSQResults: Publish SonarQube test results to IBM Cloud DevOps

  • SQHostURL (optional)
    • Type: String
  • SQAuthToken (optional)
    • Type: String
  • SQProjectKey (optional)
    • Type: String
  • applicationName (optional)
    • Type: String
  • buildNumber (optional)
    • Type: String
  • credentialsId (optional)
    • Type: String
  • environment (optional)
    • Type: String
  • orgName (optional)
    • Type: String
  • toolchainId (optional)
    • Type: String

publishTestResult: Publish test result to IBM Cloud DevOps

  • type
    • Type: String
  • fileLocation
    • Type: String
  • applicationName (optional)
    • Type: String
  • buildNumber (optional)
    • Type: String
  • credentialsId (optional)
    • Type: String
  • environment (optional)
    • Type: String
  • orgName (optional)
    • Type: String
  • toolchainId (optional)
    • Type: String

sendDeployableMessage: Send deployable mapping message to OTC

  • status
    • Type: String
  • webhookUrl (optional)
    • Type: String

step([$class: 'EvaluateGate']): IBM Cloud DevOps Gate

  • policyName
    Select the policy that you want this gate to enforce. You can create more policies in DevOps Insights.
    • Type: String
  • toolchainName
    Select a toolchain. If you have not created a toolchain yet, create one here.
    • Type: String
  • buildJobName
    Enter the name of the build job that triggers this test job. You can use an environment variable, such as $BUILD_JOB.
    • Type: String
  • credentialsId
    Select an API Key from the menu. If no API Key are in the menu, click Add to add one. Click Test Connection to verify the selected credentials. The use of Username/Password will be deprecated soon
    • Type: String
  • willDisrupt
    Select this check box to cancel associated Jenkins builds when this gate fails.
    • Type: boolean
  • scope
      Nested Object
    • value
      • Type: String
    • branchName
      • Type: String
    • envName
      • Type: String
  • additionalBuildInfo
    Select this check box if the deployed app is not built in Jenkins.
      Nested Object
    • buildNumber
      • Type: String
    • buildUrl
      • Type: String
  • applicationName (optional)
    Type a name for the application that information is being uploaded for. Use this application name when you configure DevOps Insights gates. You can use an environment variable, such as $APP_NAME.
    • Type: String

step([$class: 'PublishBuild']): Publish build information to IBM Cloud DevOps

  • additionalBuildInfo
    Select this check box if you want to set your own build number.
      Nested Object
    • buildNumber
      • Type: String
    • buildUrl
      • Type: String
  • applicationName (optional)
    Type a name for the application that information is being uploaded for. Use this application name when you configure DevOps Insights gates. You can use an environment variable, such as $APP_NAME.
    • Type: String
  • credentialsId (optional)
    Select an API Key from the menu. If no API Key are in the menu, click Add to add one. Click Test Connection to verify the selected credentials. The use of Username/Password will be deprecated soon
    • Type: String
  • toolchainName (optional)
    Type the ID of your toolchain. If you have not created a toolchain yet, create one here.
    • Type: String
  • orgName (optional)
    • Type: String

step([$class: 'PublishDeploy']): Publish deployment information to IBM Cloud DevOps

  • toolchainName
    Type the ID of your toolchain. If you have not created a toolchain yet, create one here.
    • Type: String
  • buildJobName
    Enter the name of the build job that triggers this test job. You can use an environment variable, such as $BUILD_JOB.
    • Type: String
  • environmentName
    Type the name of the environment that this job deploys to. If this environment is your staging environment, type "STAGING." If this environment is your production requirement, type "PRODUCTION." If you do not specify staging and production environments, DevOps Insights cannot completely analyze your project.
    • Type: String
  • credentialsId
    Select an API Key from the menu. If no API Key are in the menu, click Add to add one. Click Test Connection to verify the selected credentials. The use of Username/Password will be deprecated soon
    • Type: String
  • applicationUrl
    Optional: If this is a web application, enter its URL. You can use an environment variable, such as $APP_URL.
    • Type: String
  • additionalBuildInfo
    Select this check box if you want to set your own build number
      Nested Object
    • buildNumber
      • Type: String
  • applicationName (optional)
    Type a name for the application that information is being uploaded for. Use this application name when you configure DevOps Insights gates. You can use an environment variable, such as $APP_NAME.
    • Type: String

step([$class: 'PublishSQ']): Publish SonarQube test result to IBM Cloud DevOps

  • credentialsId
    Select an API Key from the menu. If no API Key are in the menu, click Add to add one. Click Test Connection to verify the selected credentials. The use of Username/Password will be deprecated soon
    • Type: String
  • toolchainName
    Select a toolchain. If you have not created a toolchain yet, create one here.
    • Type: String
  • buildJobName
    Enter the name of the build job that triggers this test job. You can use an environment variable, such as $BUILD_JOB.
    • Type: String
  • SQHostName
    Type the hostname of the server that your SonarQube instance runs on. Do not enter a trailing slash.
    • Type: String
  • SQAuthToken
    Enter your API token that SonarQube generated for you.
    • Type: String
  • SQProjectKey
    Type the key of the SonarQube project that you wish to scan.
    • Type: String
  • additionalBuildInfo
    Select this check box if you want to set your own build number
      Nested Object
    • buildNumber
      • Type: String
  • applicationName (optional)
    Type a name for the application that information is being uploaded for. Use this application name when you configure DevOps Insights gates. You can use an environment variable, such as $APP_NAME.
    • Type: String

step([$class: 'PublishTest']): Publish test result to IBM Cloud DevOps

  • lifecycleStage
    Select the type of test. Your tests must correspond to rules in policies.
      Supported formats:
    • Code coverage: Istanbul, BlanketJS
    • Unit and functional verification tests: Mocha, xUnit, and Karma Mocha
    • Type: String
  • contents
    Enter the test result file location relative to the root directory. The result file must contain results in the format that you selected for the metric type. This field supports wildcards and environment variables. If you leave this field empty, DevOps Insights generates a simple test report that is based on job status. Mocha, KarmaMocha, Istanbul, and BlanketJS test results must be in the JSON format. xUnit test results must be in the XML format.
    • Type: String
  • toolchainName
    Select a toolchain. If you have not created a toolchain yet, create one here.
    • Type: String
  • buildJobName
    Enter the name of the build job that triggers this test job. You can use an environment variable, such as $BUILD_JOB.
    • Type: String
  • credentialsId
    Select an API Key from the menu. If no API Key are in the menu, click Add to add one. Click Test Connection to verify the selected credentials. The use of Username/Password will be deprecated soon
    • Type: String
  • additionalUpload
    Optional: You can upload another test result file and select another metric type in this job.
      Nested Object
    • additionalLifecycleStage
      • Type: String
    • additionalContents
      • Type: String
  • additionalBuildInfo
    Select this check box if you want to set your own build number
      Nested Object
    • buildNumber
      • Type: String
  • additionalGate
      Nested Object
    • policyName
      • Type: String
    • willDisrupt (optional)
      • Type: boolean
  • testEnv
      Nested Object
    • value
      • Type: String
    • branchName
      • Type: String
    • envName
      • Type: String
  • applicationName (optional)
    Type a name for the application that information is being uploaded for. Use this application name when you configure DevOps Insights gates. You can use an environment variable, such as $APP_NAME.
    • 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.