Due to some maintenance issues, this service has been switched in read-only mode, you can find more information about the why

and how to migrate your plugin documentation in this blogpost

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 9 Next »

Plugin Information

No information for the plugin 'skytap-cloud-plugin' is available. It may have been removed from distribution.

A plugin that allows you to use Jenkins to run continuous integration and automated testing workflows using dynamically created complex testing environments in Skytap Cloud
This plugin allows you to use Jenkins to run continuous integration and automated testing workflows using dynamically created complex testing environments in Skytap Cloud

Introduction

Skytap Cloud is a self-service cloud that makes it easy for you to create development and test environments on demand within minutes. The environments can be as simple as a client application running on a single VM to a multi-component distributed application running on multiple VMs across multiple networks. Skytap makes it easy for you to set up these environments and save them off as golden templates. These templates in turn can be used to create clones, as many as needed, to run your test passes, be it for unit testing, functional testing, integration testing, stress/performance testing or user acceptance testing.

The Skytap Cloud CI Plugin for Jenkins provides a set of pre-packed Skytap Cloud actions for use in configuring a Jenkins based continuous integration workflow. These pre-packaged Skytap Cloud actions provide the user with actions that are commonly needed in provisioning environment resources during a CI run. 

Specifically, the Skytap Cloud Actions provided in the plugin are as follows:

  • Add Configuration to Project
  • Change Configuration State
  • Connect to Network in another Configuration (ICNR)
  • Connect to VPN Tunnel
  • Create Configuration from Template
  • Create Publish URL
  • Create Template from Configuration
  • Delete Configuration

Each of these Skytap Actions is described in detail in this document.

Installation of the Skytap Cloud CI Plugin for Jenkins

From the Jenkins Web UI

You can install the Skytap Cloud CI Plugin for Jenkins directly from the Jenkins Web UI by navigating to the Jenkins “Manage Plugins” page.


 
Once there, you can select the “Available” tab and filter for “Skytap”

When you see the “Skytap Cloud CI Plugin for Jenkins” select the “Install” checkbox and click the “Download now and install after restart” button.

When Jenkins restarts, you will have access to Skytap Cloud Actions in the Jenkins Project Configuration screen “Add Build Step” dropdown menu.

From the Skytap Cloud CI Plugin for Jenkins file downloaded from Skytap

Your can download the Skytap Cloud CI Plugin for Jenkins from the Skytap website.  Once it is downloaded you can install it by navigating to the Jenkins “Manage Plugins” page as described earlier and then, on that page, select the “Advanced” tab:


 
Find the “Upload Plugin” section and click the “Choose File” button.  Then navigate to where the downloaded Skytap Cloud CI Plugin for Jenkins file is located and select it.  Once that is done, click the “Upload” button.

After the plugin is uploaded, restart Jenkins by entering the following URL in your browsers URL Address: http://_your-jenkins-server_/jenkins/restart and click the “Yes” button:

When Jenkins restarts, you will have access to Skytap Actions in the Jenkins Project Configuration screen “Add Build Step” dropdown menu.

Configuring the Plugin

Skytap Cloud Authentication

To use the Skytap Cloud CI plugin for Jenkins you must first be able to authenticate with Skytap Cloud.  This authentication requires a Skytap Cloud user ID and an API Token.  This is needed so that the plugin can make API calls on your behalf to manage resources in your account on Skytap Cloud. Assuming you already have a Skytap Cloud account, you can retrieve your API Token in your Skytap Account Settings:

If you don’t have a Skytap Cloud account, you can sign up for one here: http://www.skytap.com/

 Once you have your security token, you will need to enter it along with your Skytap User ID in the Skytap Cloud Plugin configuration panel in the Mange Jenkins->Configure Systems page. 


Skytap Action Logging

In addition to authentication information, the Skytap Cloud CI Plugin configuration panel also allows you to enable logging of Skytap actions.  If the checkbox is checked, verbose output on the operation of Skytap actions will be sent to the Jenkins Project build console.

Supported Actions for Skytap Cloud

The Skytap Cloud Actions that are available for use in Jenkins project builds are exposed in the Jenkins Project Configuration screen in the “Add Build Step” dropdown menu as an “Execute Skytap Action” menu pick:

Once you select “Execute Skytap Action” you will be presented with a “Skytap Action” dropdown menu listing the available actions:


 
Depending on which action you select you will be presented with a set of input and output parameters to specify in order to enable execution of the Skytap Action.  The specific input and output parameters that are required differ depending on which Skytap Action you select.  These parameters are described below in the discussion of individual Skytap Actions.

Add Configuration to Project

This Skytap Action allows the user to specify a Skytap Configuration to add to a Skytap Project.


 

Parameters

Configuration ID --or- Configuration File

The user can specify a specific Skytap Configuration ID (an integer), if one is known.  If the configuration was created using the “Create Configuration from Template” Skytap Action, the user can specify the Skytap configuration by specifying the “Configuration Data Save File” that is an output of the “Create Configuration from Template” Skytap Action.

Project ID --or- Project Name

The user can specify a specific Skytap Project ID (an integer) or a Skytap Project Name.  Whichever method is used, the project must already exist and be accessible by the users Skytap account.

Change Configuration State

When this Skytap Action is selected, the user must then select the desired state to which they wish to transition the configuration.  Choices are “Run Configuration”, “Suspend Configuration”, and Shutdown Configuration”.

Once a state change action is specified the user can fill out the remaining parameters.

Parameters

Power off VM if shutdown fails

The “Power off VM if shutdown fails” checkbox serves as a failsafe if a VM fails to shutdown.  If this checkbox is checked, and the specified Skytap Configuration fails to shutdown after a period of 5 minutes, the specified Skytap Configuration will be forcefully shutdown or “powered off”.  This is equivalent to clicking the “Power off this machine” button in the Skytap Web GUI.

Configuration ID --or- Configuration File

The user can specify a specific Skytap Configuration ID (an integer), if one is known.  If the configuration was created using the “Create Configuration from Template” Skytap Action, the user can specify the Skytap configuration by specifying the “Configuration Data Save File” that is an output of the “Create Configuration from Template” Skytap Action.

Connect to Network in another Configuration (ICNR)

When this Skytap Action is selected, the specified networks in the two specified configurations will be connected using the Internal Configuration Network Routing (ICNR) protocol.  This feature is useful during testing, where one or more test environments need to access a central resource, like a database or Active Directory server. The network subnets in the two configurations must already be configured to allow an ICNR connection to occur. You can read more about ICNR in Skytap Help Docshttps://cloud.skytap.com/docs/index.php/Networking_Between_Configurations.


Parameters

Source Configuration ID --or- Source Configuration Data File

The user can specify a specific Skytap Configuration ID (an integer), if one is known.  If the configuration was created using the “Create Configuration from Template” Skytap Action, the user can specify the Skytap configuration by specifying the “Configuration Data Save File” that is an output of the “Create Configuration from Template” Skytap Action.

Source Network Name

This required parameter specifies the name of the network in the Source Configuration to use in the ICNR connection attempt. If there is more than one network in the configuration with the specified name (not recommended), the first network encountered in the meta data associated with the configuration will be used.


Target Configuration ID --or- Target Configuration Data File

The user can specify a specific Skytap Configuration ID (an integer), if one is known.  If the configuration was created using the “Create Configuration from Template” Skytap Action, the user can specify the Skytap configuration by specifying the “Configuration Data Save File” that is an output of the “Create Configuration from Template” Skytap Action.

Target Network Name

This required parameter specifies the name of the network in the Source Configuration to use in the ICNR connection attempt.  The network in the Target Network Name must be configured to be visible to other networks.

Connect to VPN Tunnel

When this Skytap Action is selected, the specified Skytap VPN definition will be connected to the specified network in the specified Skytap Configuration.

Parameters

Configuration ID --or- Configuration File

The user can specify a specific Skytap Configuration ID (an integer), if one is known.  If the configuration was created using the “Create Configuration from Template” Skytap Action, the user can specify the Skytap configuration by specifying the “Configuration Data Save File” that is an output of the “Create Configuration from Template” Skytap Action.

Configuration Network Name

This required parameter specifies the name of the network in the skytap Configuration to use in the VPN connection attempt.

VPN ID

This parameter is the Integer ID of the Skytap VPN definition to which to connect the specified network in the configuration.

Create Configuration from Template

This Skytap Action allows the user to specify a Skytap Template from which to create a Skytap Configuration.

Parameters

Template ID --or- Template File

The user can specify a specific Skytap Template ID (an integer), if one is known.  If the template was created using the “Create Template from Configuration” Skytap Action, the user can specify the Skytap template by specifying the “Template Data Save File” that is an output of the “Create Template from Configuration” Skytap Action.

Configuration Data Save File

This output file contains the Skytap Configuration metadata in json format.  This metadata contains the Skytap Configuration ID as well as the other metadata that defines the Skytap Configuration.  This file can then be used as input to Skytap Actions that require a Skytap Configuration ID or other Skytap Configuration metadata.

Create Publish URL

When this Skytap Action is selected, a Skytap Published URL will be created and associated with the specified Configuration.


Parameters

Configuration ID --or- Configuration File

The user can specify a specific Skytap Configuration ID (an integer), if one is known.  If the configuration was created using the “Create Configuration from Template” Skytap Action, the user can specify the Skytap configuration by specifying the “Configuration Data Save File” that is an output of the “Create Configuration from Template” Skytap Action.

URL Save Filename

When the Publish URL is created, the text of the URL will be written into the file specified in the Filename specified in this parameter.

Select Permissions

This dropdown list specifies the permissions associated with the Published URL that will be created.  The meaning of these permissions can be reviewed in the Skytap Help materials at this URL: Skytap Published URL Help

Require Password for Access

If this checkbox is checked, the user can specify a password that will be required before anyone using the created Published URL will be allowed to access the associated Skytap .

Create Template from Configuration

This Skytap Action allows the user to specify a Skytap Configuration from which to create a Skytap Template.

Parameters

Configuration ID --or- Configuration File

The user can specify a specific Skytap Configuration ID (an integer), if one is known.  If the configuration was created using the “Create Configuration from Template” Skytap Action, the user can specify the Skytap configuration by specifying the “Configuration Data Save File” that is an output of the “Create Configuration from Template” Skytap Action.

Template Name

This parameter allows the user to specify a name for the created template.

Template Description

This parameter allows the user to specify a description for the created template.

Template Data Save Filename

This output file contains the Skytap Template metadata in json format.  This metadata contains the Skytap Template ID as well as the other metadata that defines the Skytap Configuration.  This file can then be used as input to Skytap Actions that require a Skytap Template ID or other Skytap Template metadata.

Delete Configuration

This Skytap Action allows a user to delete the specified Skytap Configuration.

Parameters

Configuration ID --or- Configuration File

The user can specify a specific Skytap Configuration ID (an integer), if one is known.  If the configuration was created using the “Create Configuration from Template” Skytap Action, the user can specify the Skytap configuration by specifying the “Configuration Data Save File” that is an output of the “Create Configuration from Template” Skytap Action.

  • No labels