Built by Maven

Creating an Integration Node (from scratch)

This guide gives an example of how to create an integration node on a target. It does not explain all of the permutations for integration nodes, these can be gleaned from a combination of fully understanding this example and using the task reference and template help within the product. By the end of this guide you will have created an integration node called NODE1 (representing a Development instance of an instegration node). Further guides may build on this example.

The following steps need to be completed

  1. Create a codeDeploy project (pre-requisite).
  2. Create a Target for this project.
    • Specify the logical names for the RapidDeploy objects.
    • Configure the Server object to connect to your target.
  3. Create a Deployment Package.
  4. Execute a deployment.

Create a Target for NODE1

  • Assuming that you have created an Integration Node codeDeploy project, navigate to the "Targets" tab.
  • Click on "New Target".
  • Enter appropriate values for your Server, Installation and Configuration. The key values are the Server and the Installation, it is recommended that this reflects your integration node name, the remainder field is logical and could be used to assist with your sorting of different environment configurations.
  • Click on the "Next" button and fill in the necessary data dictionary items for all of the specific configuration that the integration node requires.
  • Click on the "Next" button and click on "Create" to save the new target.

Configure the Server object

The new target creates a number of RapidDeploy objects, chief of which is the target server which needs configuring to successfully connect.

  • Configure the Server to use one of the supplied transports (e.g. SSH or Remoting agent). Once done, ensure that the connection is successful by testing and also ensure you are using a user with the appropriate privileges.
  • In addition to the Server object, you will also have created an Installation which can also be configured. To do so:
    • Navigate to Infrastructure, select the recently created Server, go to the Installations tab, and select the just created Installation, for instance, NODE1.
    • Set the Owner field to "mvadmin" and fill in any other configuration required (e.g. the "Snapshots Path").
    • And save the Installation.

Create a Deployment Package

  • Within the Project configuration panel, navigate to the Packages tab.
  • Click on the "Create Package" button to create an auto incremental version named package.
  • Alternatively, use the "Add Package Wizard" button to create a Deployment Package for this project. Note the name must contain the Search String set in the Artifact Repository tab.

Perform a Deployment

  • Navigate to Jobs > New Job Plan.
  • Double click on the "(empty)" blue box.
  • Select the Project, the Target and the Deployment Package created previously, and click on "Apply".
  • Click on the "Run" button, and after the job has finished the integration node will be created on the specified target.