DeployHub Integrations

Integrating DevOps tools with DeployHub for CI/CD, messaging and infrastructure.

Intro to Integrations

DeployHub has an open architecture with many out of the box integrations with other DevOps tools. You can incorporate the use of tools such as Ansible or Helm, add Slack or deploy to WebSphere or Salesforce with our built-in Actions or by creating Custom Actions using any scripting languages. In addition, you can use DMScript which has pre-built access to the DeployHub Objects. RESTfull APIs are also available to interact with the DeployHub Objects for integration into external systems, or execute on a continuous delivery trigger.

Types of Integrations

Integrations can be created using:

  • Notifiers for calling, Email, Slack or Hipchat.
  • Actions and Custom Actions for deploying and managing Infrastructure Components like Tomcat or WebSphere or performing deployments with Helm, Ansible or Cloud Foundry.
  • Data Sources for connecting to outside data such as Change Request systems like Jira, Git or Bugzilla.
  • APIs for creating continuous delivery plug-ins for continuous configuration management.

Built-In Actions

The integration work may already be done with our Built-in Actions. Some Built-in Actions are Functions or Procedures that can delete files in a DropZone, or run a PostGres script. Other Built-in Actions integrate with specific DevOps tools such as Ansible, Helm, Slack or GitHub.

Built-In Database Actions

Name Description
Run SQL Script (Postgres) Runs one or more SQL scripts against a Postgres Database.

Built-In Deploy Actions

Name Description
Checkout Extracts items from the specified Repository and places them in the Dropzone.
Deploy Extracts items from the specified Repository and deploys then to the Endpoints within the targeted Environment. Use IF conditions to filter the Endpoint list to those matching the specified criteria.
Deploy Component Deploys the specified Component to the appropriate Endpoints within the targeted Environment.
Execute Runs a script on the appropriate Endpoints within the targeted Environment. Use IF conditions to filter the Endpoint list to those matching the specified criteria.
Transfer Deploys the Component on the stack to the Endpoint on the stack.

Built-In Dropzone Actions

Name Description
Add File to ZIP Puts a Dropzone file into a ZIP/WAR/JAR/EAR file.
Amend File Content Modifies a flat file in the Dropzone. Set ““Server Specific”” to make a copy specific for each Endpoint.
Delete File Removes a file from the Dropzone.
Extract File from ZIP Extracts a named file from a ZIP/WAR/JAR/EAR file.
Iterate through Dropzone Loops through each file in the Dropzone.
Remove File from ZIP Deletes a file from a ZIP/WAR/JAR/EAR archive.
Rename File Renames a file in the Dropzone. Set ““Server Specific”” to make a copy specific to the current Endpoint.
Using Dropzone Use a named Dropzone.
XML - Add Element Adds a New XML element.
XML - Remove Element Removes an XML element.
XML - Set Attribute Sets an attribute name in an XML element.
XML - Set Text Sets the text in an XML element.

Built-In Flow Logic Actions

Name Description
Calculate MD5 Calculates the MD5 of a file.
Get Directory Returns the contents of a directory into an array.
Abort Terminates a deployment with error condition.
Add Two Values Add two values and stores the result in a variable.
Add Value to Variable Add a value to a variable.
Echo Echoes a message.
If General Condition Expression evaluation. Also use this to filter the list of servers based on those matching the specified criteria.
Increment Variable Increments a variable.
Parallel Execute blocks in parallel.
Run Task Execute a Specific Task.
Set Variable Creates and sets a variable.
Sleep Pauses for n seconds.
Using Stream Use a named stream.
Wait for Task Wait for a Specific DeployHub Task to be Run.

Built-In Loop Actions

Name Description
Component Loop Loops through each Component that makes up the Application.
Loop Through Array Keys Loops through each element of an array, setting a variable to each key.
Server Loop Iterates through the current set of Endpoints.
Version Loop Loops through each version between version on target Endpoint and version being deployed.

Built-In Tomcat Actions

Name Description
TomcatPostDeploy Cleans work directory and starts Tomcat.
TomcatPreDeploy Shuts down Tomcat before deployment.

Built-In WebSphere Actions

Name Description
Deploy App Deploys an Application to Websphere.

Built-In Windows Actions

Name Description
Extract Zip Extracts the contents of a zip file.
List Services Returns a list of installed services into an array.
Start Service Starts a Windows Service on the appropriate Endpoints within the targeted Environment. Use IF conditions to filter the Endpoint list to those matching the specified criteria.
Stop Service Stops a Windows Service on the appropriate Endpoints within the targeted Environment. Use IF conditions to filter the Endpoint list to those matching the specified criteria.

Built-in Actions that Support DevOps Interoperability

Action Description
Ansible Uses Ansible to perform Deployments.
Cloud Foundry Uses Cloud Foundry to perform Deployments.
Helm Uses Helm to deploy Containers.
SalesForce Deploys Applications to SalesForce.
Tomcat Deploys to a Tomcat environment.
WebLogic Deploys to a WebLogic Environment.
WebSphere Deploys to a WebSphere Environment.
Last modified June 30, 2020: tomcat, weblogic (b3ce556)