In this section:

Introduction

The Parasoft Environment Manager plugin for Jenkins lets you rapidly configure various actions needed for automated, continuous testing across your software delivery pipeline. You can configure build steps for:

• Provisioning environments into the specific states needed for automated testing
• Replicating environments and associated assets to different Virtualize servers, including servers dynamically-provisioned from Docker or other container technologies
• Executing Parasoft test scenario jobs (tests suites that execute vs. specific environment configurations)
• Destroying "dirtied" test environments to ensure that subsequent tests always begin with a clean slate
• Disconnecting a Virtualize server from Environment Manager to remove unnecessary connections

Requirements

• Environment Manager 2.7.4 or higher
• Virtualize 9.9.4 or higher
• Jenkins 1.625.3 or higher
• JUnit Plugin v.1.10

Configuration

Each Jenkins server communicates with one Environment Manager. Multiple Jenkins servers can communicate with the same Environment Manager.

1. Choose Manage Jenkins> Configure System.
2. In the Parasoft Environment Manager area, enter your Environment Manager URL, username, and password. You can click Test Connection to ensure that Jenkins is successfully communicating with Environment Manager.
   
   

Adding an Environment Manager Build Step to a Jenkins Job

You can add any number of Environment Manager build steps to a Jenkins job.

1. Open the job you want to configure and choose Configure.
2. In the Build area, click Add build step and select one of the available Parasoft Environment Manager build steps:

Configuring a Deploy an Environment Build Step

This build step provisions environments into the specific states needed for testing. As an additional option, it can also replicate environments and associated assets to different Virtualize servers (including servers dynamically-provisioned from Docker or other container technologies). When you add a "Deploy an environment" build step, several new fields are available.

To configure this build step:

1. Choose a system, environment, and instance you want to provision (and optionally replicate to a new Virtualize server) from the respective drop-down menus. 
2. If you want to replicate the environment and associated assets (virtual assets, proxies, JDBC controllers, etc.) to a new Virtualize server before provisioning:
   1. Enable the Copy the environment and assets before provisioning option.
   2. (Optional) Specify a name for the new environment. If this field is empty, a name will be assigned automatically. You can also use variables, e.g., Env${BUILD_NUMBER}
   3. Specify the target Virtualize server. See the guidelines below this procedure for help selecting and configuring one of the available options.
3. If you are copying an environment and you also want to duplicate the associated data repositories before provisioning:
   1. Enable the Duplicate associated data repositories before provisioning option.

   2. Specify where you want the data repositories to be copied. You can configure the following options:
      
      

      On the current Data Repository server	Creates a new copy on the same Data Repository server where the repositories currently exist. If you select this option, specify the Data Repository port, username, and password.
      To a Data Repository server on the same host as the target Virtualize sever	Creates a new copy on the target Virtualize server specified in the area above the Duplicate associated data repositories before provisioning check box. If you select this option, specify the Data Repository port, username, and password.
      To a Data Repository server on a specific host	Creates a new copy on the specified Data Repository. If you select this option, specify the Data Repository host, port, username, and password.

      
      

      
      

4. If you want the job to stop if the provisioning fails, enable the Abort on provisioning failure option.

Choosing Between the Various Environment Copying Options

This plugin provides three different environment copying options to suit various needs. The first option requires the Virtualize server to be registered with Environment Manager when the job executes. The second and third will wait for the Virtualize server to be registered, and is thus the preferred option when you're dynamically deploying Virtualize servers via Docker or other container technologies.

When Virtualize Server has a Dynamic IP

As long as the Virtualize server has a consistent name, you can configure the build step to copy to the Virtualize server with the specified name (e.g., the name it uses to register with Environment Manager). If the named Virtualize server is not yet registered with Environment Manager, the build step will wait for it, then perform the copy operation once that server is registered.

Configuring an Execute a Test Scenario Job Build Step

This build step executes one of the test scenario jobs (tests suites that execute vs. specific environment configurations) available on the connected instance of Environment Manager. When you add an "Execute a test scenario job" build step, a new field will display.

Choose the test scenario job you want to execute from the drop-down menu. The menu shows all test scenario jobs currently on the connected instance of Environment Manager.

Configuring a Destroy an Environment Build Step

This build step deletes "dirtied" test environments to ensure that subsequent tests always begin with a "clean" test environment. When you add a "Destroy an environment" build step, two new fields will display.

To configure this build step:

1. Choose the system from the System drop-down menu that includes the environment you want to destroy.
2. Enter the name of the environment you want to destroy. You can enter the name of an environment that does not exist yet (e.g., an environment that will be spun up dynamically). You can also use variables, e.g., Env${BUILD_NUMBER}

Configuring a Disconnect a Virtualize Server Build Step

This build step de-registers a specified Virtualize server from Environment Manager. When you add a "Disconnect a Virtualize server" build step, two new fields will display.

Enable one of the options and specify the host IP or server name in the field provided to disconnect a Virtualize server.

Reviewing a Build Step's Progress and Results

To view the console output for an in-progress job, click the progress bar in the Build History area. This opens a page with status details and links to the associated Environment Manager host and environments. To see details on a completed job, use the Console Output pull-down in the Build History area.

Change Log